@nangohq/types 0.71.13 → 0.72.0

package/dist/account/api.d.ts

@@ -60,7 +60,7 @@ export type PostSignup = ApiEndpoint<{
         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;

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/playground.api.d.ts

@@ -1,4 +1,5 @@
 import type { ApiEndpoint, ApiError } from '../api.js';
+import type { PostAgentSessionsBody } from './api.js';
 export interface AgentPlaygroundUsage {
     inputTokens: number;
     outputTokens: number;
@@ -8,16 +9,34 @@ export interface AgentPlaygroundIntegrationSetup {
     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;
-    sessionExpiresAt?: 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' | 'too_many_request';
 export type PostAgentPlaygroundChat = ApiEndpoint<{
     Audit: {
         kind: 'no-audit';
@@ -30,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;