messagebird-sdk 0.2.2__tar.gz → 0.4.0__tar.gz

{messagebird_sdk-0.2.2 → messagebird_sdk-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: messagebird-sdk
-Version: 0.2.2
+Version: 0.4.0
 Summary: The official Python SDK for the Bird email platform.
 Project-URL: Homepage, https://bird.com
 Project-URL: Documentation, https://bird.com/docs/sdks/python

{messagebird_sdk-0.2.2 → messagebird_sdk-0.4.0}/src/bird/__init__.py

@@ -12,15 +12,47 @@ from bird._client import AsyncBird, Bird
 from bird._response import APIResponse
 from bird._types import (
     Attachment,
+    AudienceContactsAddParams,
+    AudienceContactsRemoveParams,
+    AudienceCreateParams,
+    AudienceListContactsParams,
+    AudienceListParams,
+    AudienceUpdateParams,
+    ContactBatchParams,
+    ContactCreateParams,
+    ContactListParams,
+    ContactPropertyCreateParams,
+    ContactPropertyListParams,
+    ContactPropertyUpdateParams,
+    ContactUpdateParams,
     EmailDefaults,
     EmailListParams,
     EmailSendBatchParams,
     EmailSendParams,
     RequestOptions,
+    SmsSendParams,
 )
 from bird._generated import (
+    Audience,
+    AudienceList,
+    AudienceMember,
+    AudienceMemberList,
+    Contact,
+    ContactList,
+    ContactProperty,
+    ContactPropertyList,
+    ContactUpsertResult,
     EmailMessage,
     EmailMessageBatchResponse,
+    EmailTemplate,
+    EmailTemplateList,
+    EmailTemplateSummary,
+    EmailTemplateVersion,
+    EmailTemplateVersionList,
+    SMSMessage,
+    SMSMessageBatchResponse,
+    SMSTemplate,
+    SMSTemplateList,
     WebhookEvent,
 )
 from bird._event_types import WebhookEventType
@@ -50,11 +82,43 @@ __all__ = [
     "EmailSendParams",
     "EmailSendBatchParams",
     "EmailListParams",
+    "ContactCreateParams",
+    "ContactUpdateParams",
+    "ContactListParams",
+    "ContactBatchParams",
+    "Contact",
+    "ContactList",
+    "ContactUpsertResult",
+    "ContactPropertyCreateParams",
+    "ContactPropertyUpdateParams",
+    "ContactPropertyListParams",
+    "ContactProperty",
+    "ContactPropertyList",
+    "AudienceCreateParams",
+    "AudienceUpdateParams",
+    "AudienceListParams",
+    "AudienceListContactsParams",
+    "AudienceContactsAddParams",
+    "AudienceContactsRemoveParams",
+    "Audience",
+    "AudienceList",
+    "AudienceMember",
+    "AudienceMemberList",
     "APIResponse",
     "SyncPage",
     "AsyncPage",
     "EmailMessage",
     "EmailMessageBatchResponse",
+    "EmailTemplate",
+    "EmailTemplateSummary",
+    "EmailTemplateVersion",
+    "EmailTemplateList",
+    "EmailTemplateVersionList",
+    "SmsSendParams",
+    "SMSMessage",
+    "SMSMessageBatchResponse",
+    "SMSTemplate",
+    "SMSTemplateList",
     "WebhookEvent",
     "GenericWebhookEvent",
     "WebhookEventType",

{messagebird_sdk-0.2.2 → messagebird_sdk-0.4.0}/src/bird/_base_client.py

@@ -20,6 +20,7 @@ from urllib.parse import urlsplit
 
 import httpx
 
+from bird._caller import detect_caller
 from bird._constants import DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, INITIAL_RETRY_DELAY, MAX_RETRY_DELAY
 from bird._exceptions import APIConnectionError, APITimeoutError, from_response, parse_retry_after
 from bird._types import NOT_GIVEN, NotGiven
@@ -37,6 +38,10 @@ _CLIENT_HEADERS = {
     "Bird-Os": platform.system().lower(),
     "Bird-Arch": platform.machine().lower(),
 }
+# Bird-Caller (the driving agent harness) — omitted when no agent env is present.
+_caller = detect_caller()
+if _caller:
+    _CLIENT_HEADERS["Bird-Caller"] = _caller
 
 _MUTATING_METHODS = {"POST", "PUT", "PATCH", "DELETE"}
 # SDK-owned headers a caller's extra_headers must never override. Derived from

messagebird_sdk-0.4.0/src/bird/_caller.py

@@ -0,0 +1,45 @@
+"""Bird-Caller detection: which agent harness drives the SDK (ADR-0074).
+
+Best-effort, non-authoritative usage telemetry -- it only labels traffic, never
+gates behavior. The single source of truth is ``clients/caller-detection.yaml``
+(shared with the CLI and the other SDKs); the ordered rule table in
+``_caller_rules`` is generated from it.
+"""
+
+from __future__ import annotations
+
+import os
+import re
+from collections.abc import Mapping
+
+from ._caller_rules import CALLER_BOOLEANISH_SKIP, CALLER_DEFAULT, CALLER_RULES
+
+_VALID = re.compile(r"^[a-z0-9._-]+$")
+
+
+def detect_caller(environ: Mapping[str, str] | None = None) -> str:
+    """Infer the driving environment by walking the generated rules in order.
+
+    ``environ`` is injected in tests; production uses ``os.environ``.
+    """
+    env = os.environ if environ is None else environ
+    for rule in CALLER_RULES:
+        value = env.get(str(rule["env"]), "")
+        equals = rule.get("equals")
+        if not value or (equals is not None and value != equals):
+            continue
+        if not rule.get("passthrough"):
+            return str(rule["name"])
+        sanitized = _sanitize(value)
+        if sanitized:
+            return sanitized
+    return CALLER_DEFAULT
+
+
+def _sanitize(value: str) -> str:
+    # Lowercase and bound a passthrough (AGENT=<name>) value the same charset+length
+    # way as the other Bird-* labels; drop boolean-ish values with no harness identity.
+    s = value.strip().lower()
+    if not s or len(s) > 32 or s in CALLER_BOOLEANISH_SKIP:
+        return ""
+    return s if _VALID.match(s) else ""

messagebird_sdk-0.4.0/src/bird/_caller_rules.py

@@ -0,0 +1,32 @@
+# Code generated by tools/callergen from clients/caller-detection.yaml. DO NOT EDIT.
+
+CALLER_RULES = [
+    {"env": "CLAUDECODE", "name": "claude-code"},
+    {"env": "CODEX_CI", "name": "codex"},
+    {"env": "GEMINI_CLI", "name": "gemini"},
+    {"env": "QWEN_CODE", "name": "qwen"},
+    {"env": "PI_CODING_AGENT", "name": "pi"},
+    {"env": "OPENCODE", "name": "opencode"},
+    {"env": "CLINE_ACTIVE", "name": "cline"},
+    {"env": "ROO_ACTIVE", "name": "roo"},
+    {"env": "CURSOR_TRACE_ID", "name": "cursor"},
+    {"env": "CURSOR_AGENT", "name": "cursor"},
+    {"env": "ANTIGRAVITY_AGENT", "name": "antigravity"},
+    {"env": "AUGMENT_AGENT", "name": "augment"},
+    {"env": "AGENT", "passthrough": True},
+    {"env": "AI_AGENT", "passthrough": True},
+    {"env": "REPL_ID", "name": "replit"},
+    {"env": "CI", "name": "ci"},
+    {"env": "GITHUB_ACTIONS", "name": "ci"},
+    {"env": "TERM_PROGRAM", "equals": "zed", "name": "zed"},
+    {"env": "ZED_TERM", "name": "zed"},
+    {"env": "TERM_PROGRAM", "equals": "kiro", "name": "kiro"},
+    {"env": "TERM_PROGRAM", "equals": "WarpTerminal", "name": "warp"},
+    {"env": "TERMINAL_EMULATOR", "equals": "JetBrains-JediTerm", "name": "jetbrains"},
+    {"env": "__CFBundleIdentifier", "equals": "com.exafunction.windsurf", "name": "windsurf"},
+    {"env": "TERM_PROGRAM", "equals": "vscode", "name": "vscode"},
+]
+
+CALLER_BOOLEANISH_SKIP = {"1", "0", "true", "false", "yes", "no", "on", "off"}
+
+CALLER_DEFAULT = "shell"

{messagebird_sdk-0.2.2 → messagebird_sdk-0.4.0}/src/bird/_client.py

@@ -20,7 +20,13 @@ from bird._base_client import AsyncAPIClient, SyncAPIClient
 from bird._constants import DEFAULT_MAX_RETRIES
 from bird._exceptions import BirdError
 from bird._types import NOT_GIVEN, EmailDefaults, NotGiven
+from bird.resources.audiences import AsyncAudiences, Audiences
+from bird.resources.contact_properties import AsyncContactProperties, ContactProperties
+from bird.resources.contacts import AsyncContacts, Contacts
 from bird.resources.email import AsyncEmail, Email
+from bird.resources.email_templates import AsyncEmailTemplates, EmailTemplates
+from bird.resources.sms import AsyncSms, Sms
+from bird.resources.sms_templates import AsyncSMSTemplates, SMSTemplates
 from bird.resources.webhooks import AsyncWebhooks, Webhooks
 
 _REGION_PREFIX = re.compile(r"^bk_([a-z]{2}[0-9]+)_")
@@ -139,6 +145,12 @@ class Bird(SyncAPIClient):
         super().__init__(**{k: v for k, v in self._config.items() if k not in ("webhook_secret", "email_defaults", "region")})
         self.webhook_secret = webhook_secret
         self.email = Email(self, email_defaults)
+        self.email_templates = EmailTemplates(self)
+        self.sms = Sms(self)
+        self.sms_templates = SMSTemplates(self)
+        self.contacts = Contacts(self)
+        self.contact_properties = ContactProperties(self)
+        self.audiences = Audiences(self)
         self.webhooks = Webhooks(webhook_secret)
 
     def with_options(
@@ -230,6 +242,12 @@ class AsyncBird(AsyncAPIClient):
         super().__init__(**{k: v for k, v in self._config.items() if k not in ("webhook_secret", "email_defaults", "region")})
         self.webhook_secret = webhook_secret
         self.email = AsyncEmail(self, email_defaults)
+        self.email_templates = AsyncEmailTemplates(self)
+        self.sms = AsyncSms(self)
+        self.sms_templates = AsyncSMSTemplates(self)
+        self.contacts = AsyncContacts(self)
+        self.contact_properties = AsyncContactProperties(self)
+        self.audiences = AsyncAudiences(self)
         self.webhooks = AsyncWebhooks(webhook_secret)
 
     def with_options(