@talkif/sdk 0.1.0

package/dist/cjs/api/types/ErrorCode.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Machine-readable error code for programmatic error handling
+ *
+ * All codes use `snake_case` format. Use the `code` field in error responses
+ * to handle specific error conditions in your application.
+ *
+ * Error categories by HTTP status:
+ *
+ * - **Authentication** (401): `invalid_credentials`, `token_expired`, `token_invalid`, `token_missing`
+ * - **Authorization** (403): `account_suspended`, `account_access_denied`, `forbidden`
+ * - **Validation** (400): `validation_failed`, `bad_request`, `invalid_json`
+ * - **Payment** (402): `insufficient_balance`, `payment_required`, `payment_failed`
+ * - **Conflicts** (409): `email_already_exists`, `phone_already_exists`, `conflict`
+ * - **Not Found** (404): `not_found`, `resource_not_found`, `schedule_not_found`
+ * - **Business Rules** (422): `concurrent_call_limit_exceeded`, `flow_not_published`, `invalid_state_transition`
+ * - **Rate Limiting** (429): `rate_limit_exceeded`, `queue_full`
+ * - **Server** (5xx): `internal_error`, `service_unavailable`, `service_error`
+ */
+export declare const ErrorCode: {
+    readonly InvalidCredentials: "invalid_credentials";
+    readonly EmailAlreadyExists: "email_already_exists";
+    readonly PhoneAlreadyExists: "phone_already_exists";
+    readonly ContactPhoneAlreadyExists: "contact_phone_already_exists";
+    readonly AccountSuspended: "account_suspended";
+    readonly AccountAccessDenied: "account_access_denied";
+    readonly TokenExpired: "token_expired";
+    readonly TokenInvalid: "token_invalid";
+    readonly TokenMissing: "token_missing";
+    readonly AccountHeaderMissing: "account_header_missing";
+    readonly RefreshTokenInvalid: "refresh_token_invalid";
+    readonly EmailAlreadyVerified: "email_already_verified";
+    readonly EmailVerificationCodeInvalid: "email_verification_code_invalid";
+    readonly EmailVerificationCodeExpired: "email_verification_code_expired";
+    readonly EmailVerificationCodeUsed: "email_verification_code_used";
+    readonly EmailServiceUnavailable: "email_service_unavailable";
+    readonly PhoneAlreadyVerified: "phone_already_verified";
+    readonly PhoneVerificationCodeInvalid: "phone_verification_code_invalid";
+    readonly PhoneVerificationCodeExpired: "phone_verification_code_expired";
+    readonly PhoneVerificationCodeUsed: "phone_verification_code_used";
+    readonly PhoneNumberMissing: "phone_number_missing";
+    readonly SmsServiceUnavailable: "sms_service_unavailable";
+    readonly MfaAlreadyEnabled: "mfa_already_enabled";
+    readonly MfaNotEnabled: "mfa_not_enabled";
+    readonly MfaNotSetup: "mfa_not_setup";
+    readonly MfaCodeInvalid: "mfa_code_invalid";
+    readonly PasswordResetTokenInvalid: "password_reset_token_invalid";
+    readonly PasswordResetTokenExpired: "password_reset_token_expired";
+    readonly PasswordResetTokenUsed: "password_reset_token_used";
+    readonly PasswordCurrentIncorrect: "password_current_incorrect";
+    readonly PasswordSameAsCurrent: "password_same_as_current";
+    readonly InvalidOAuthState: "invalid_o_auth_state";
+    readonly OAuthProviderError: "o_auth_provider_error";
+    readonly OAuthAlreadyLinked: "o_auth_already_linked";
+    readonly ProviderAlreadyConnected: "provider_already_connected";
+    readonly OAuthNotLinked: "o_auth_not_linked";
+    readonly CannotUnlinkOnlyAuth: "cannot_unlink_only_auth";
+    readonly ValidationFailed: "validation_failed";
+    readonly BadRequest: "bad_request";
+    readonly InvalidJson: "invalid_json";
+    readonly ResourceNotFound: "resource_not_found";
+    readonly NotFound: "not_found";
+    readonly Forbidden: "forbidden";
+    readonly InsufficientPermissions: "insufficient_permissions";
+    readonly Conflict: "conflict";
+    readonly ResourceAlreadyExists: "resource_already_exists";
+    readonly InsufficientBalance: "insufficient_balance";
+    readonly PaymentRequired: "payment_required";
+    readonly SubscriptionRequired: "subscription_required";
+    readonly FeatureNotAvailable: "feature_not_available";
+    readonly PaymentFailed: "payment_failed";
+    readonly BusinessRuleViolation: "business_rule_violation";
+    readonly InvalidStateTransition: "invalid_state_transition";
+    readonly UnprocessableEntity: "unprocessable_entity";
+    readonly RateLimitExceeded: "rate_limit_exceeded";
+    readonly QueueFull: "queue_full";
+    readonly AssistantQuotaExceeded: "assistant_quota_exceeded";
+    readonly UserPhoneNotVerified: "user_phone_not_verified";
+    readonly PaymentMethodRequired: "payment_method_required";
+    readonly TrialAlreadyClaimed: "trial_already_claimed";
+    readonly PromotionNotEligible: "promotion_not_eligible";
+    readonly CouponNotFound: "coupon_not_found";
+    readonly CouponNotRedeemable: "coupon_not_redeemable";
+    readonly CouponAlreadyRedeemed: "coupon_already_redeemed";
+    readonly PhoneNumberNotActive: "phone_number_not_active";
+    readonly PhoneNumberNotVerified: "phone_number_not_verified";
+    readonly PhoneNumberCannotInitiateCalls: "phone_number_cannot_initiate_calls";
+    readonly FlowNotPublished: "flow_not_published";
+    readonly ProviderCallRejected: "provider_call_rejected";
+    readonly ConcurrentCallLimitExceeded: "concurrent_call_limit_exceeded";
+    readonly DailyCallLimitExceeded: "daily_call_limit_exceeded";
+    readonly ContactOnDncList: "contact_on_dnc_list";
+    readonly OutsideCallableHours: "outside_callable_hours";
+    readonly CallAlreadyCompleted: "call_already_completed";
+    readonly PhoneProviderNotActive: "phone_provider_not_active";
+    readonly PhoneNumberAlreadyConnected: "phone_number_already_connected";
+    readonly PhoneNumberNotConnected: "phone_number_not_connected";
+    readonly ProviderMustBeSip: "provider_must_be_sip";
+    readonly VerificationOnlyForSip: "verification_only_for_sip";
+    readonly PhoneVerificationNotStarted: "phone_verification_not_started";
+    readonly TwilioCredentialsRequired: "twilio_credentials_required";
+    readonly ByocOnly: "byoc_only";
+    readonly PhoneAlreadyRegistered: "phone_already_registered";
+    readonly CannotDeleteSystemProvider: "cannot_delete_system_provider";
+    readonly FlowNameAlreadyExists: "flow_name_already_exists";
+    readonly FlowStructureInvalid: "flow_structure_invalid";
+    readonly FlowHasConnectedPhones: "flow_has_connected_phones";
+    readonly FlowVersionInvalid: "flow_version_invalid";
+    readonly FlowVersionConflict: "flow_version_conflict";
+    readonly FlowFunctionNameExists: "flow_function_name_exists";
+    readonly FlowFunctionNotFound: "flow_function_not_found";
+    readonly FlowGenerationFailed: "flow_generation_failed";
+    readonly PaymentMethodCardOnly: "payment_method_card_only";
+    readonly TemplateVariableResolutionFailed: "template_variable_resolution_failed";
+    readonly PhoneNumberInUse: "phone_number_in_use";
+    readonly MfaTokenInvalid: "mfa_token_invalid";
+    readonly InvalidIdFormat: "invalid_id_format";
+    readonly VerificationCodeInvalid: "verification_code_invalid";
+    readonly CannotDeleteHasDependencies: "cannot_delete_has_dependencies";
+    readonly ScheduleNotFound: "schedule_not_found";
+    readonly ScheduleAlreadyPaused: "schedule_already_paused";
+    readonly ScheduleNotPaused: "schedule_not_paused";
+    readonly InvalidCronExpression: "invalid_cron_expression";
+    readonly InvalidTimezone: "invalid_timezone";
+    readonly CampaignNotFound: "campaign_not_found";
+    readonly CampaignNotDraft: "campaign_not_draft";
+    readonly CampaignNoContacts: "campaign_no_contacts";
+    readonly LegalAcceptanceRequired: "legal_acceptance_required";
+    readonly InvitationNotFound: "invitation_not_found";
+    readonly InvitationNotPending: "invitation_not_pending";
+    readonly InvitationExpired: "invitation_expired";
+    readonly NotInvitationRecipient: "not_invitation_recipient";
+    readonly OrganizationSuspended: "organization_suspended";
+    readonly AlreadyOrganizationMember: "already_organization_member";
+    readonly ApiKeyInvalid: "api_key_invalid";
+    readonly ApiKeyExpired: "api_key_expired";
+    readonly ApiKeyRevoked: "api_key_revoked";
+    readonly ApiKeyNotAllowed: "api_key_not_allowed";
+    readonly ApiKeyInsufficientScope: "api_key_insufficient_scope";
+    readonly ApiKeyIpRestricted: "api_key_ip_restricted";
+    readonly ApiKeyLimitReached: "api_key_limit_reached";
+    readonly InternalError: "internal_error";
+    readonly ServiceError: "service_error";
+    readonly ServiceUnavailable: "service_unavailable";
+    readonly NoBotsAvailable: "no_bots_available";
+    readonly RegionSaturated: "region_saturated";
+    readonly RecordingNotAvailable: "recording_not_available";
+    readonly RecordingServiceNotConfigured: "recording_service_not_configured";
+    readonly MetaNotConfigured: "meta_not_configured";
+    readonly MetaPageAlreadyConnected: "meta_page_already_connected";
+    readonly MetaFormAlreadyMapped: "meta_form_already_mapped";
+    readonly MetaApiError: "meta_api_error";
+    readonly MetaLeadUnrecoverable: "meta_lead_unrecoverable";
+    readonly Unauthorized: "unauthorized";
+};
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];

