:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
"""Product analytics events for the agentic provisioning API."""
from __future__ import annotations
import uuid
import posthoganalytics
from posthog.models.oauth import OAuthApplication
def _anonymous_distinct_id() -> str:
return f"agentic_provisioning_{uuid.uuid4().hex[:16]}"
def capture_provisioning_event(
event_type: str,
outcome: str,
*,
partner: OAuthApplication | None = None,
**extra: object,
) -> None:
team_id = extra.get("team_id")
distinct_id = f"agentic_provisioning_team_{team_id}" if team_id else _anonymous_distinct_id()
properties: dict[str, object] = {"outcome": outcome, **extra}
if partner is not None:
properties.setdefault("partner_id", str(partner.id))
properties.setdefault("client_name", partner.name)
posthoganalytics.capture(
f"agentic_provisioning {event_type}",
distinct_id=distinct_id,
properties=properties,
)
def capture_deep_link_event(outcome: str, **extra: object) -> None:
# Pinned: the Stripe namespace captures this step under the same name, so both surfaces share a funnel.
capture_provisioning_event("deep_link_login", outcome, partner=None, **extra)
def capture_auth_event(app: OAuthApplication, outcome: str, **extra: object) -> None:
posthoganalytics.capture(
"agentic_provisioning auth",
distinct_id=_anonymous_distinct_id(),
properties={
"outcome": outcome,
"client_name": app.name,
"client_type": app.client_type,
"app_id": str(app.id),
**extra,
},
)
def capture_region_proxy_event(outcome: str, **props: object) -> None:
posthoganalytics.capture(
"agentic_provisioning region_proxy",
distinct_id=_anonymous_distinct_id(),
properties={"outcome": outcome, **props},
)