foxreach-cli 0.2.0__tar.gz → 0.5.0__tar.gz

foxreach_cli-0.5.0/CHANGELOG.md

@@ -0,0 +1,76 @@
+# Changelog
+
+## [0.5.0] - 2026-11-03
+
+### Added
+
+- `leads create --custom KEY=VALUE` (repeatable) sets custom fields on a new lead.
+- `leads update --custom KEY=VALUE` and `--unset-custom KEY` change or remove individual custom fields; the lead's other custom fields are kept.
+- `leads import --mapping` accepts `"custom:<name>"` as a target: `{"z123": "custom:p234"}` saves the `z123` column as the custom field `p234`. Columns not in the mapping are still left out.
+- `leads list --provider VALUE`: filter leads by recipient mail provider (google, microsoft, zoho, yahoo, godaddy, other, gateway, unresolved).
+- `leads providers`: show how your leads split across mail providers, how many sit behind a security gateway, and how much has been checked.
+- `campaigns esp-mix CAMPAIGN_ID`: show how a campaign's mailboxes and leads split across mail providers.
+
+### Fixed
+
+- Table output of `inbox stats`, `inbox conversation`, `leads activity`, `verification` credits and `tracking-domains` read camelCase keys the SDK no longer returns, so counts showed 0 and sender or campaign showed blank. They now read the SDK's snake_case keys.
+
+## [0.4.2] - 2026-10-21
+
+Requires `foxreach>=0.4.2`.
+
+### Added
+
+- `leads list --email ADDRESS`: exact, case-insensitive email match.
+- `inbox get --mark-read`: mark the thread read while fetching it.
+- `sequences create --name`.
+- `templates create --category` and `templates update --category` (for example `email` or `reply_macro`).
+
+### Changed
+
+- `inbox get` no longer marks the thread read. The API stopped marking threads read on read; pass `--mark-read` (or use `inbox update ID --read`) to mark it.
+- `sequences create --subject` is now required, matching the API.
+- `sequences create --step` is removed. The API assigns the step number and ignored the value.
+- `sequences list` shows a Name column instead of Type (sequences have no type); `templates list` and `templates get` show the template's category.
+
+### Fixed
+
+- `foxreach_cli/__init__.py` said 0.4.0 while `pyproject.toml` said 0.4.1. Both now say 0.4.2, and `tests/test_request_shapes.py::test_version_sources_agree` asserts it.
+
+## [0.4.1] - 2026-10-21
+
+### Added
+
+- `campaigns list-leads <id>` — paginated leads enrolled in a campaign (`GET /campaigns/{id}/leads`)
+- `campaigns list-accounts <id>` — email accounts assigned to a campaign (`GET /campaigns/{id}/accounts`)
+- `accounts google-oauth-start` — start Google Workspace OAuth flow; returns a redirect URL (`POST /email-accounts/google-oauth/start`)
+- `lead-finder filter-options` — available filter keys, industries, and countries (`GET /lead-finder/filter-options`)
+- `lead-finder count` — count people matching filters without using a search page (`POST /lead-finder/count`)
+- `lead-finder companies-count` — count companies matching filters (`POST /lead-finder/companies/count`)
+- `lead-finder companies-search` — search companies by filters (`POST /lead-finder/companies/search`)
+- `lead-finder add-to-leads` — move revealed contacts into leads workspace (`POST /lead-finder/add-to-leads`)
+- `lead-finder reveals-get <batch_id>` — get a single reveal batch (`GET /lead-finder/reveals/{batch_id}`)
+- `leads import` — bulk import leads from a CSV file with column mapping (`POST /leads/import`)
+- `managed-inboxes domains-search <query>` — search available domains by keyword (`GET /managed-inboxes/domains/search`)
+- `managed-inboxes domains-suggest <domain>` — get domain name suggestions (`GET /managed-inboxes/domains/suggest`)
+- `managed-inboxes quote` — get a price quote for a managed inbox order (`POST /managed-inboxes/orders/quote`)
+- `managed-inboxes get-order <order_id>` — get a managed inbox order by ID (`GET /managed-inboxes/orders/{id}`)
+
+### Changed
+
+- CLI test mocks are now spec'd with `create_autospec` on resource classes so a renamed SDK method call fails the test with `AttributeError` instead of silently passing.
+
+## [0.4.0] - 2026-10-21
+
+### Added
+- New command groups: `warmup` (pool/stats/logs/tags), `lead-finder` (credits/search/reveal/reveals/lists/saved-searches), `managed-inboxes` (config/check-domain/orders/mailboxes), `tracking-domains` (list/add/verify/delete)
+- New commands on `accounts`: `create`, `update`, `reconnect`, `enable-warmup`, `disable-warmup`, `health`, `warmup`
+- New command on `inbox`: `delete`
+- New command on `leads`: `tags`
+
+### Fixed
+- Single version source: `__version__` in `foxreach_cli/__init__.py`; `pyproject.toml` aligned to 0.4.0
+- Dependency bumped from `foxreach>=0.2.0` to `foxreach>=0.4.0`
+
+### Notes
+- PyPI publishing is pending; not yet published to pypi.org