package/dist/cjs/api/types/ErrorCode.js

@@ -0,0 +1,158 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorCode = void 0;
+/**
+ * Machine-readable error code for programmatic error handling
+ *
+ * All codes use `snake_case` format. Use the `code` field in error responses
+ * to handle specific error conditions in your application.
+ *
+ * Error categories by HTTP status:
+ *
+ * - **Authentication** (401): `invalid_credentials`, `token_expired`, `token_invalid`, `token_missing`
+ * - **Authorization** (403): `account_suspended`, `account_access_denied`, `forbidden`
+ * - **Validation** (400): `validation_failed`, `bad_request`, `invalid_json`
+ * - **Payment** (402): `insufficient_balance`, `payment_required`, `payment_failed`
+ * - **Conflicts** (409): `email_already_exists`, `phone_already_exists`, `conflict`
+ * - **Not Found** (404): `not_found`, `resource_not_found`, `schedule_not_found`
+ * - **Business Rules** (422): `concurrent_call_limit_exceeded`, `flow_not_published`, `invalid_state_transition`
+ * - **Rate Limiting** (429): `rate_limit_exceeded`, `queue_full`
+ * - **Server** (5xx): `internal_error`, `service_unavailable`, `service_error`
+ */
+exports.ErrorCode = {
+    InvalidCredentials: "invalid_credentials",
+    EmailAlreadyExists: "email_already_exists",
+    PhoneAlreadyExists: "phone_already_exists",
+    ContactPhoneAlreadyExists: "contact_phone_already_exists",
+    AccountSuspended: "account_suspended",
+    AccountAccessDenied: "account_access_denied",
+    TokenExpired: "token_expired",
+    TokenInvalid: "token_invalid",
+    TokenMissing: "token_missing",
+    AccountHeaderMissing: "account_header_missing",
+    RefreshTokenInvalid: "refresh_token_invalid",
+    EmailAlreadyVerified: "email_already_verified",
+    EmailVerificationCodeInvalid: "email_verification_code_invalid",
+    EmailVerificationCodeExpired: "email_verification_code_expired",
+    EmailVerificationCodeUsed: "email_verification_code_used",
+    EmailServiceUnavailable: "email_service_unavailable",
+    PhoneAlreadyVerified: "phone_already_verified",
+    PhoneVerificationCodeInvalid: "phone_verification_code_invalid",
+    PhoneVerificationCodeExpired: "phone_verification_code_expired",
+    PhoneVerificationCodeUsed: "phone_verification_code_used",
+    PhoneNumberMissing: "phone_number_missing",
+    SmsServiceUnavailable: "sms_service_unavailable",
+    MfaAlreadyEnabled: "mfa_already_enabled",
+    MfaNotEnabled: "mfa_not_enabled",
+    MfaNotSetup: "mfa_not_setup",
+    MfaCodeInvalid: "mfa_code_invalid",
+    PasswordResetTokenInvalid: "password_reset_token_invalid",
+    PasswordResetTokenExpired: "password_reset_token_expired",
+    PasswordResetTokenUsed: "password_reset_token_used",
+    PasswordCurrentIncorrect: "password_current_incorrect",
+    PasswordSameAsCurrent: "password_same_as_current",
+    InvalidOAuthState: "invalid_o_auth_state",
+    OAuthProviderError: "o_auth_provider_error",
+    OAuthAlreadyLinked: "o_auth_already_linked",
+    ProviderAlreadyConnected: "provider_already_connected",
+    OAuthNotLinked: "o_auth_not_linked",
+    CannotUnlinkOnlyAuth: "cannot_unlink_only_auth",
+    ValidationFailed: "validation_failed",
+    BadRequest: "bad_request",
+    InvalidJson: "invalid_json",
+    ResourceNotFound: "resource_not_found",
+    NotFound: "not_found",
+    Forbidden: "forbidden",
+    InsufficientPermissions: "insufficient_permissions",
+    Conflict: "conflict",
+    ResourceAlreadyExists: "resource_already_exists",
+    InsufficientBalance: "insufficient_balance",
+    PaymentRequired: "payment_required",
+    SubscriptionRequired: "subscription_required",
+    FeatureNotAvailable: "feature_not_available",
+    PaymentFailed: "payment_failed",
+    BusinessRuleViolation: "business_rule_violation",
+    InvalidStateTransition: "invalid_state_transition",
+    UnprocessableEntity: "unprocessable_entity",
+    RateLimitExceeded: "rate_limit_exceeded",
+    QueueFull: "queue_full",
+    AssistantQuotaExceeded: "assistant_quota_exceeded",
+    UserPhoneNotVerified: "user_phone_not_verified",
+    PaymentMethodRequired: "payment_method_required",
+    TrialAlreadyClaimed: "trial_already_claimed",
+    PromotionNotEligible: "promotion_not_eligible",
+    CouponNotFound: "coupon_not_found",
+    CouponNotRedeemable: "coupon_not_redeemable",
+    CouponAlreadyRedeemed: "coupon_already_redeemed",
+    PhoneNumberNotActive: "phone_number_not_active",
+    PhoneNumberNotVerified: "phone_number_not_verified",
+    PhoneNumberCannotInitiateCalls: "phone_number_cannot_initiate_calls",
+    FlowNotPublished: "flow_not_published",
+    ProviderCallRejected: "provider_call_rejected",
+    ConcurrentCallLimitExceeded: "concurrent_call_limit_exceeded",
+    DailyCallLimitExceeded: "daily_call_limit_exceeded",
+    ContactOnDncList: "contact_on_dnc_list",
+    OutsideCallableHours: "outside_callable_hours",
+    CallAlreadyCompleted: "call_already_completed",
+    PhoneProviderNotActive: "phone_provider_not_active",
+    PhoneNumberAlreadyConnected: "phone_number_already_connected",
+    PhoneNumberNotConnected: "phone_number_not_connected",
+    ProviderMustBeSip: "provider_must_be_sip",
+    VerificationOnlyForSip: "verification_only_for_sip",
+    PhoneVerificationNotStarted: "phone_verification_not_started",
+    TwilioCredentialsRequired: "twilio_credentials_required",
+    ByocOnly: "byoc_only",
+    PhoneAlreadyRegistered: "phone_already_registered",
+    CannotDeleteSystemProvider: "cannot_delete_system_provider",
+    FlowNameAlreadyExists: "flow_name_already_exists",
+    FlowStructureInvalid: "flow_structure_invalid",
+    FlowHasConnectedPhones: "flow_has_connected_phones",
+    FlowVersionInvalid: "flow_version_invalid",
+    FlowVersionConflict: "flow_version_conflict",
+    FlowFunctionNameExists: "flow_function_name_exists",
+    FlowFunctionNotFound: "flow_function_not_found",
+    FlowGenerationFailed: "flow_generation_failed",
+    PaymentMethodCardOnly: "payment_method_card_only",
+    TemplateVariableResolutionFailed: "template_variable_resolution_failed",
+    PhoneNumberInUse: "phone_number_in_use",
+    MfaTokenInvalid: "mfa_token_invalid",
+    InvalidIdFormat: "invalid_id_format",
+    VerificationCodeInvalid: "verification_code_invalid",
+    CannotDeleteHasDependencies: "cannot_delete_has_dependencies",
+    ScheduleNotFound: "schedule_not_found",
+    ScheduleAlreadyPaused: "schedule_already_paused",
+    ScheduleNotPaused: "schedule_not_paused",
+    InvalidCronExpression: "invalid_cron_expression",
+    InvalidTimezone: "invalid_timezone",
+    CampaignNotFound: "campaign_not_found",
+    CampaignNotDraft: "campaign_not_draft",
+    CampaignNoContacts: "campaign_no_contacts",
+    LegalAcceptanceRequired: "legal_acceptance_required",
+    InvitationNotFound: "invitation_not_found",
+    InvitationNotPending: "invitation_not_pending",
+    InvitationExpired: "invitation_expired",
+    NotInvitationRecipient: "not_invitation_recipient",
+    OrganizationSuspended: "organization_suspended",
+    AlreadyOrganizationMember: "already_organization_member",
+    ApiKeyInvalid: "api_key_invalid",
+    ApiKeyExpired: "api_key_expired",
+    ApiKeyRevoked: "api_key_revoked",
+    ApiKeyNotAllowed: "api_key_not_allowed",
+    ApiKeyInsufficientScope: "api_key_insufficient_scope",
+    ApiKeyIpRestricted: "api_key_ip_restricted",
+    ApiKeyLimitReached: "api_key_limit_reached",
+    InternalError: "internal_error",
+    ServiceError: "service_error",
+    ServiceUnavailable: "service_unavailable",
+    NoBotsAvailable: "no_bots_available",
+    RegionSaturated: "region_saturated",
+    RecordingNotAvailable: "recording_not_available",
+    RecordingServiceNotConfigured: "recording_service_not_configured",
+    MetaNotConfigured: "meta_not_configured",
+    MetaPageAlreadyConnected: "meta_page_already_connected",
+    MetaFormAlreadyMapped: "meta_form_already_mapped",
+    MetaApiError: "meta_api_error",
+    MetaLeadUnrecoverable: "meta_lead_unrecoverable",
+    Unauthorized: "unauthorized",
+};

