autotouch-cli 0.2.13__tar.gz → 0.2.17__tar.gz

{autotouch_cli-0.2.13 → autotouch_cli-0.2.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.13
+Version: 0.2.17
 Summary: Autotouch Smart Table CLI
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -187,6 +187,33 @@ Important:
 - These workflow routes support `actorUserId` query parameter.
 - External sequence validation rules (manual vs automated vs AI draft constraints) are documented in the workflow reference above.
 
+## Outbound webhook subscriptions
+
+Use webhook subscriptions to receive customer-facing event notifications.
+
+```bash
+autotouch webhooks subscriptions list
+
+autotouch webhooks subscriptions create \
+  --url https://example.com/webhooks/smart-table \
+  --events bulk_job.* lead.status_changed sequence_enrollment.created task.created
+
+autotouch webhooks subscriptions test \
+  --subscription-id <SUBSCRIPTION_ID> \
+  --event-type lead.created \
+  --data-json '{"ping":"ok"}'
+autotouch webhooks deliveries list --subscription-id <SUBSCRIPTION_ID>
+autotouch webhooks deliveries attempts --delivery-id <DELIVERY_ID>
+```
+
+Developer key scopes:
+- `webhooks:read`
+- `webhooks:write`
+
+Retention note:
+- Webhook event cache and delivery-attempt logs default to 7 days
+  (`WEBHOOK_EVENTS_TTL_DAYS`, `WEBHOOK_DELIVERY_ATTEMPTS_TTL_DAYS`).
+
 ## Create basic/manual fields (text, number, date, etc.)
 
 Use `kind=manual` for non-enrichment columns.

{autotouch_cli-0.2.13 → autotouch_cli-0.2.17}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.13
+Version: 0.2.17
 Summary: Autotouch Smart Table CLI
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -187,6 +187,33 @@ Important:
 - These workflow routes support `actorUserId` query parameter.
 - External sequence validation rules (manual vs automated vs AI draft constraints) are documented in the workflow reference above.
 
+## Outbound webhook subscriptions
+
+Use webhook subscriptions to receive customer-facing event notifications.
+
+```bash
+autotouch webhooks subscriptions list
+
+autotouch webhooks subscriptions create \
+  --url https://example.com/webhooks/smart-table \
+  --events bulk_job.* lead.status_changed sequence_enrollment.created task.created
+
+autotouch webhooks subscriptions test \
+  --subscription-id <SUBSCRIPTION_ID> \
+  --event-type lead.created \
+  --data-json '{"ping":"ok"}'
+autotouch webhooks deliveries list --subscription-id <SUBSCRIPTION_ID>
+autotouch webhooks deliveries attempts --delivery-id <DELIVERY_ID>
+```
+
+Developer key scopes:
+- `webhooks:read`
+- `webhooks:write`
+
+Retention note:
+- Webhook event cache and delivery-attempt logs default to 7 days
+  (`WEBHOOK_EVENTS_TTL_DAYS`, `WEBHOOK_DELIVERY_ATTEMPTS_TTL_DAYS`).
+
 ## Create basic/manual fields (text, number, date, etc.)
 
 Use `kind=manual` for non-enrichment columns.

{autotouch_cli-0.2.13 → autotouch_cli-0.2.17}/autotouch_cli.egg-info/SOURCES.txt

@@ -47,6 +47,7 @@ scripts/migrations/20251109_add_ttl_for_llm_and_preview_traces.py
 scripts/migrations/20260113_normalize_table_filter_operators.py
 scripts/migrations/20260113_set_user_permissions_user_admin.py
 scripts/migrations/20260204_sync_lead_owner_from_tasks.py
+scripts/migrations/20260303_add_webhook_subscription_collections.py
 scripts/migrations/migrate_org_user_credits.py
 scripts/migrations/set_default_lead_status.py
 scripts/migrations/update_lead_owner_from_tasks.py

{autotouch_cli-0.2.13 → autotouch_cli-0.2.17}/docs/research-table/reference/autotouch-cli-pypi.md

@@ -178,6 +178,33 @@ Important:
 - These workflow routes support `actorUserId` query parameter.
 - External sequence validation rules (manual vs automated vs AI draft constraints) are documented in the workflow reference above.
 
+## Outbound webhook subscriptions
+
+Use webhook subscriptions to receive customer-facing event notifications.
+
+```bash
+autotouch webhooks subscriptions list
+
+autotouch webhooks subscriptions create \
+  --url https://example.com/webhooks/smart-table \
+  --events bulk_job.* lead.status_changed sequence_enrollment.created task.created
+
+autotouch webhooks subscriptions test \
+  --subscription-id <SUBSCRIPTION_ID> \
+  --event-type lead.created \
+  --data-json '{"ping":"ok"}'
+autotouch webhooks deliveries list --subscription-id <SUBSCRIPTION_ID>
+autotouch webhooks deliveries attempts --delivery-id <DELIVERY_ID>
+```
+
+Developer key scopes:
+- `webhooks:read`
+- `webhooks:write`
+
+Retention note:
+- Webhook event cache and delivery-attempt logs default to 7 days
+  (`WEBHOOK_EVENTS_TTL_DAYS`, `WEBHOOK_DELIVERY_ATTEMPTS_TTL_DAYS`).
+
 ## Create basic/manual fields (text, number, date, etc.)
 
 Use `kind=manual` for non-enrichment columns.

{autotouch_cli-0.2.13 → autotouch_cli-0.2.17}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "autotouch-cli"
-version = "0.2.13"
+version = "0.2.17"
 description = "Autotouch Smart Table CLI"
 readme = "docs/research-table/reference/autotouch-cli-pypi.md"
 requires-python = ">=3.9"

autotouch_cli-0.2.17/scripts/migrations/20260303_add_webhook_subscription_collections.py

@@ -0,0 +1,124 @@
+"""
+Create outbound webhook subscription/outbox collections and indexes.
+Also ensures 7-day default TTL retention for webhook event cache and attempt logs
+(configurable via WEBHOOK_EVENTS_TTL_DAYS / WEBHOOK_DELIVERY_ATTEMPTS_TTL_DAYS).
+
+Usage:
+  python3 scripts/migrations/20260303_add_webhook_subscription_collections.py \
+    --uri "<mongodb uri>" --db autotouch
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+from pymongo import MongoClient
+
+
+WEBHOOK_EVENTS_TTL_DAYS = max(1, min(365, int(os.getenv("WEBHOOK_EVENTS_TTL_DAYS", "7") or 7)))
+WEBHOOK_DELIVERY_ATTEMPTS_TTL_DAYS = max(
+    1, min(365, int(os.getenv("WEBHOOK_DELIVERY_ATTEMPTS_TTL_DAYS", "7") or 7))
+)
+WEBHOOK_EVENTS_TTL_SECONDS = WEBHOOK_EVENTS_TTL_DAYS * 24 * 60 * 60
+WEBHOOK_DELIVERY_ATTEMPTS_TTL_SECONDS = WEBHOOK_DELIVERY_ATTEMPTS_TTL_DAYS * 24 * 60 * 60
+
+
+def ensure_indexes(db) -> None:
+    db.webhook_subscriptions.create_index(
+        [("organization_id", 1), ("enabled", 1), ("updated_at", -1)],
+        name="webhook_subscriptions_org_enabled_updated",
+        background=True,
+    )
+    db.webhook_subscriptions.create_index(
+        [("organization_id", 1), ("events", 1)],
+        name="webhook_subscriptions_org_events",
+        background=True,
+    )
+
+    db.webhook_events.create_index(
+        [("event_id", 1)],
+        name="webhook_events_event_id_unique",
+        unique=True,
+        background=True,
+    )
+    db.webhook_events.create_index(
+        [("organization_id", 1), ("occurred_at", -1)],
+        name="webhook_events_org_occurred",
+        background=True,
+    )
+    db.webhook_events.create_index(
+        [("type", 1), ("occurred_at", -1)],
+        name="webhook_events_type_occurred",
+        background=True,
+    )
+    db.webhook_events.create_index(
+        [("created_at", 1)],
+        name="webhook_events_created_ttl",
+        expireAfterSeconds=WEBHOOK_EVENTS_TTL_SECONDS,
+        background=True,
+    )
+
+    db.webhook_deliveries.create_index(
+        [("delivery_id", 1)],
+        name="webhook_deliveries_delivery_id_unique",
+        unique=True,
+        background=True,
+    )
+    db.webhook_deliveries.create_index(
+        [("organization_id", 1), ("status", 1), ("created_at", -1)],
+        name="webhook_deliveries_org_status_created",
+        background=True,
+    )
+    db.webhook_deliveries.create_index(
+        [("subscription_id", 1), ("created_at", -1)],
+        name="webhook_deliveries_subscription_created",
+        background=True,
+    )
+    db.webhook_deliveries.create_index(
+        [("next_attempt_at", 1), ("status", 1)],
+        name="webhook_deliveries_next_attempt_status",
+        background=True,
+    )
+
+    db.webhook_delivery_attempts.create_index(
+        [("delivery_id", 1), ("attempt_number", 1)],
+        name="webhook_delivery_attempts_delivery_attempt_unique",
+        unique=True,
+        background=True,
+    )
+    db.webhook_delivery_attempts.create_index(
+        [("delivery_id", 1), ("created_at", -1)],
+        name="webhook_delivery_attempts_delivery_created",
+        background=True,
+    )
+    db.webhook_delivery_attempts.create_index(
+        [("created_at", 1)],
+        name="webhook_delivery_attempts_created_ttl",
+        expireAfterSeconds=WEBHOOK_DELIVERY_ATTEMPTS_TTL_SECONDS,
+        background=True,
+    )
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Ensure webhook subscription/outbox indexes")
+    parser.add_argument("--uri", required=True, help="MongoDB URI")
+    parser.add_argument("--db", default="autotouch", help="Database name")
+    parser.add_argument(
+        "--tls-insecure",
+        action="store_true",
+        help="Allow invalid TLS certificates (for local trust-store issues)",
+    )
+    args = parser.parse_args()
+
+    client_kwargs = {}
+    if args.tls_insecure:
+        client_kwargs["tlsAllowInvalidCertificates"] = True
+
+    client = MongoClient(args.uri, **client_kwargs)
+    db = client[args.db]
+    ensure_indexes(db)
+    print("Webhook subscription indexes ensured")
+
+
+if __name__ == "__main__":
+    main()

{autotouch_cli-0.2.13 → autotouch_cli-0.2.17}/scripts/smart_table_cli.py

@@ -2718,6 +2718,225 @@ def cmd_webhooks_ingest(args: argparse.Namespace) -> None:
     _print_json(data, compact=args.compact)
 
 
+def cmd_webhooks_subscriptions_list(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    params: Dict[str, Any] = {"limit": int(args.limit or 100)}
+    if args.include_disabled:
+        params["includeDisabled"] = True
+    data = _request_api(
+        "GET",
+        "/api/webhook-subscriptions",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        params=params,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_subscriptions_create(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    payload = _load_json_input(
+        inline_json=args.data_json,
+        file_path=args.data_file,
+        context="data",
+        default=None,
+    )
+    if payload is None:
+        payload = {
+            "url": args.url,
+            "events": args.events or [],
+            "enabled": not bool(args.paused),
+            "filters": _load_json_input(
+                inline_json=args.filters_json,
+                file_path=args.filters_file,
+                context="filters",
+                default={},
+            )
+            or {},
+            "metadata": _load_json_input(
+                inline_json=args.metadata_json,
+                file_path=args.metadata_file,
+                context="metadata",
+                default={},
+            )
+            or {},
+        }
+        if args.retry_policy_json or args.retry_policy_file:
+            payload["retryPolicy"] = _load_json_input(
+                inline_json=args.retry_policy_json,
+                file_path=args.retry_policy_file,
+                context="retry-policy",
+                default={},
+            ) or {}
+    data = _request_api(
+        "POST",
+        "/api/webhook-subscriptions",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_subscriptions_get(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    data = _request_api(
+        "GET",
+        f"/api/webhook-subscriptions/{args.subscription_id}",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_subscriptions_update(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    payload = _load_json_input(
+        inline_json=args.data_json,
+        file_path=args.data_file,
+        context="data",
+        default={},
+    )
+    data = _request_api(
+        "PATCH",
+        f"/api/webhook-subscriptions/{args.subscription_id}",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_subscriptions_delete(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    data = _request_api(
+        "DELETE",
+        f"/api/webhook-subscriptions/{args.subscription_id}",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_subscriptions_pause(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    data = _request_api(
+        "POST",
+        f"/api/webhook-subscriptions/{args.subscription_id}/pause",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_subscriptions_resume(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    data = _request_api(
+        "POST",
+        f"/api/webhook-subscriptions/{args.subscription_id}/resume",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_subscriptions_rotate_secret(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    data = _request_api(
+        "POST",
+        f"/api/webhook-subscriptions/{args.subscription_id}/rotate-secret",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_subscriptions_test(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    payload = _load_json_input(
+        inline_json=args.data_json,
+        file_path=args.data_file,
+        context="data",
+        default={},
+    )
+    request_payload: Dict[str, Any] = {"data": payload or {}}
+    if getattr(args, "event_type", None):
+        request_payload["eventType"] = str(args.event_type).strip()
+    data = _request_api(
+        "POST",
+        f"/api/webhook-subscriptions/{args.subscription_id}/test",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=request_payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_deliveries_list(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    params: Dict[str, Any] = {"limit": int(args.limit or 100)}
+    if args.subscription_id:
+        params["subscriptionId"] = args.subscription_id
+    if args.status:
+        params["status"] = args.status
+    if args.event_type:
+        params["eventType"] = args.event_type
+    data = _request_api(
+        "GET",
+        "/api/webhook-subscriptions/deliveries",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        params=params,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_webhooks_deliveries_attempts(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    params: Dict[str, Any] = {"limit": int(args.limit or 100)}
+    data = _request_api(
+        "GET",
+        f"/api/webhook-subscriptions/deliveries/{args.delivery_id}/attempts",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        params=params,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
 def _mongo_client(uri: Optional[str], db_name: Optional[str]):
     if MongoClient is None:
         print("ERROR: pymongo not installed. Install requirements and retry.", file=sys.stderr)
@@ -3109,6 +3328,87 @@ def build_parser() -> argparse.ArgumentParser:
     pwhi.add_argument("--verbose", action="store_true", help="Print request metadata to stderr")
     pwhi.set_defaults(func=cmd_webhooks_ingest)
 
+    pwhs = wh_sub.add_parser("subscriptions", help="Manage outbound webhook subscriptions")
+    whs_sub = pwhs.add_subparsers(dest="webhooks_subscriptions_cmd", required=True)
+
+    pwhsl = whs_sub.add_parser("list", help="List webhook subscriptions")
+    pwhsl.add_argument("--include-disabled", action="store_true", help="Include paused/disabled subscriptions")
+    pwhsl.add_argument("--limit", type=int, default=100, help="Max subscriptions to return (1-500)")
+    _add_api_common_arguments(pwhsl)
+    pwhsl.set_defaults(func=cmd_webhooks_subscriptions_list)
+
+    pwhsc = whs_sub.add_parser("create", help="Create a webhook subscription")
+    pwhsc.add_argument("--url", help="Webhook endpoint URL")
+    pwhsc.add_argument("--events", nargs="*", help="Event names or families (for example bulk_job.*)")
+    pwhsc.add_argument("--paused", action="store_true", help="Create subscription as paused/disabled")
+    pwhsc.add_argument("--filters-json", help="Optional filters JSON")
+    pwhsc.add_argument("--filters-file", help="Optional filters JSON file")
+    pwhsc.add_argument("--metadata-json", help="Optional metadata JSON")
+    pwhsc.add_argument("--metadata-file", help="Optional metadata JSON file")
+    pwhsc.add_argument("--retry-policy-json", help="Optional retryPolicy JSON")
+    pwhsc.add_argument("--retry-policy-file", help="Optional retryPolicy JSON file")
+    pwhsc.add_argument("--data-json", help="Full request payload JSON")
+    pwhsc.add_argument("--data-file", help="Full request payload JSON file")
+    _add_api_common_arguments(pwhsc)
+    pwhsc.set_defaults(func=cmd_webhooks_subscriptions_create)
+
+    pwhsg = whs_sub.add_parser("get", help="Get a webhook subscription")
+    pwhsg.add_argument("--subscription-id", required=True)
+    _add_api_common_arguments(pwhsg)
+    pwhsg.set_defaults(func=cmd_webhooks_subscriptions_get)
+
+    pwhsu = whs_sub.add_parser("update", help="Update a webhook subscription")
+    pwhsu.add_argument("--subscription-id", required=True)
+    pwhsu.add_argument("--data-json", help="Patch payload JSON")
+    pwhsu.add_argument("--data-file", help="Patch payload JSON file")
+    _add_api_common_arguments(pwhsu)
+    pwhsu.set_defaults(func=cmd_webhooks_subscriptions_update)
+
+    pwhsd = whs_sub.add_parser("delete", help="Delete a webhook subscription")
+    pwhsd.add_argument("--subscription-id", required=True)
+    _add_api_common_arguments(pwhsd)
+    pwhsd.set_defaults(func=cmd_webhooks_subscriptions_delete)
+
+    pwhsp = whs_sub.add_parser("pause", help="Pause a webhook subscription")
+    pwhsp.add_argument("--subscription-id", required=True)
+    _add_api_common_arguments(pwhsp)
+    pwhsp.set_defaults(func=cmd_webhooks_subscriptions_pause)
+
+    pwhsr = whs_sub.add_parser("resume", help="Resume a paused webhook subscription")
+    pwhsr.add_argument("--subscription-id", required=True)
+    _add_api_common_arguments(pwhsr)
+    pwhsr.set_defaults(func=cmd_webhooks_subscriptions_resume)
+
+    pwhsrs = whs_sub.add_parser("rotate-secret", help="Rotate webhook subscription signing secret")
+    pwhsrs.add_argument("--subscription-id", required=True)
+    _add_api_common_arguments(pwhsrs)
+    pwhsrs.set_defaults(func=cmd_webhooks_subscriptions_rotate_secret)
+
+    pwhst = whs_sub.add_parser("test", help="Fire a test event for a subscription")
+    pwhst.add_argument("--subscription-id", required=True)
+    pwhst.add_argument("--event-type", help="Optional event type (for example lead.created)")
+    pwhst.add_argument("--data-json", help="Optional test payload JSON")
+    pwhst.add_argument("--data-file", help="Optional test payload JSON file")
+    _add_api_common_arguments(pwhst)
+    pwhst.set_defaults(func=cmd_webhooks_subscriptions_test)
+
+    pwhd = wh_sub.add_parser("deliveries", help="Inspect webhook delivery outcomes")
+    whd_sub = pwhd.add_subparsers(dest="webhooks_deliveries_cmd", required=True)
+
+    pwhdl = whd_sub.add_parser("list", help="List webhook deliveries")
+    pwhdl.add_argument("--subscription-id", help="Filter by subscription id")
+    pwhdl.add_argument("--status", help="Filter by status (queued/retry_scheduled/succeeded/failed)")
+    pwhdl.add_argument("--event-type", help="Filter by event type")
+    pwhdl.add_argument("--limit", type=int, default=100, help="Max deliveries to return (1-500)")
+    _add_api_common_arguments(pwhdl)
+    pwhdl.set_defaults(func=cmd_webhooks_deliveries_list)
+
+    pwhda = whd_sub.add_parser("attempts", help="List delivery attempts for one delivery id")
+    pwhda.add_argument("--delivery-id", required=True)
+    pwhda.add_argument("--limit", type=int, default=100, help="Max attempts to return (1-500)")
+    _add_api_common_arguments(pwhda)
+    pwhda.set_defaults(func=cmd_webhooks_deliveries_attempts)
+
     # Backward-compatible aliases
     # run
     palias_run = sub.add_parser("run", help="Alias for: columns run")