{foxreach_cli-0.2.0 → foxreach_cli-0.5.0}/PKG-INFO

@@ -1,11 +1,11 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: foxreach-cli
-Version: 0.2.0
+Version: 0.5.0
 Summary: CLI for the FoxReach cold email outreach API
 Project-URL: Homepage, https://foxreach.io
-Project-URL: Documentation, https://docs.foxreach.io/sdks/cli
+Project-URL: Documentation, https://www.foxreach.io/docs/sdks/cli
 Project-URL: Repository, https://github.com/foxreach/foxreach-cli
-Project-URL: Changelog, https://docs.foxreach.io/changelog
+Project-URL: Changelog, https://www.foxreach.io/docs/changelog
 Author-email: FoxReach <dev@foxreach.io>
 License: MIT
 License-File: LICENSE
@@ -23,8 +23,11 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Communications :: Email
 Requires-Python: >=3.9
 Requires-Dist: click>=8.0
-Requires-Dist: foxreach>=0.2.0
+Requires-Dist: foxreach>=0.5.0
 Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: respx>=0.20; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # FoxReach CLI
@@ -62,6 +65,7 @@ export FOXREACH_BASE_URL=https://api.foxreach.io/api/v1  # optional
 ```bash
 foxreach leads list
 foxreach leads list --search "jane" --status active
+foxreach leads list --email jane@example.com   # exact, case-insensitive match
 foxreach leads get cld_abc123
 foxreach leads create --email jane@example.com --first-name Jane --company "Acme"
 foxreach leads update cld_abc123 --company "New Corp"
@@ -115,7 +119,8 @@ foxreach accounts delete acc_abc123
 ```bash
 foxreach inbox list
 foxreach inbox list --unread --category interested
-foxreach inbox get rpl_abc123
+foxreach inbox get rpl_abc123              # does not mark the thread read
+foxreach inbox get rpl_abc123 --mark-read  # marks it read
 foxreach inbox update rpl_abc123 --read --category qualified
 ```
 

{foxreach_cli-0.2.0 → foxreach_cli-0.5.0}/README.md

@@ -33,6 +33,7 @@ export FOXREACH_BASE_URL=https://api.foxreach.io/api/v1  # optional
 ```bash
 foxreach leads list
 foxreach leads list --search "jane" --status active
+foxreach leads list --email jane@example.com   # exact, case-insensitive match
 foxreach leads get cld_abc123
 foxreach leads create --email jane@example.com --first-name Jane --company "Acme"
 foxreach leads update cld_abc123 --company "New Corp"
@@ -86,7 +87,8 @@ foxreach accounts delete acc_abc123
 ```bash
 foxreach inbox list
 foxreach inbox list --unread --category interested
-foxreach inbox get rpl_abc123
+foxreach inbox get rpl_abc123              # does not mark the thread read
+foxreach inbox get rpl_abc123 --mark-read  # marks it read
 foxreach inbox update rpl_abc123 --read --category qualified
 ```
 

{foxreach_cli-0.2.0 → foxreach_cli-0.5.0}/foxreach_cli/__init__.py

@@ -1,3 +1,3 @@
 """FoxReach CLI — command-line interface for the FoxReach API."""
 
-__version__ = "0.1.0"
+__version__ = "0.5.0"

foxreach_cli-0.5.0/foxreach_cli/commands/accounts.py