package/dist/cjs/api/types/ErrorCodeEntry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Single error code entry in the catalog
+ */
+export interface ErrorCodeEntry {
+    /** Error category key for grouping */
+    category: string;
+    /** Display name for the category (e.g., "API Keys" not "api_keys") */
+    categoryTitle: string;
+    /** Error code in snake_case format */
+    code: string;
+    /** Detailed description of when and why this error occurs */
+    description: string;
+    /** HTTP status code returned with this error */
+    status: number;
+    /** Human-readable title */
+    title: string;
+}

package/dist/cjs/api/types/ErrorCodeEntry.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/ErrorReason.d.ts

@@ -0,0 +1,10 @@
+/** Machine-readable error reason for an import failure */
+export declare const ErrorReason: {
+    readonly InvalidPhoneFormat: "INVALID_PHONE_FORMAT";
+    readonly MissingRequiredField: "MISSING_REQUIRED_FIELD";
+    readonly EmailInvalidFormat: "EMAIL_INVALID_FORMAT";
+    readonly PhoneAlreadyExists: "PHONE_ALREADY_EXISTS";
+    readonly ParseError: "PARSE_ERROR";
+    readonly ValidationFailed: "VALIDATION_FAILED";
+};
+export type ErrorReason = (typeof ErrorReason)[keyof typeof ErrorReason];

