@nangohq/types 0.71.12 → 0.71.14

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,8 +58,9 @@ 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'>;
+    Error: ApiError<'email_already_verified'> | ApiError<'error_creating_user'> | ApiError<'user_already_exists'> | ApiError<'error_creating_account'> | ApiError<'not_found'> | ApiError<'email_not_verified'> | ApiError<'disposable_email'>;
     Success: {
         data: {
             uuid: string;
@@ -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/account/signupAdvertising.d.ts

@@ -0,0 +1,8 @@
+/** Optional ad matching context on the existing new-account event. Never a group property. */
+export interface SignupAdvertising {
+    advertising_consent_method: 'explicit' | 'implied';
+    advertising_consent_timestamp: string;
+    advertising_oppref_click_timestamp?: string;
+    advertising_fbc?: string;
+    advertising_oppref?: string;
+}

package/dist/action/api.d.ts

@@ -28,7 +28,7 @@ export type PostPublicTriggerAction = ApiEndpoint<{
     Path: '/action/trigger';
     Body: {
         action_name: string;
-        input: unknown;
+        input?: unknown;
     };
     Headers: {
         'provider-config-key': string;
@@ -38,15 +38,15 @@ export type PostPublicTriggerAction = ApiEndpoint<{
     };
     Success: any;
 }>;
-export type PostInternalTriggerFunction = ApiEndpoint<{
+export type PostInternalInvokeFunction = ApiEndpoint<{
     Audit: {
         kind: 'no-audit';
-        reason: 'non-auditable';
+        reason: 'data-plane operation';
     };
     Method: 'POST';
-    Path: '/api/v1/trigger/function';
+    Path: '/api/v1/functions/invoke';
     Body: {
-        type: 'action' | 'sync';
+        type: 'action' | 'sync' | 'tool';
         function_name: string;
         provider_config_key: string;
         connection_id: string;

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

@@ -1,14 +1,42 @@
 import type { ApiEndpoint, ApiError } from '../api.js';
+import type { PostAgentSessionsBody } 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 type AgentPlaygroundSessionChange = 'integrations_changed' | 'connections_changed';
+export interface AgentPlaygroundSessionCreated {
+    request: PostAgentSessionsBody;
+    reason?: AgentPlaygroundSessionChange | 'expired';
+}
 export interface AgentPlaygroundMessageMetadata {
     sessionId?: string;
     hidden?: boolean;
+    connectedIntegrations?: string[];
+    starterProvider?: string;
+    integrationSetup?: AgentPlaygroundIntegrationSetup;
+    sessionCreated?: AgentPlaygroundSessionCreated;
     usage?: AgentPlaygroundUsage;
+    replyOutcome?: AgentPlaygroundReplyOutcome;
+}
+export type AgentPlaygroundReplyOutcome = {
+    kind: 'stopped';
+} | {
+    kind: 'failed';
+    error: string;
+};
+export type AgentPlaygroundErrorCode = 'feature_disabled' | 'session_creation_failed' | 'model_error' | 'model_unavailable' | 'too_many_request';
+export interface AgentPlaygroundModelUnavailableError {
+    error: {
+        code: 'model_unavailable';
+        retryable: boolean;
+    };
 }
-export type AgentPlaygroundErrorCode = 'feature_disabled' | 'session_creation_failed' | 'model_error';
 export type PostAgentPlaygroundChat = ApiEndpoint<{
     Audit: {
         kind: 'no-audit';
@@ -21,6 +49,7 @@ export type PostAgentPlaygroundChat = ApiEndpoint<{
     };
     Body: {
         sessionId?: string | undefined;
+        chatId?: string | undefined;
         messages: unknown[];
         timeZone?: string | undefined;
     };

package/dist/agent/session.d.ts

@@ -15,6 +15,16 @@ export interface AgentSessionMetaTools {
     readonly nangoProxy: boolean;
     readonly nangoCreateConnection: AgentSessionCreateConnectionConfig;
 }
+/** Nango's own tools, as opposed to the integration tools an account deploys. */
+export type AgentSessionMetaTool = 'nango_execute' | 'nango_proxy' | 'nango_tool_search' | 'nango_create_connection';
+/** One ranked tool, as the search returned it. Confidence runs from 0, nothing matched, to 1. */
+export interface AgentSessionToolSearchHit {
+    tool_name: string;
+    /** The name the agent was given for it, which collisions make impossible to derive afterwards. */
+    tool_slug: string;
+    integration_id: string;
+    confidence: number;
+}
 export type AgentSessionEndedReason = 'terminated' | 'expired';
 export interface AgentSession {
     readonly id: string;

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 {