"""GENERATED — do not edit by hand.

Regenerate with `python -m dograh_sdk.codegen` against the target
Dograh backend. Source of truth: the backend's model-backed node-spec
catalog served from `/api/v1/node-types`.
"""

from __future__ import annotations

from dataclasses import dataclass, field
from typing import Any, ClassVar, Literal, Optional

from dograh_sdk.typed._base import TypedNode


@dataclass(kw_only=True)
class Trigger(TypedNode):
    """
    Public HTTP endpoints that triggers the agent and make a call over
    telephone.  LLM hint: Exposes two public HTTP POST endpoints derived
    from the auto-generated `trigger_path`:   • Production:
    `<backend>/api/v1/public/agent/<trigger_path>` — runs the published
    agent. Use this from production systems.   • Test:
    `<backend>/api/v1/public/agent/test/<trigger_path>` — runs the latest
    draft, useful for verifying changes before publishing. Falls back to the
    published agent when no draft exists. Both require an API key in the
    `X-API-Key` header. Request body fields:   • `phone_number` (string,
    required) — destination to dial.   • `initial_context` (object,
    optional) — merged into the run's initial context.     To override the
    Start-node greeting for one call, provide `greeting_override`: either
    `{"type": "text", "text": "Hi {{name}}"}` or `{"type": "audio",
    "recording_id": "welcome-message"}`. A valid override takes precedence
    over the saved Start-node greeting.   • `telephony_configuration_id`
    (int, optional) — pick a specific telephony configuration for the call.
    Must belong to the same organization as the trigger. When omitted, the
    org's default outbound configuration is used.   • `from_phone_number_id`
    (int, optional) — pick the caller-ID number to use. It must be active
    and registered to the resolved telephony configuration.
    """

    type: ClassVar[str] = 'trigger'

    name: str = 'API Trigger'
    """
    Short identifier shown in the canvas. No runtime effect.
    """

    enabled: bool = True
    """
    When false, the trigger URL returns 404.
    """

    trigger_path: Optional[str] = None
    """
    Path segment that uniquely identifies this trigger. Used in both URLs:
    • Production: `/api/v1/public/agent/<trigger_path>` — executes the
    published agent.   • Test: `/api/v1/public/agent/test/<trigger_path>` —
    executes the latest draft. Can be customized to a descriptive value up
    to 36 characters using letters, numbers, hyphens, or underscores.
    """