package/dist/cjs/api/types/ErrorReason.js

@@ -0,0 +1,13 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorReason = void 0;
+/** Machine-readable error reason for an import failure */
+exports.ErrorReason = {
+    InvalidPhoneFormat: "INVALID_PHONE_FORMAT",
+    MissingRequiredField: "MISSING_REQUIRED_FIELD",
+    EmailInvalidFormat: "EMAIL_INVALID_FORMAT",
+    PhoneAlreadyExists: "PHONE_ALREADY_EXISTS",
+    ParseError: "PARSE_ERROR",
+    ValidationFailed: "VALIDATION_FAILED",
+};

package/dist/cjs/api/types/ErrorResponse.d.ts

@@ -0,0 +1,60 @@
+import type * as Talkif from "../index.js";
+/**
+ * Standardized error response returned by all API endpoints
+ *
+ * Every error from the API follows this consistent format:
+ *
+ * ```json
+ * {
+ *   "code": "email_already_exists",
+ *   "title": "Email Already Exists",
+ *   "status": 409,
+ *   "detail": "An account with this email already exists",
+ *   "requestId": "550e8400-e29b-41d4-a716-446655440000"
+ * }
+ * ```
+ *
+ * Validation errors include per-field details in the `errors` array:
+ *
+ * ```json
+ * {
+ *   "code": "validation_failed",
+ *   "title": "Validation Failed",
+ *   "status": 400,
+ *   "detail": "Request validation failed",
+ *   "requestId": "550e8400-e29b-41d4-a716-446655440000",
+ *   "errors": [
+ *     { "field": "email", "code": "invalid_format", "message": "Email format is invalid" }
+ *   ]
+ * }
+ * ```
+ *
+ * Rate limit errors include retry information in the `meta` object:
+ *
+ * ```json
+ * {
+ *   "code": "rate_limit_exceeded",
+ *   "title": "Rate Limit Exceeded",
+ *   "status": 429,
+ *   "detail": "Too many requests",
+ *   "requestId": "550e8400-e29b-41d4-a716-446655440000",
+ *   "meta": { "retryAfterSecs": 60 }
+ * }
+ * ```
+ */
+export interface ErrorResponse {
+    /** Machine-readable error code for programmatic handling */
+    code: Talkif.ErrorCode;
+    /** Human-readable detail message for this specific error instance */
+    detail: string;
+    /** Field-level validation errors, present when code is `validation_failed` */
+    errors?: (Talkif.FieldError[] | null) | undefined;
+    /** Additional context metadata (e.g., retryAfterSecs for rate limits) */
+    meta?: (Record<string, unknown> | null) | undefined;
+    /** Unique request identifier for debugging (also in X-Request-Id response header) */
+    requestId?: (string | null) | undefined;
+    /** HTTP status code (mirrors the response status line) */
+    status: number;
+    /** Human-readable title for the error category */
+    title: string;
+}

