@nangohq/types 0.71.11 → 0.71.13

package/dist/account/acquisition.d.ts

@@ -0,0 +1,10 @@
+/** First observed website source. No user identity or full URLs. */
+export interface SignupAcquisition {
+    acquisition_utm_source?: string | undefined;
+    acquisition_utm_medium?: string | undefined;
+    acquisition_utm_campaign?: string | undefined;
+    acquisition_utm_content?: string | undefined;
+    acquisition_utm_term?: string | undefined;
+    acquisition_referring_domain?: string | undefined;
+    acquisition_landing_path?: string | undefined;
+}

package/dist/account/api.d.ts

@@ -3,6 +3,7 @@ import type { ApiEndpoint, ApiError } from '../api.js';
 import type { AuditPolicy } from '../audit-trail/event.js';
 import type { MFACredential } from '../mfa/credential.js';
 import type { ApiUser } from '../user/api.js';
+import type { SignupAcquisition } from './acquisition.js';
 export interface AccountApiKey {
     id: number;
     uuid: string;
@@ -57,6 +58,7 @@ export type PostSignup = ApiEndpoint<{
         password: string;
         token?: string | undefined;
         foundUs?: string | undefined;
+        acquisition?: SignupAcquisition | undefined;
     };
     Error: ApiError<'email_already_verified'> | ApiError<'error_creating_user'> | ApiError<'user_already_exists'> | ApiError<'error_creating_account'> | ApiError<'not_found'> | ApiError<'email_not_verified'>;
     Success: {
@@ -206,6 +208,7 @@ export type PostManagedSignup = ApiEndpoint<{
     Path: '/api/v1/account/managed/signup';
     Body: {
         provider: 'GoogleOAuth';
+        acquisition?: SignupAcquisition | undefined;
         token?: string | undefined;
         returnTo?: string | undefined;
     };

package/dist/agent/api.d.ts

@@ -3,7 +3,7 @@ import type { AuditPolicy } from '../audit-trail/event.js';
 import type { Tags } from '../db.js';
 import type { AgentSessionUnknownPinnedConnectionsPayload } from './connections.js';
 import type { AgentSessionCreateConnectionConfig, AgentSessionEndedReason } from './session.js';
-import type { AgentSessionToolsNotInToolsetPayload, AgentSessionUnknownIntegrationsPayload, AgentSessionUnknownToolsPayload, AgentSessionUnsupportedFunctionTypesPayload } from './toolset.js';
+import type { AgentSessionMcpServerStatus, AgentSessionToolsNotInToolsetPayload, AgentSessionUnknownIntegrationsPayload, AgentSessionUnknownToolsPayload, AgentSessionUnsupportedFunctionTypesPayload } from './toolset.js';
 export interface AgentSessionToolListInput {
     tools: string[];
 }
@@ -51,6 +51,7 @@ export interface AgentSessionToolsetSummary {
     connected: boolean;
     tools_pinned: number;
     tools_searchable: number;
+    mcp_server?: AgentSessionMcpServerStatus;
 }
 export interface AgentSessionMetaToolsSummary {
     nango_tool_search: boolean;
@@ -89,6 +90,14 @@ export type AgentSessionCreationErrorCode = 'ambiguous_connections' | 'unknown_p
  */
 export type AgentSessionCreationErrorPayload = AgentSessionAmbiguousConnectionsReply | AgentSessionUnknownPinnedConnectionsPayload | AgentSessionPinnedConnectionNotMatchedReply | AgentSessionUnknownIntegrationsPayload | AgentSessionUnknownToolsPayload | AgentSessionUnsupportedFunctionTypesPayload | AgentSessionToolsNotInToolsetPayload | AgentSessionUnknownMetaToolsPayload;
 export type PostAgentSessionsCreationError = ApiError<AgentSessionCreationErrorCode, undefined, AgentSessionCreationErrorPayload>;
+export interface ApiCreatedAgentSession {
+    session_id: string;
+    session_token: string;
+    mcp_url: string;
+    expires_at: string;
+    toolset: Record<string, AgentSessionToolsetSummary>;
+    meta_tools: AgentSessionMetaToolsSummary;
+}
 export type PostAgentSessions = ApiEndpoint<{
     Audit: AuditPolicy<'agent_session', 'created', 'environment'>;
     Method: 'POST';
@@ -96,14 +105,7 @@ export type PostAgentSessions = ApiEndpoint<{
     Body: PostAgentSessionsBody;
     Error: PostAgentSessionsCreationError;
     Success: {
-        data: {
-            session_id: string;
-            session_token: string;
-            mcp_url: string;
-            expires_at: string;
-            toolset: Record<string, AgentSessionToolsetSummary>;
-            meta_tools: AgentSessionMetaToolsSummary;
-        };
+        data: ApiCreatedAgentSession;
     };
 }>;
 export interface ApiTerminatedAgentSession {

package/dist/agent/playground.api.d.ts

@@ -0,0 +1,38 @@
+import type { ApiEndpoint, ApiError } from '../api.js';
+export interface AgentPlaygroundUsage {
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface AgentPlaygroundIntegrationSetup {
+    provider: string;
+    integrationId?: string;
+    outcome: 'created' | 'existing' | 'missing_credentials' | 'not_created';
+}
+export interface AgentPlaygroundMessageMetadata {
+    sessionId?: string;
+    sessionExpiresAt?: string;
+    hidden?: boolean;
+    connectedIntegrations?: string[];
+    starterProvider?: string;
+    integrationSetup?: AgentPlaygroundIntegrationSetup;
+    usage?: AgentPlaygroundUsage;
+}
+export type AgentPlaygroundErrorCode = 'feature_disabled' | 'session_creation_failed' | 'model_error' | 'too_many_request';
+export type PostAgentPlaygroundChat = ApiEndpoint<{
+    Audit: {
+        kind: 'no-audit';
+        reason: 'TODO: audit coverage pending';
+    };
+    Method: 'POST';
+    Path: '/api/v1/agent-playground/chat';
+    Querystring: {
+        env: string;
+    };
+    Body: {
+        sessionId?: string | undefined;
+        messages: unknown[];
+        timeZone?: string | undefined;
+    };
+    Success: Record<string, unknown>;
+    Error: ApiError<AgentPlaygroundErrorCode>;
+}>;

package/dist/agent/toolset.d.ts

@@ -8,14 +8,23 @@ export interface AgentSessionIntegrationPolicy {
 }
 export type AgentSessionToolsetPolicy = '*' | Readonly<Record<string, AgentSessionIntegrationPolicy>>;
 export type AgentSessionPinnedTools = Readonly<Record<string, readonly string[]>>;
+/** A tool the integration's MCP server listed when the session was created, as opposed to a deployed action. */
+export interface AgentSessionMcpToolDefinition {
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations?: Record<string, unknown>;
+}
 export interface AgentSessionCompiledTool {
     readonly name: string;
     readonly description: string;
+    readonly mcp?: AgentSessionMcpToolDefinition;
 }
+/** `unavailable` means the MCP server could not be listed, so the session carries none of its tools. */
+export type AgentSessionMcpServerStatus = 'available' | 'unavailable';
 export interface AgentSessionCompiledIntegration {
     readonly provider: string;
     readonly pinned: AgentSessionCompiledTool[];
     readonly searchable: AgentSessionCompiledTool[];
+    readonly mcpServer?: AgentSessionMcpServerStatus;
 }
 export type AgentSessionCompiledToolset = Record<string, AgentSessionCompiledIntegration>;
 export interface AgentSessionToolNames {

package/dist/api.endpoints.d.ts

@@ -3,6 +3,7 @@ import type { GetAsyncActionResult, GetPublicV1, PostInternalTriggerFunction, Po
 import type { PostImpersonate } from './admin/http.api.js';
 import type { DeleteAgentSession, PostAgentSessions } from './agent/api.js';
 import type { GetAgentSessionMcp, PostAgentSessionMcp } from './agent/mcp.api.js';
+import type { PostAgentPlaygroundChat } from './agent/playground.api.js';
 import type { EndpointMethod } from './api.js';
 import type { GetAuditTrail, GetAuditTrailExport } from './audit-trail/api.js';
 import type { PostPublicApiKeyAuthorization, PostPublicAwsSigV4Authorization, PostPublicBasicAuthorization, PostPublicBillAuthorization, PostPublicJwtAuthorization, PostPublicOauthOutboundAuthorization, PostPublicSignatureAuthorization, PostPublicTbaAuthorization, PostPublicTwoStepAuthorization, PostPublicUnauthenticatedAuthorization } from './auth/http.api.js';
@@ -17,7 +18,7 @@ import type { CreateApiKey, DeleteApiKey, DeleteEnvironment, DeletePublicApiKey,
 import type { PatchWebhook } from './environment/api/webhook.js';
 import type { PostEnvironmentVariables } from './environment/variable/api.js';
 import type { PatchFlowDisable, PatchFlowEnable, PatchFlowFrequency, PostPreBuiltDeploy, PutUpgradePreBuiltFlow } from './flow/http.api.js';
-import type { DeleteIntegrationFunction, DeletePublicIntegrationFunction, GetFunction, GetFunctionDeployment, GetFunctionDryrun, GetFunctionInvocation, GetFunctions, GetIntegrationFunction, GetIntegrationFunctions, GetIntegrationTemplates, GetProviderTemplates, GetPublicIntegrationFunction, GetPublicIntegrationFunctions, GetPublicProviderTemplates, PatchFunction, PostFunctionCompile, PostFunctionDeployment, PostFunctionDeploymentBundle, PostFunctionDeploymentBundlePreview, PostFunctionDeploymentResult, PostFunctionDryrun, PostFunctionDryrunResult, PostFunctionInvocation } from './functions/api.js';
+import type { DeleteFunctionVariant, DeleteIntegrationFunction, DeletePublicIntegrationFunction, GetFunction, GetFunctionDeployment, GetFunctionDryrun, GetFunctionInvocation, GetFunctions, GetIntegrationFunction, GetIntegrationFunctions, GetIntegrationTemplates, GetProviderTemplates, GetPublicIntegrationFunction, GetPublicIntegrationFunctions, GetPublicProviderTemplates, PatchConnectionFunction, PatchFunction, PatchFunctionVariant, PostFunctionCompile, PostFunctionDeployment, PostFunctionDeploymentBundle, PostFunctionDeploymentBundlePreview, PostFunctionDeploymentResult, PostFunctionDryrun, PostFunctionDryrunResult, PostFunctionInvocation, PostFunctionVariant } from './functions/api.js';
 import type { GetGettingStarted, PatchGettingStarted } from './gettingStarted/api.js';
 import type { DeleteIntegration, DeletePublicIntegration, GetFunctionCode, GetIntegration, GetIntegrationFlows, GetPublicFunctionCode, GetPublicIntegration, GetPublicListIntegrations, PatchIntegration, PatchPublicIntegration, PostIntegration, PostPublicIntegration, PostPublicQuickstartIntegration } from './integration/api.js';
 import type { DeleteInvite, GetInvite, PostInvite } from './invitations/api.js';
@@ -35,8 +36,8 @@ import type { GetConnectionSyncs, GetPublicSyncStatus, PostPublicSyncPause, Post
 import type { DeleteTeamUser, GetTeam, PatchTeamUser, PutTeam } from './team/api.js';
 import type { GetUser, PatchUser, PutUserPassword } from './user/api.js';
 import type { PostPublicWebhook } from './webhooks/http.api.js';
-export type PublicApiEndpoints = SetMetadata | UpdateMetadata | PostDeploy | PostDeployConfirmation | PostPublicTrigger | PostPublicTbaAuthorization | PostPublicJwtAuthorization | PostPublicUnauthenticatedAuthorization | PostPublicApiKeyAuthorization | PostPublicBasicAuthorization | GetPublicProviders | GetPublicProvider | GetPublicListIntegrations | GetPublicIntegration | DeletePublicIntegration | PostConnectSessions | PostAgentSessions | DeleteAgentSession | PostAgentSessionMcp | GetAgentSessionMcp | PostPublicConnectSessionsReconnect | GetPublicConnections | GetPublicConnection | GetConnectSession | DeleteConnectSession | PostDeployInternal | PostPublicBillAuthorization | DeletePublicConnection | DeleteConnection | PostPublicSignatureAuthorization | PostPublicTwoStepAuthorization | PostPublicWebhook | GetPublicClientMetadata | GetPublicRecords | PatchPublicPruneRecords | GetPublicScriptsConfig | PostPublicConnectTelemetry | PostCliTelemetry | PutPublicSyncConnectionFrequency | PostPublicIntegration | PostPublicQuickstartIntegration | PatchPublicIntegration | GetAsyncActionResult | PostPublicOauthOutboundAuthorization | PostPublicAwsSigV4Authorization | PostPublicConnection | PatchPublicConnection | PostPublicSyncStart | PostPublicSyncPause | GetPublicSyncStatus | GetPublicV1 | PostPublicTriggerAction | PostFunctionCompile | GetFunction | GetFunctions | PatchFunction | PostFunctionDryrun | GetFunctionDryrun | PostFunctionDryrunResult | PostFunctionDeployment | GetFunctionDeployment | PostFunctionDeploymentResult | PostFunctionInvocation | GetFunctionInvocation | PostFunctionDeploymentBundle | PostFunctionDeploymentBundlePreview | GetPublicFunctionCode | GetPublicIntegrationFunctions | GetPublicIntegrationFunction | DeletePublicIntegrationFunction | GetPublicProviderTemplates | PostPublicRotateWebhookSigningKey | AllPublicProxy | PostPublicEnvironment | DeletePublicEnvironment | GetPublicEnvironments | GetPublicApiKey | GetPublicApiKeys | PostPublicApiKey | DeletePublicApiKey;
-export type PrivateApiEndpoints = GetAuditTrail | GetAuditTrailExport | ListAccountApiKeys | CreateAccountApiKey | DeleteAccountApiKey | ConfirmEmail | PostSignup | PostSignin | PostLogout | GetTeam | PutTeam | PostPlanExtendTrial | PostPlanChange | PutBillingInvoicingDetails | GetOverdueInvoices | GetBillingUsage | GetBillingUsageTopDimensionValues | GetUpcomingInvoice | GetBillingPeriodCosts | GetProjectedCosts | GetSpendAlert | PutSpendAlert | DeleteSpendAlert | GetUser | PatchUser | PutUserPassword | PostInvite | DeleteInvite | DeleteTeamUser | PatchTeamUser | PostInsights | PostForgotPassword | PutResetPassword | SearchOperations | GetOperation | SearchMessages | SearchFilters | PostInternalConnectSessions | GetIntegrationFlows | GetIntegrationFunction | GetIntegrationFunctions | GetFunctionCode | DeleteIntegrationFunction | GetIntegrationTemplates | GetProviderTemplates | DeleteIntegration | PatchIntegration | GetIntegration | PostIntegration | GetConnections | GetConnectionsCount | GetConnection | PatchConnection | PostConnectionMetadata | GetConnectionRecordModels | GetConnectionRecords | GetConnectionSyncs | GetInvite | GetMeta | GetEmailByExpiredToken | GetEmailByUuid | GetManagedCallback | GetManagedEmailVerification | GetOnboardingAccountDiscovery | PostOnboardingRequestInvite | PatchFlowDisable | PatchFlowEnable | PatchFlowFrequency | PutUpgradePreBuiltFlow | PostConnectionRefresh | PostManagedEmailVerification | PostManagedSignup | PostPreBuiltDeploy | PostEnvironment | PatchEnvironment | DeleteEnvironment | GetEnvironments | GetEnvironment | PostRotateWebhookSigningKey | ListApiKeys | CreateApiKey | DeleteApiKey | PatchApiKey | PatchWebhook | PostEnvironmentVariables | PostImpersonate | GetSharedCredentialsProviders | GetSharedCredentialsProvider | PostSharedCredentialsProvider | PatchSharedCredentialsProvider | GetGettingStarted | PatchGettingStarted | GetConnectUISettings | PutConnectUISettings | GetProviders | GetProvider | PostInternalTriggerFunction | GetMFAStatus | PostMFAEnrollment | PostMFAActivation | PostMFARecoveryCodes | PostMFALoginVerification | DeleteMFA | GetPlainHmac;
+export type PublicApiEndpoints = SetMetadata | UpdateMetadata | PostDeploy | PostDeployConfirmation | PostPublicTrigger | PostPublicTbaAuthorization | PostPublicJwtAuthorization | PostPublicUnauthenticatedAuthorization | PostPublicApiKeyAuthorization | PostPublicBasicAuthorization | GetPublicProviders | GetPublicProvider | GetPublicListIntegrations | GetPublicIntegration | DeletePublicIntegration | PostConnectSessions | PostAgentSessions | DeleteAgentSession | PostAgentSessionMcp | GetAgentSessionMcp | PostPublicConnectSessionsReconnect | GetPublicConnections | GetPublicConnection | GetConnectSession | DeleteConnectSession | PostDeployInternal | PostPublicBillAuthorization | DeletePublicConnection | DeleteConnection | PostPublicSignatureAuthorization | PostPublicTwoStepAuthorization | PostPublicWebhook | GetPublicClientMetadata | GetPublicRecords | PatchPublicPruneRecords | GetPublicScriptsConfig | PostPublicConnectTelemetry | PostCliTelemetry | PutPublicSyncConnectionFrequency | PostPublicIntegration | PostPublicQuickstartIntegration | PatchPublicIntegration | GetAsyncActionResult | PostPublicOauthOutboundAuthorization | PostPublicAwsSigV4Authorization | PostPublicConnection | PatchPublicConnection | PostPublicSyncStart | PostPublicSyncPause | GetPublicSyncStatus | GetPublicV1 | PostPublicTriggerAction | PostFunctionCompile | GetFunction | GetFunctions | PatchFunction | PostFunctionDryrun | GetFunctionDryrun | PostFunctionDryrunResult | PostFunctionDeployment | GetFunctionDeployment | PostFunctionDeploymentResult | PostFunctionInvocation | PostFunctionVariant | PatchFunctionVariant | PatchConnectionFunction | DeleteFunctionVariant | GetFunctionInvocation | PostFunctionDeploymentBundle | PostFunctionDeploymentBundlePreview | GetPublicFunctionCode | GetPublicIntegrationFunctions | GetPublicIntegrationFunction | DeletePublicIntegrationFunction | GetPublicProviderTemplates | PostPublicRotateWebhookSigningKey | AllPublicProxy | PostPublicEnvironment | DeletePublicEnvironment | GetPublicEnvironments | GetPublicApiKey | GetPublicApiKeys | PostPublicApiKey | DeletePublicApiKey;
+export type PrivateApiEndpoints = GetAuditTrail | GetAuditTrailExport | ListAccountApiKeys | CreateAccountApiKey | DeleteAccountApiKey | ConfirmEmail | PostSignup | PostSignin | PostLogout | GetTeam | PutTeam | PostPlanExtendTrial | PostPlanChange | PutBillingInvoicingDetails | GetOverdueInvoices | GetBillingUsage | GetBillingUsageTopDimensionValues | GetUpcomingInvoice | GetBillingPeriodCosts | GetProjectedCosts | GetSpendAlert | PutSpendAlert | DeleteSpendAlert | GetUser | PatchUser | PutUserPassword | PostInvite | DeleteInvite | DeleteTeamUser | PatchTeamUser | PostInsights | PostForgotPassword | PutResetPassword | SearchOperations | GetOperation | SearchMessages | SearchFilters | PostInternalConnectSessions | GetIntegrationFlows | GetIntegrationFunction | GetIntegrationFunctions | GetFunctionCode | DeleteIntegrationFunction | GetIntegrationTemplates | GetProviderTemplates | DeleteIntegration | PatchIntegration | GetIntegration | PostIntegration | GetConnections | GetConnectionsCount | GetConnection | PatchConnection | PostConnectionMetadata | GetConnectionRecordModels | GetConnectionRecords | GetConnectionSyncs | GetInvite | GetMeta | GetEmailByExpiredToken | GetEmailByUuid | GetManagedCallback | GetManagedEmailVerification | GetOnboardingAccountDiscovery | PostOnboardingRequestInvite | PatchFlowDisable | PatchFlowEnable | PatchFlowFrequency | PutUpgradePreBuiltFlow | PostConnectionRefresh | PostManagedEmailVerification | PostManagedSignup | PostPreBuiltDeploy | PostEnvironment | PatchEnvironment | DeleteEnvironment | GetEnvironments | GetEnvironment | PostRotateWebhookSigningKey | ListApiKeys | CreateApiKey | DeleteApiKey | PatchApiKey | PatchWebhook | PostEnvironmentVariables | PostImpersonate | GetSharedCredentialsProviders | GetSharedCredentialsProvider | PostSharedCredentialsProvider | PatchSharedCredentialsProvider | GetGettingStarted | PatchGettingStarted | GetConnectUISettings | PutConnectUISettings | GetProviders | GetProvider | PostInternalTriggerFunction | GetMFAStatus | PostMFAEnrollment | PostMFAActivation | PostMFARecoveryCodes | PostMFALoginVerification | DeleteMFA | GetPlainHmac | PostAgentPlaygroundChat;
 export type APIEndpoints = PrivateApiEndpoints | PublicApiEndpoints;
 /**
  * Automatically narrow endpoints type with Method + Path

package/dist/audit-trail/event.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSessionCreatedMetadata, ApiKeyUpdatedMetadata, AppAuthLoginMetadata, AuditTrailFiltersMetadata, AuditTrailQueriedMetadata, BillingPaymentMethodRemovedMetadata, BillingPlanChangedMetadata, BillingSpendAlertChangedMetadata, ConnectionMetadata, ConnectionUpdatedMetadata, EnvironmentCreatedMetadata, EnvironmentUpdatedMetadata, EnvironmentVariablesChangedMetadata, EnvironmentWebhookMetadata, FunctionDeletedMetadata, FunctionDeployedMetadata, FunctionUpdatedMetadata, FunctionUpgradedMetadata, IntegrationProviderMetadata, IntegrationUpdatedMetadata, MemberInvitedMetadata, MemberRoleChangedMetadata, MfaVerifiedMetadata, SyncBaseMetadata, SyncFrequencyChangedMetadata, SyncTriggeredMetadata, SyncVariantMetadata, TeamUpdatedMetadata, UserUpdatedMetadata } from './metadata.js';
+import type { AgentSessionCreatedMetadata, ApiKeyUpdatedMetadata, AppAuthLoginMetadata, AuditTrailFiltersMetadata, AuditTrailQueriedMetadata, BillingPaymentMethodRemovedMetadata, BillingPlanChangedMetadata, BillingSpendAlertChangedMetadata, ConnectionMetadata, ConnectionUpdatedMetadata, EnvironmentCreatedMetadata, EnvironmentUpdatedMetadata, EnvironmentVariablesChangedMetadata, EnvironmentWebhookMetadata, FunctionDeletedMetadata, FunctionDeployedMetadata, FunctionUpdatedMetadata, FunctionUpgradedMetadata, FunctionVariantMetadata, FunctionVariantSettingsMetadata, IntegrationProviderMetadata, IntegrationUpdatedMetadata, MemberInvitedMetadata, MemberRoleChangedMetadata, MfaVerifiedMetadata, SyncBaseMetadata, SyncFrequencyChangedMetadata, SyncTriggeredMetadata, SyncVariantMetadata, TeamUpdatedMetadata, UserUpdatedMetadata } from './metadata.js';
 export type AuditTrailVersion = '2026-07-16';
 export type AuditActorType = 'user' | 'api_key' | 'public_key' | 'connect_session' | 'anonymous' | 'unknown';
 export type AuditOutcome = 'success' | 'failure' | 'denied';
@@ -28,6 +28,9 @@ interface AuditEventTable {
         upgraded: FunctionUpgradedMetadata;
         updated: FunctionUpdatedMetadata;
         deleted: FunctionDeletedMetadata;
+        variant_created: FunctionVariantMetadata;
+        variant_deleted: FunctionVariantMetadata;
+        variant_updated: FunctionVariantSettingsMetadata;
     };
     integration: {
         created: IntegrationProviderMetadata;

package/dist/audit-trail/metadata.d.ts

@@ -54,6 +54,14 @@ export interface SyncFrequencyChangedMetadata extends SyncBaseMetadata {
 export interface SyncVariantMetadata extends SyncBaseMetadata {
     variant?: string;
 }
+export interface FunctionVariantMetadata {
+    connectionId?: string;
+    variant?: string;
+}
+export interface FunctionVariantSettingsMetadata extends FunctionVariantMetadata {
+    enabled?: boolean;
+    frequency?: string | null;
+}
 export interface SyncTriggeredMetadata extends SyncBaseMetadata {
     reset?: boolean;
     emptyCache?: boolean;

package/dist/billing/types.d.ts

@@ -24,7 +24,9 @@ export interface BillingClient {
         pendingChangeId: string;
         amountInCents: number | null;
     }>>;
-    downgrade: (opts: PlanChangeRequest) => Promise<Result<void>>;
+    downgrade: (opts: PlanChangeRequest) => Promise<Result<{
+        changeAt: Date | null;
+    }>>;
     startGrowthAddon: (opts: {
         subscriptionId: string;
     }) => Promise<Result<{

package/dist/cli/api.d.ts

@@ -1,5 +1,7 @@
 import type { ApiEndpoint } from '../api.js';
-export type CliTelemetryEvent = 'cli:init' | 'cli:create' | 'cli:compile' | 'cli:dev' | 'cli:dryrun' | 'cli:generate:docs' | 'cli:generate:tests' | 'cli:clone' | 'cli:migrate_to_zero_yaml' | 'cli:deploy' | 'cli:pull';
+export type CliTelemetryCommand = 'init' | 'create' | 'compile' | 'dev' | 'dryrun' | 'generate:docs' | 'generate:tests' | 'clone' | 'migrate-to-zero-yaml' | 'deploy' | 'pull';
+/** Released CLIs still send these, so the endpoint keeps accepting them. */
+export type LegacyCliTelemetryEvent = 'cli:init' | 'cli:create' | 'cli:compile' | 'cli:dev' | 'cli:dryrun' | 'cli:generate:docs' | 'cli:generate:tests' | 'cli:clone' | 'cli:migrate_to_zero_yaml' | 'cli:deploy' | 'cli:pull';
 export type PostCliTelemetry = ApiEndpoint<{
     Audit: {
         kind: 'no-audit';
@@ -9,8 +11,13 @@ export type PostCliTelemetry = ApiEndpoint<{
     Path: '/cli/telemetry';
     Body: {
         deviceId: string;
-        event: CliTelemetryEvent;
         ephemeral?: boolean;
-    };
+    } & ({
+        command: CliTelemetryCommand;
+        event?: never;
+    } | {
+        event: LegacyCliTelemetryEvent;
+        command?: never;
+    });
     Success: never;
 }>;

package/dist/flow/http.api.d.ts

@@ -80,7 +80,7 @@ export type PatchFlowDisable = ApiEndpoint<{
         scriptName: string;
         type: ScriptTypeLiteral;
     };
-    Error: ApiError<'unknown_provider'>;
+    Error: ApiError<'unknown_provider'> | ApiError<'unknown_sync_config'>;
     Success: {
         data: {
             success: boolean;

package/dist/function/config.d.ts

@@ -1,4 +1,5 @@
 import type { OnEventType } from '../scripts/on-events/api.js';
+export type FunctionTags = Record<string, string | string[]>;
 export interface FunctionCapabilities {
     usesRecords: boolean;
     usesOutbound: boolean;

package/dist/function/db.d.ts

@@ -1,6 +1,6 @@
 import type { TimestampsAndDeletedAt } from '../db.js';
 import type { FunctionSource } from '../syncConfigs/db.js';
-import type { FunctionCapabilities, FunctionLimits, FunctionRequires, FunctionTriggerDefinition } from './config.js';
+import type { FunctionCapabilities, FunctionLimits, FunctionRequires, FunctionTags, FunctionTriggerDefinition } from './config.js';
 import type { JSONSchema7 } from 'json-schema';
 export interface DBFunctionConfig extends TimestampsAndDeletedAt {
     id: number;
@@ -15,6 +15,7 @@ export interface DBFunctionConfigVersion extends TimestampsAndDeletedAt {
     id: number;
     function_config_id: number;
     description: string;
+    tags: FunctionTags;
     file_location: string;
     version: string;
     source: FunctionSource;

package/dist/functions/api.d.ts

@@ -1,6 +1,6 @@
 import type { ApiEndpoint, ApiError } from '../api.js';
 import type { AuditPolicy } from '../audit-trail/event.js';
-import type { FunctionCapabilities, FunctionLimits, FunctionRequires, FunctionTriggerDefinition } from '../function/config.js';
+import type { FunctionCapabilities, FunctionLimits, FunctionRequires, FunctionTags, FunctionTriggerDefinition } from '../function/config.js';
 import type { FunctionSource } from '../syncConfigs/db.js';
 import type { FunctionType, ListedNangoFunction, NangoActionFunction, NangoFunctionTemplate, NangoSyncFunction } from './domain.js';
 import type { JSONSchema7 } from 'json-schema';
@@ -229,6 +229,7 @@ export interface GetFunctionResponse {
     provider: string;
     name: string;
     description: string;
+    tags: FunctionTags;
     state: 'enabled' | 'disabled';
     source: FunctionSource;
     trigger: FunctionTriggerDefinition;
@@ -288,11 +289,12 @@ export type PostFunctionInvocation = ApiEndpoint<{
         reason: 'non-auditable';
     };
     Method: 'POST';
-    Path: '/functions/invocations';
+    Path: '/connections/:connectionId/functions/:functionUuid/invocations';
+    Params: {
+        connectionId: string;
+        functionUuid: string;
+    };
     Body: {
-        connection_id: string;
-        integration_id: string;
-        name: string;
         input?: unknown | undefined;
         invocation_type: FunctionInvocationType;
         options?: Record<string, unknown> | undefined;
@@ -300,17 +302,88 @@ export type PostFunctionInvocation = ApiEndpoint<{
     Error: ApiError<FunctionInvocationErrorCode>;
     Success: FunctionInvocationSuccess;
 }>;
+export type FunctionVariantErrorCode = 'invalid_variant' | 'function_not_found' | 'connection_not_found' | 'function_disabled' | 'function_variant_not_found' | 'invalid_frequency' | 'resource_capped' | 'server_error';
+export type FunctionVariantSuccess = {
+    function: {
+        uuid: string;
+        name: string;
+    };
+    variant: string;
+    frequency: string;
+    state: 'enabled' | 'disabled';
+};
+export type PostFunctionVariant = ApiEndpoint<{
+    Audit: AuditPolicy<'function', 'variant_created', 'environment'>;
+    Method: 'POST';
+    Path: '/connections/:connectionId/functions/:functionUuid/variants';
+    Params: {
+        connectionId: string;
+        functionUuid: string;
+    };
+    Body: {
+        variant: string;
+    };
+    Error: ApiError<FunctionVariantErrorCode>;
+    Success: FunctionVariantSuccess;
+}>;
+export type DeleteFunctionVariant = ApiEndpoint<{
+    Audit: AuditPolicy<'function', 'variant_deleted', 'environment'>;
+    Method: 'DELETE';
+    Path: '/connections/:connectionId/functions/:functionUuid/variants/:variant';
+    Params: {
+        connectionId: string;
+        functionUuid: string;
+        variant: string;
+    };
+    Error: ApiError<FunctionVariantErrorCode>;
+    Success: {
+        success: boolean;
+    };
+}>;
+export type PatchConnectionFunction = ApiEndpoint<{
+    Audit: AuditPolicy<'function', 'variant_updated', 'environment'>;
+    Method: 'PATCH';
+    Path: '/connections/:connectionId/functions/:functionUuid';
+    Params: {
+        connectionId: string;
+        functionUuid: string;
+    };
+    Body: PatchFunctionVariant['Body'];
+    Error: ApiError<FunctionVariantErrorCode>;
+    Success: FunctionVariantSuccess;
+}>;
+export type PatchFunctionVariant = ApiEndpoint<{
+    Audit: AuditPolicy<'function', 'variant_updated', 'environment'>;
+    Method: 'PATCH';
+    Path: '/connections/:connectionId/functions/:functionUuid/variants/:variant';
+    Params: {
+        connectionId: string;
+        functionUuid: string;
+        variant: string;
+    };
+    Body: {
+        enabled: boolean;
+        frequency?: string | null;
+    } | {
+        enabled?: boolean;
+        frequency: string | null;
+    };
+    Error: ApiError<FunctionVariantErrorCode>;
+    Success: FunctionVariantSuccess;
+}>;
 export type GetFunctionInvocation = ApiEndpoint<{
     Audit: {
         kind: 'no-audit';
         reason: 'non-auditable';
     };
     Method: 'GET';
-    Path: '/functions/invocations/:id';
+    Path: '/connections/:connectionId/functions/:functionUuid/invocations/:id';
     Params: {
+        connectionId: string;
+        functionUuid: string;
         id: string;
     };
-    Error: ApiError<'invalid_uri_params' | 'not_found' | 'function_failed' | 'server_error'>;
+    Error: ApiError<'invalid_uri_params' | 'not_found' | 'function_not_found' | 'connection_not_found' | 'function_failed' | 'server_error'>;
     Success: FunctionInvocationSuccess;
 }>;
 export interface FunctionListFilters {
@@ -478,6 +551,7 @@ export interface FunctionDeploymentArtifact {
     name: string;
     integrationId: string;
     description: string;
+    tags?: FunctionTags | undefined;
     trigger: FunctionTriggerDefinition;
     requires: FunctionRequires;
     capabilities: FunctionCapabilities;

package/dist/index.d.ts

@@ -15,11 +15,13 @@ export type * from './action/api.js';
 export type * from './agent/api.js';
 export type * from './agent/connections.js';
 export type * from './agent/mcp.api.js';
+export type * from './agent/playground.api.js';
 export type * from './agent/session.js';
 export type * from './agent/toolSearch.js';
 export type * from './agent/toolset.js';
 export type * from './admin/http.api.js';
 export type * from './account/api.js';
+export type * from './account/acquisition.js';
 export type * from './account/context.js';
 export type * from './user/api.js';
 export type * from './user/db.js';
@@ -96,6 +98,7 @@ export type * from './utils.js';
 export type * from './web/env.js';
 export type * from './fleet/api.js';
 export type * from './fleet/index.js';
+export type * from './internal-auth.js';
 export type * from './persist/api.js';
 export type * from './jobs/api.js';
 export type * from './checkpoint/types.js';

package/dist/integration/api.d.ts

@@ -325,6 +325,7 @@ export type PatchIntegration = ApiEndpoint<{
         webhookSecret?: string | undefined;
         displayName?: string | undefined;
         forward_webhooks?: boolean | undefined;
+        allow_unverified_webhooks?: boolean | undefined;
         integrationConfig?: Record<string, string> | undefined;
     } | IntegrationAuthBody;
     Success: {

package/dist/integration/db.d.ts

@@ -16,8 +16,9 @@ export interface IntegrationConfig extends TimestampsAndDeleted {
     missing_fields: string[];
     display_name: string | null;
     forward_webhooks: boolean;
+    allow_unverified_webhooks: boolean;
     shared_credentials_id: number | null;
 }
 export type DBIntegrationDecrypted = IntegrationConfig;
 export type DBIntegrationCrypted = Tagged<IntegrationConfig, 'IntegrationCrypted'>;
-export type DBCreateIntegration = SetOptional<NullablePartial<Omit<IntegrationConfig, 'created_at' | 'updated_at'>>, 'missing_fields'>;
+export type DBCreateIntegration = SetOptional<NullablePartial<Omit<IntegrationConfig, 'created_at' | 'updated_at'>>, 'missing_fields' | 'allow_unverified_webhooks'>;

package/dist/internal-auth.d.ts

@@ -0,0 +1,5 @@
+export interface InternalAuthPublicKey {
+    kid: string;
+    /** base64url of the raw 32-byte Ed25519 public key. */
+    publicKey: string;
+}

package/dist/meta/api.d.ts

@@ -1,10 +1,13 @@
+import type { SignupAcquisition } from '../account/acquisition.js';
 import type { ApiEndpoint, ApiError } from '../api.js';
 import type { DBEnvironment } from '../environment/db.js';
 export type ApiEnvironmentSummary = Pick<DBEnvironment, 'id' | 'account_id' | 'name' | 'is_production'>;
-export type AccountGroupProperties = {
+export type AccountGroupProperties = SignupAcquisition & {
     name?: string;
     plan?: string;
     created_date?: string;
+    is_internal?: boolean;
+    discovery_source?: string;
 };
 export type GetMeta = ApiEndpoint<{
     Audit: {
@@ -25,7 +28,9 @@ export type GetMeta = ApiEndpoint<{
             debugMode: boolean;
             gettingStartedClosed: boolean;
             auditTrail: boolean;
+            toolsCatalog: boolean;
             accountGroup: AccountGroupProperties;
+            agentPlayground: boolean;
         };
     };
 }>;

package/dist/plans/db.d.ts

@@ -149,6 +149,8 @@ export interface DBPlan extends Timestamps {
      * @default false
      */
     can_disable_connect_ui_watermark: boolean;
+    /** @default true */
+    has_overdue_invoices_banner: boolean;
     /**
      * Sync Function Runtime
      * @default "runner"

package/dist/plans/http.api.d.ts

@@ -1,4 +1,4 @@
-import type { ApiEndpoint } from '../api.js';
+import type { ApiEndpoint, ApiError } from '../api.js';
 import type { AuditPolicy } from '../audit-trail/event.js';
 import type { ApiBillingUsageMetrics, BillingCustomer, BillingInvoicingDetails, BreakdownDimensions } from '../billing/types.js';
 import type { MetricUsageSummary, UsageMetric } from '../usage/index.js';
@@ -248,6 +248,8 @@ export type GetSpendAlert = ApiEndpoint<{
              * or no Orb subscription yet; otherwise set even when the threshold is null.
              */
             currency: string | null;
+            /** A threshold has to be above this. Null when the plan gets no spend alerts. */
+            floorInCents: number | null;
         };
     };
 }>;
@@ -261,6 +263,7 @@ export type PutSpendAlert = ApiEndpoint<{
     Body: {
         thresholdInCents: number;
     };
+    Error: ApiError<'threshold_below_floor'>;
     Success: {
         data: {
             thresholdInCents: number;

package/dist/providers/provider.d.ts

@@ -83,10 +83,12 @@ export interface BaseProvider {
     authorization_code_param_in_webhook?: string;
     docs: string;
     docs_connect?: string;
+    mcp_endpoint?: string;
     setup_guide_url?: string;
     token_expiration_buffer?: number;
     webhook_routing_script?: string;
     webhook_user_defined_secret?: boolean;
+    webhook_signature_enforced?: boolean;
     webhook_allowed_query_params?: string[];
     post_connection_script?: string;
     pre_connection_deletion_script?: string;
@@ -100,6 +102,7 @@ export interface BaseProvider {
     authorization_url_fragment?: string;
     body_format?: OAuthBodyFormatType;
     require_client_certificate?: boolean;
+    allow_unverified_https?: boolean;
     token_request_auth_method?: 'basic' | 'custom' | 'private_key_jwt';
     available_scopes?: string[];
 }

package/dist/web/env.d.ts

@@ -8,6 +8,7 @@ export interface WindowEnv {
     publicUrl: string;
     connectUrl: string;
     gitHash: string | undefined;
+    environment: 'development' | 'staging' | 'production';
     publicSentryKey: string;
     publicPosthogKey: string;
     publicPosthogHost: string;

package/dist/webhooks/dispatch.d.ts

@@ -34,10 +34,9 @@ export interface LegacyDispatchMessage extends DispatchMessageBase {
 }
 export interface FunctionDispatchMessage extends DispatchMessageBase {
     kind: 'function';
-    functionConfigId: number;
+    functionUuid: string;
     /** Deterministic key used to deduplicate queue redeliveries. */
     idempotencyKey: string;
-    functionName: string;
     trigger: Omit<Extract<FunctionTrigger, {
         kind: 'http';
     }>, 'request' | 'connection'> & {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nangohq/types",
-    "version": "0.71.11",
+    "version": "0.71.13",
     "description": "Types used in Nango applications",
     "type": "module",
     "typings": "dist/index.d.ts",