@@ -0,0 +1,272 @@
+from __future__ import annotations
+
+import sys
+from dataclasses import asdict
+from typing import Optional
+
+import click
+
+from foxreach import EmailAccountCreate, EmailAccountUpdate, FoxReachError, ReconnectRequest
+
+from ..client_factory import get_client
+from ..output import print_detail, print_error, print_json, print_meta, print_success, print_table
+
+
+@click.group()
+def accounts() -> None:
+    """Manage email accounts."""
+
+
+@accounts.command("list")
+@click.option("--page", default=1, type=int)
+@click.option("--limit", default=50, type=int)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_list(page: int, limit: int, as_json: bool) -> None:
+    """List email accounts."""
+    client = get_client()
+    try:
+        result = client.email_accounts.list(page=page, page_size=limit)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json({"data": [asdict(a) for a in result.data], "meta": asdict(result.meta)})
+        return
+
+    if not result.data:
+        click.echo("No email accounts found.")
+        return
+
+    print_table(
+        result.data,
+        ["ID", "Email", "Display Name", "Active", "Daily Limit", "Sent Today", "Health"],
+        {
+            "ID": "id", "Email": "email", "Display Name": "display_name",
+            "Active": "is_active", "Daily Limit": "daily_limit",
+            "Sent Today": "sent_today", "Health": "health_score",
+        },
+    )
+    print_meta(result.meta)
+
+
+@accounts.command("get")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_get(account_id: str, as_json: bool) -> None:
+    """Get an email account by ID."""
+    client = get_client()
+    try:
+        account = client.email_accounts.get(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(account)
+        return
+
+    print_detail(account, [
+        "id", "email", "display_name", "provider", "is_active",
+        "daily_limit", "sent_today", "warmup_enabled",
+        "health_score", "bounce_rate", "reply_rate",
+        "connection_status", "created_at",
+    ])
+
+
+@accounts.command("delete")
+@click.argument("account_id")
+@click.confirmation_option(prompt="Are you sure you want to delete this email account?")
+def accounts_delete(account_id: str) -> None:
+    """Delete an email account."""
+    client = get_client()
+    try:
+        client.email_accounts.delete(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_success(f"Email account deleted: {account_id}")
+
+
+@accounts.command("create")
+@click.option("--email", required=True, help="Email address")
+@click.option("--password", required=True, hide_input=True, help="App password")
+@click.option("--smtp-host", required=True, help="SMTP host")
+@click.option("--smtp-port", required=True, type=int, help="SMTP port")
+@click.option("--imap-host", required=True, help="IMAP host")
+@click.option("--imap-port", required=True, type=int, help="IMAP port")
+@click.option("--provider", default="other", help="Provider (gmail/outlook/other)")
+@click.option("--display-name", default=None, help="Display name")
+@click.option("--daily-limit", default=None, type=int, help="Daily send limit")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_create(
+    email: str,
+    password: str,
+    smtp_host: str,
+    smtp_port: int,
+    imap_host: str,
+    imap_port: int,
+    provider: str,
+    display_name: Optional[str],
+    daily_limit: Optional[int],
+    as_json: bool,
+) -> None:
+    """Create a new email account. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.create(EmailAccountCreate(
+            email=email,
+            password=password,
+            smtp_host=smtp_host,
+            smtp_port=smtp_port,
+            imap_host=imap_host,
+            imap_port=imap_port,
+            provider=provider,
+            display_name=display_name,
+            daily_limit=daily_limit,
+        ))
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Email account created: {account.id} ({account.email})")
+
+
+@accounts.command("update")
+@click.argument("account_id")
+@click.option("--display-name", default=None, help="Display name")
+@click.option("--daily-limit", default=None, type=int, help="Daily send limit")
+@click.option("--timezone", default=None, help="Timezone")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_update(
+    account_id: str,
+    display_name: Optional[str],
+    daily_limit: Optional[int],
+    timezone: Optional[str],
+    as_json: bool,
+) -> None:
+    """Update an email account's settings. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.update(account_id, EmailAccountUpdate(
+            display_name=display_name,
+            daily_limit=daily_limit,
+            timezone=timezone,
+        ))
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Email account updated: {account_id}")
+
+
+@accounts.command("reconnect")
+@click.argument("account_id")
+@click.option("--password", required=True, hide_input=True, help="New app password")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_reconnect(account_id: str, password: str, as_json: bool) -> None:
+    """Reconnect an account with a new app password. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.reconnect(account_id, ReconnectRequest(password=password))
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Email account reconnected: {account_id}")
+
+
+@accounts.command("enable-warmup")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_enable_warmup(account_id: str, as_json: bool) -> None:
+    """Enable warmup for an account. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.enable_warmup(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Warmup enabled: {account_id}")
+
+
+@accounts.command("disable-warmup")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_disable_warmup(account_id: str, as_json: bool) -> None:
+    """Disable warmup for an account. Requires write scope."""
+    client = get_client()
+    try:
+        account = client.email_accounts.disable_warmup(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json(asdict(account))
+    else:
+        print_success(f"Warmup disabled: {account_id}")
+
+
+@accounts.command("health")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def accounts_health(account_id: str, as_json: bool) -> None:
+    """Get deliverability and warmup health metrics for an account."""
+    client = get_client()
+    try:
+        h = client.email_accounts.health(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+    if as_json:
+        print_json({
+            "healthScore": h.health_score,
+            "warmupEnabled": h.warmup_enabled,
+        })
+        return
+
+    score = h.health_score if h.health_score is not None else "—"
+    click.echo(f"  Health Score:  {score}")
+    click.echo(f"  Warmup:        {h.warmup_enabled}")
+
+
+@accounts.command("warmup")
+@click.argument("account_id")
+@click.option("--json", "as_json", is_flag=True, default=True, help="Output as JSON (default)")
+def accounts_warmup(account_id: str, as_json: bool) -> None:
+    """Get warmup progress and pool stats for an account."""
+    client = get_client()
+    try:
+        result = client.email_accounts.warmup_detail(account_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)
+
+
+@accounts.command("google-oauth-start")
+@click.option("--json", "as_json", is_flag=True, default=True, help="Output as JSON (default)")
+def accounts_google_oauth_start(as_json: bool) -> None:
+    """Start Google OAuth flow. Returns a browser redirect URL to complete the connection."""
+    client = get_client()
+    try:
+        result = client.email_accounts.google_oauth_start()
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)

{foxreach_cli-0.2.0 → foxreach_cli-0.5.0}/foxreach_cli/commands/campaigns.py

@@ -69,7 +69,7 @@ def campaigns_get(campaign_id: str, as_json: bool) -> None:
 
     print_detail(campaign, [
         "id", "name", "status", "timezone", "sending_days",
-        "sending_start_hour", "sending_end_hour", "daily_limit",
+        "sending_start_hour", "sending_end_hour", "daily_limit", "esp_matching",
         "total_leads", "total_sent", "total_delivered",
         "total_bounced", "total_replied", "total_opened",
         "created_at", "started_at", "completed_at",
@@ -82,6 +82,7 @@ def campaigns_get(campaign_id: str, as_json: bool) -> None:
 @click.option("--daily-limit", default=None, type=int, help="Max emails per day")
 @click.option("--start-hour", default=None, type=int, help="Sending start hour (0-23)")
 @click.option("--end-hour", default=None, type=int, help="Sending end hour (0-23)")
+@click.option("--esp-matching/--no-esp-matching", default=None, help="Send first emails from a mailbox on the recipient's provider")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
 def campaigns_create(
     name: str,
@@ -89,6 +90,7 @@ def campaigns_create(
     daily_limit: Optional[int],
     start_hour: Optional[int],
     end_hour: Optional[int],
+    esp_matching: Optional[bool],
     as_json: bool,
 ) -> None:
     """Create a new campaign."""
@@ -100,6 +102,7 @@ def campaigns_create(
             daily_limit=daily_limit,
             sending_start_hour=start_hour,
             sending_end_hour=end_hour,
+            esp_matching=esp_matching,
         ))
     except FoxReachError as e:
         print_error(str(e))
@@ -118,6 +121,7 @@ def campaigns_create(
 @click.option("--daily-limit", default=None, type=int, help="Max emails per day")
 @click.option("--start-hour", default=None, type=int, help="Sending start hour")
 @click.option("--end-hour", default=None, type=int, help="Sending end hour")
+@click.option("--esp-matching/--no-esp-matching", default=None, help="Send first emails from a mailbox on the recipient's provider")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
 def campaigns_update(
     campaign_id: str,
@@ -126,6 +130,7 @@ def campaigns_update(
     daily_limit: Optional[int],
     start_hour: Optional[int],
     end_hour: Optional[int],
+    esp_matching: Optional[bool],
     as_json: bool,
 ) -> None:
     """Update a campaign."""
@@ -137,6 +142,7 @@ def campaigns_update(
             daily_limit=daily_limit,
             sending_start_hour=start_hour,
             sending_end_hour=end_hour,
+            esp_matching=esp_matching,
         ))
     except FoxReachError as e:
         print_error(str(e))
@@ -257,3 +263,77 @@ def campaigns_add_accounts(campaign_id: str, account_ids: str) -> None:
         print_error(str(e))
         sys.exit(1)
     print_success(f"Added {result.get('added', len(ids))} accounts to campaign {campaign_id}")
+
+
+@campaigns.command("list-leads")
+@click.argument("campaign_id")
+@click.option("--page", default=1, type=int)
+@click.option("--limit", default=50, type=int)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def campaigns_list_leads(campaign_id: str, page: int, limit: int, as_json: bool) -> None:
+    """List leads enrolled in a campaign."""
+    client = get_client()
+    try:
+        result = client.campaigns.list_leads(campaign_id, page=page, page_size=limit)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    if as_json:
+        print_json(result)
+        return
+    data = result.get("data", []) if isinstance(result, dict) else result
+    if not data:
+        click.echo("No leads found.")
+        return
+    print_table(data, ["ID", "Email", "Status"], {"ID": "id", "Email": "email", "Status": "status"})
+
+
+@campaigns.command("list-accounts")
+@click.argument("campaign_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def campaigns_list_accounts(campaign_id: str, as_json: bool) -> None:
+    """List email accounts assigned to a campaign."""
+    client = get_client()
+    try:
+        result = client.campaigns.list_accounts(campaign_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    if as_json:
+        print_json(result)
+        return
+    data = result.get("data", []) if isinstance(result, dict) else result
+    if not data:
+        click.echo("No accounts found.")
+        return
+    print_table(data, ["ID", "Email"], {"ID": "id", "Email": "email"})
+
+
+@campaigns.command("esp-mix")
+@click.argument("campaign_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def campaigns_esp_mix(campaign_id: str, as_json: bool) -> None:
+    """Show how a campaign's mailboxes and leads split across mail providers."""
+    client = get_client()
+    try:
+        result = client.campaigns.get_esp_mix(campaign_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    if as_json:
+        print_json(result)
+        return
+    mix = result.get("data", {}) if isinstance(result, dict) else {}
+    senders = mix.get("senders", {})
+    leads = mix.get("leads", {})
+    click.echo(f"Provider matching: {'on' if mix.get('enabled') else 'off'}")
+    rows = [
+        {"provider": name, "mailboxes": senders.get(key, 0), "leads": leads.get(key, 0)}
+        for name, key in (("Google", "google"), ("Microsoft", "microsoft"), ("Other", "other"))
+    ]
+    rows.append({"provider": "Not looked up yet", "mailboxes": "", "leads": leads.get("unresolved", 0)})
+    print_table(rows, ["Provider", "Mailboxes", "Leads"], {"Provider": lambda r: r["provider"], "Mailboxes": lambda r: r["mailboxes"], "Leads": lambda r: r["leads"]})
+    # The SDK returns snake_case keys (total_leads), the raw API camelCase.
+    total = mix.get("total_leads", mix.get("totalLeads", 0))
+    pct = mix.get("resolved_pct", mix.get("resolvedPct", 0))
+    click.echo(f"{total} leads, {pct}% looked up")

{foxreach_cli-0.2.0 → foxreach_cli-0.5.0}/foxreach_cli/commands/inbox.py

@@ -77,12 +77,13 @@ def inbox_list(
 
 @inbox.command("get")
 @click.argument("reply_id")
+@click.option("--mark-read", is_flag=True, default=False, help="Also mark the thread as read")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
-def inbox_get(reply_id: str, as_json: bool) -> None:
-    """Get a thread by ID."""
+def inbox_get(reply_id: str, mark_read: bool, as_json: bool) -> None:
+    """Get a thread by ID. Does not mark it read unless --mark-read is passed."""
     client = get_client()
     try:
-        thread = client.inbox.get(reply_id)
+        thread = client.inbox.get(reply_id, mark_read=mark_read)
     except FoxReachError as e:
         print_error(str(e))
         sys.exit(1)
@@ -123,6 +124,20 @@ def inbox_update(reply_id: str, read: Optional[bool], starred: Optional[bool], c
         print_success(f"Thread updated: {reply_id}")
 
 
+@inbox.command("delete")
+@click.argument("reply_id")
+@click.confirmation_option(prompt="Are you sure you want to delete this thread?")
+def inbox_delete(reply_id: str) -> None:
+    """Delete an inbox thread. Requires write scope."""
+    client = get_client()
+    try:
+        client.inbox.delete(reply_id)
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_success(f"Thread deleted: {reply_id}")
+
+
 @inbox.command("conversation")
 @click.argument("reply_id")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
@@ -147,7 +162,7 @@ def inbox_conversation(reply_id: str, as_json: bool) -> None:
     for msg in messages:
         direction = msg.get("direction", "?")
         ts = msg.get("timestamp", "")[:19] if msg.get("timestamp") else "\u2014"
-        from_email = msg.get("fromEmail", "")
+        from_email = msg.get("from_email", msg.get("fromEmail", ""))
         subject = msg.get("subject", "")
         click.echo(f"  [{direction:>8}] {ts}  {from_email}  {subject}")
 
@@ -169,7 +184,7 @@ def inbox_reply(reply_id: str, body: str, subject: Optional[str], as_json: bool)
     if as_json:
         print_json(result)
     else:
-        print_success(f"Reply sent (message ID: {result.get('messageId', 'unknown')})")
+        print_success(f"Reply sent (message ID: {result.get('message_id', result.get('messageId', 'unknown'))})")
 
 
 @inbox.command("stats")
@@ -190,7 +205,39 @@ def inbox_stats(as_json: bool) -> None:
     click.echo(f"  Total:          {result.get('total', 0)}")
     click.echo(f"  Unread:         {result.get('unread', 0)}")
     click.echo(f"  Interested:     {result.get('interested', 0)}")
-    click.echo(f"  Not Interested: {result.get('notInterested', 0)}")
-    click.echo(f"  Out of Office:  {result.get('outOfOffice', 0)}")
+    click.echo(f"  Not Interested: {result.get('not_interested', result.get('notInterested', 0))}")
+    click.echo(f"  Out of Office:  {result.get('out_of_office', result.get('outOfOffice', 0))}")
     click.echo(f"  Uncategorized:  {result.get('uncategorized', 0)}")
-    click.echo(f"  Total Sent:     {result.get('totalSent', 0)}")
+    click.echo(f"  Total Sent:     {result.get('total_sent', result.get('totalSent', 0))}")
+
+
+@inbox.command("categorize-stats")
+@click.option("--campaign", "campaign_id", help="Scope to one campaign")
+@click.option("--step", "sequence_step", type=int, help="Scope to one sequence step")
+@click.option("--variant", "variant_id", help="Scope to one variant")
+@click.option(
+    "--group-by",
+    type=click.Choice(["variant", "step", "day"]),
+    help="Bucket counts by variant / step / day",
+)
+@click.option("--from", "from_date", help="ISO 8601 date (UTC)")
+@click.option("--to", "to_date", help="ISO 8601 date (UTC)")
+@click.option("--json", "as_json", is_flag=True, default=True, help="JSON output (default)")
+def inbox_categorize_stats(
+    campaign_id, sequence_step, variant_id, group_by, from_date, to_date, as_json
+):
+    """Per-variant/step/day reply categorization stats. Used by the cold.md autoresearch loop."""
+    client = get_client()
+    try:
+        result = client.inbox.categorize_stats(
+            campaign_id=campaign_id,
+            sequence_step=sequence_step,
+            variant_id=variant_id,
+            group_by=group_by,
+            from_date=from_date,
+            to_date=to_date,
+        )
+    except FoxReachError as e:
+        print_error(str(e))
+        sys.exit(1)
+    print_json(result)