package/dist/cjs/api/types/ErrorResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/ExtractedCallerInfo.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Caller information extracted from the call transcript by AI analysis
+ */
+export interface ExtractedCallerInfo {
+    /** Caller's company or organization */
+    company?: (string | null) | undefined;
+    /** Caller's email address if provided */
+    email?: (string | null) | undefined;
+    /** Caller's name as mentioned during the conversation */
+    name?: (string | null) | undefined;
+    /** Caller's job title or role */
+    role?: (string | null) | undefined;
+}

package/dist/cjs/api/types/ExtractedCallerInfo.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/FieldError.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Individual field error for validation responses
+ *
+ * Appears in the `errors[]` array when `code` is `validation_failed`
+ *
+ * # Example
+ *
+ * ```json
+ * {
+ *   "field": "email",
+ *   "code": "invalid_format",
+ *   "message": "Email format is invalid"
+ * }
+ * ```
+ */
+export interface FieldError {
+    /** Specific error code for this field */
+    code: string;
+    /** The field name that failed validation */
+    field: string;
+    /** Human-readable error message */
+    message: string;
+}

package/dist/cjs/api/types/FieldError.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/FieldErrorCodeEntry.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Single field-level validation error code entry
+ */
+export interface FieldErrorCodeEntry {
+    /** Field error code in snake_case format */
+    code: string;
+    /** Detailed description of this validation error */
+    description: string;
+}

package/dist/cjs/api/types/FieldErrorCodeEntry.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/FlowChange.d.ts

@@ -0,0 +1,14 @@
+import type * as Talkif from "../index.js";
+/**
+ * A single flow change entry
+ */
+export interface FlowChange {
+    /** Type of change */
+    changeType: Talkif.FlowChangeType;
+    /** Specific sub-changes within a modified element */
+    details?: string[] | undefined;
+    /** ID of the affected agent or service */
+    elementId: string;
+    /** Human-readable label */
+    label: string;
+}

package/dist/cjs/api/types/FlowChange.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/FlowChangeType.d.ts

@@ -0,0 +1,9 @@
+/** Type of change detected */
+export declare const FlowChangeType: {
+    readonly AgentAdded: "agent_added";
+    readonly AgentRemoved: "agent_removed";
+    readonly AgentModified: "agent_modified";
+    readonly ServiceChanged: "service_changed";
+    readonly FlowSettingChanged: "flow_setting_changed";
+};
+export type FlowChangeType = (typeof FlowChangeType)[keyof typeof FlowChangeType];

package/dist/cjs/api/types/FlowChangeType.js

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowChangeType = void 0;
+/** Type of change detected */
+exports.FlowChangeType = {
+    AgentAdded: "agent_added",
+    AgentRemoved: "agent_removed",
+    AgentModified: "agent_modified",
+    ServiceChanged: "service_changed",
+    FlowSettingChanged: "flow_setting_changed",
+};

package/dist/cjs/api/types/FlowCostBreakdown.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Flow-level cost aggregation
+ */
+export interface FlowCostBreakdown {
+    /** Unique identifier of the flow */
+    flowId: string;
+    /** Flow display name */
+    flowName?: (string | null) | undefined;
+    /** Total cost in microcents */
+    totalMicrocents: number;
+    /** Total cost in USD */
+    totalUsd: number;
+}

package/dist/cjs/api/types/FlowCostBreakdown.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/FlowDefinition.d.ts

@@ -0,0 +1,19 @@
+import type * as Talkif from "../index.js";
+/**
+ * The canonical flow definition — single source of truth for flow logic,
+ * shared by the API and the visual builder.
+ *
+ * Visual nodes (LLM, TTS, STT, prompt, end_call) collapse into properties:
+ * - Service nodes -> `services.*`
+ * - Prompt nodes -> `agent.prompt`
+ * - Action nodes -> `agent.functions[]`
+ * - Edges are implicit — relationships expressed as data, not connections
+ */
+export interface FlowDefinition {
+    /** Node ID where execution begins (must reference a main_agent node) */
+    initialNode: string;
+    /** Agent nodes keyed by node ID (e.g., "main_agent_1", "billing_agent") */
+    nodes: Record<string, Talkif.AgentDefinition>;
+    /** Service provider configuration (LLM, TTS, STT) */
+    services: Talkif.ServiceDefinition;
+}

package/dist/cjs/api/types/FlowDefinition.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/FlowDetailResponse.d.ts

@@ -0,0 +1,54 @@
+import type * as Talkif from "../index.js";
+/**
+ * Flow detail response for API (includes full flow data)
+ *
+ * Returns definition + layout as the canonical format.
+ */
+export interface FlowDetailResponse {
+    /** Account that owns this flow */
+    accountId: string;
+    /** Custom analysis instructions appended to the base analysis prompt */
+    analysisInstructions?: (string | null) | undefined;
+    /** Call analysis behavior override: "use_account_default", "enabled", or "disabled" */
+    analysisOverride: string;
+    /** Phone numbers currently connected to this flow */
+    connectedPhones: Talkif.ConnectedPhoneSummary[];
+    /** Timestamp when the flow was created */
+    createdAt: string;
+    definition?: (Talkif.FlowDefinition | null) | undefined;
+    /** Description of the flow's purpose */
+    description?: (string | null) | undefined;
+    /** Unique identifier of the flow */
+    id: string;
+    /**
+     * Visual builder layout (positions, viewport, UI state). Opaque to the
+     * API: stored and returned as-is.
+     */
+    layout?: (Record<string, unknown> | null) | undefined;
+    maxCallDuration?: (Talkif.MaxCallDurationSettings | null) | undefined;
+    /** Display name of the flow */
+    name: string;
+    /** Timestamp when the flow was last published */
+    publishedAt?: (string | null) | undefined;
+    /** Recording behavior override: "use_account_default", "enabled", or "disabled" */
+    recordingOverride: string;
+    /** Current lifecycle status of the flow */
+    status: Talkif.FlowStatus;
+    /** User-defined tags for filtering and organization */
+    tags: string[];
+    /** Timestamp when the flow was last updated */
+    updatedAt: string;
+    userIdle?: (Talkif.UserIdleSettings | null) | undefined;
+    /** Current semantic version (X.Y.Z) */
+    version: string;
+    /** Available published versions (newest first) */
+    versions: Talkif.FlowVersionSummary[];
+    /** Whether voicemail detection is enabled (outbound Twilio calls only) */
+    voicemailEnabled: boolean;
+    /** Static voicemail message spoken verbatim (skips the composer LLM call) */
+    voicemailMessage?: (string | null) | undefined;
+    /** Instruction for composing the voicemail message (ignored if message is set) */
+    voicemailMessagePrompt?: (string | null) | undefined;
+    /** Seconds to wait after the callee stops speaking before leaving the message */
+    voicemailResponseDelaySecs?: (number | null) | undefined;
+}

package/dist/cjs/api/types/FlowDetailResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });