@nangohq/types 0.72.1 → 0.72.3

package/dist/agent/toolset.d.ts

@@ -8,7 +8,7 @@ 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. */
+/** A tool the integration's MCP server listed, as opposed to a deployed action. */
 export interface AgentSessionMcpToolDefinition {
     readonly inputSchema: Record<string, unknown>;
     readonly annotations?: Record<string, unknown>;
@@ -17,14 +17,27 @@ export interface AgentSessionCompiledTool {
     readonly name: string;
     readonly description: string;
     readonly mcp?: AgentSessionMcpToolDefinition;
+    /**
+     * The name the session serves the tool under, stored only for a tool added after the session was
+     * created. The rest are named in a fixed order on every request, which a late tool would shift.
+     */
+    readonly slug?: string;
 }
 /** `unavailable` means the MCP server could not be listed, so the session carries none of its tools. */
 export type AgentSessionMcpServerStatus = 'available' | 'unavailable';
+/**
+ * An MCP server that was not connected when the session was created. It keeps the policy its tools go
+ * through once the agent connects it and the server is listed.
+ */
+export interface AgentSessionPendingMcpServer extends AgentSessionIntegrationPolicy {
+    readonly status: 'pending';
+    readonly pinnedNames: readonly string[];
+}
 export interface AgentSessionCompiledIntegration {
     readonly provider: string;
     readonly pinned: AgentSessionCompiledTool[];
     readonly searchable: AgentSessionCompiledTool[];
-    readonly mcpServer?: AgentSessionMcpServerStatus;
+    readonly mcpServer?: AgentSessionMcpServerStatus | AgentSessionPendingMcpServer;
 }
 export type AgentSessionCompiledToolset = Record<string, AgentSessionCompiledIntegration>;
 export interface AgentSessionToolNames {

package/dist/analytics/catalogue.d.ts

@@ -264,6 +264,59 @@ export declare const analyticsEventCatalogue: {
         readonly fires: "When someone clicks to set up their own integration at the end of Getting Started";
         readonly properties: z.ZodRecord<z.ZodString, z.ZodNever>;
     };
+    readonly 'onboarding:copy_prompt_button_click': {
+        readonly surface: "web";
+        readonly insight: "How many accounts start adding Nango to their own agent from Getting Started";
+        readonly fires: "When someone copies the install prompt for their agent on the Getting Started page";
+        readonly properties: z.ZodObject<{
+            has_api_key: z.ZodBoolean;
+        }, z.core.$strip>;
+    };
+    readonly 'onboarding:copy_api_key_button_click': {
+        readonly surface: "web";
+        readonly insight: "How often people need the API key on its own while installing Nango in their agent";
+        readonly fires: "When someone copies the API key on the Getting Started page";
+        readonly properties: z.ZodRecord<z.ZodString, z.ZodNever>;
+    };
+    readonly 'onboarding:playground_link_click': {
+        readonly surface: "web";
+        readonly insight: "How many accounts try the Agent Playground before installing Nango in their own agent";
+        readonly fires: "When someone follows the Agent Playground link on the Getting Started page";
+        readonly properties: z.ZodRecord<z.ZodString, z.ZodNever>;
+    };
+    readonly 'onboarding:try_prompt_button_click': {
+        readonly surface: "web";
+        readonly insight: "Which integrations people try first with their own agent";
+        readonly fires: "When someone copies an example prompt for their agent on the Getting Started page";
+        readonly properties: z.ZodObject<{
+            integration: z.ZodString;
+        }, z.core.$strip>;
+    };
+    readonly 'onboarding:go_further_link_click': {
+        readonly surface: "web";
+        readonly insight: "Where accounts go after finishing Getting Started";
+        readonly fires: "When someone opens a Go further link on the Getting Started page";
+        readonly properties: z.ZodObject<{
+            destination: z.ZodEnum<{
+                catalog: "catalog";
+                integrations: "integrations";
+                logs: "logs";
+                syncs_docs: "syncs_docs";
+            }>;
+        }, z.core.$strip>;
+    };
+    readonly 'onboarding:restart_button_click': {
+        readonly surface: "web";
+        readonly insight: "How often accounts start Getting Started over";
+        readonly fires: "When someone confirms restarting Getting Started";
+        readonly properties: z.ZodRecord<z.ZodString, z.ZodNever>;
+    };
+    readonly 'onboarding:dismiss_button_click': {
+        readonly surface: "web";
+        readonly insight: "How many accounts hide Getting Started";
+        readonly fires: "When someone hides Getting Started from the sidebar";
+        readonly properties: z.ZodRecord<z.ZodString, z.ZodNever>;
+    };
     readonly 'connections:create_button_click': {
         readonly surface: "web";
         readonly insight: "How many people start creating a connection, and for which provider";
@@ -631,7 +684,7 @@ export declare const analyticsEventCatalogue: {
     };
     readonly 'agents:tool_call_complete': {
         readonly surface: "server";
-        readonly insight: "Which tools do agents call most, and which fail most often?";
+        readonly insight: "Which tools do agents call most, which fail most often, and what the agent was trying to get done with each call";
         readonly fires: "When a tool call in an agent session returns";
         readonly properties: z.ZodObject<{
             tool_name: z.ZodOptional<z.ZodString>;
@@ -640,6 +693,8 @@ export declare const analyticsEventCatalogue: {
             integration_id: z.ZodOptional<z.ZodString>;
             underlying_error_code: z.ZodOptional<z.ZodString>;
             is_mcp_tool: z.ZodOptional<z.ZodBoolean>;
+            goal: z.ZodOptional<z.ZodString>;
+            intent: z.ZodOptional<z.ZodString>;
             is_success: z.ZodBoolean;
             log_operation_id: z.ZodOptional<z.ZodString>;
             error_code: z.ZodOptional<z.ZodString>;
@@ -667,10 +722,11 @@ export declare const analyticsEventCatalogue: {
     };
     readonly 'agents:tool_search_complete': {
         readonly surface: "server";
-        readonly insight: "How often does tool search return a tool the agent then uses?";
+        readonly insight: "How often does tool search return a tool the agent then uses, read against the task the agent was searching for";
         readonly fires: "When a tool search in an agent session returns";
         readonly properties: z.ZodObject<{
             query: z.ZodOptional<z.ZodString>;
+            goal: z.ZodOptional<z.ZodString>;
             match_count: z.ZodNumber;
             related_count: z.ZodNumber;
             top_match_confidence: z.ZodOptional<z.ZodNumber>;

package/dist/api-keys/scopes.d.ts

@@ -4,7 +4,7 @@ export declare const API_KEY_SCOPES: readonly ["environment:integrations:list",
 export type ConcreteApiKeyScope = (typeof API_KEY_SCOPES)[number];
 /** A scope, or a wildcard over scopes. Which wildcards resolve to something is checked at runtime. */
 export type ApiKeyScope = ConcreteApiKeyScope | WildcardsFor<'environment'>;
-export declare const ACCOUNT_API_KEY_SCOPES: readonly ["account:environments:list", "account:environments:read", "account:environments:read_secret", "account:environments:create", "account:environments:delete", "account:environments:set_production", "account:environments:api_keys:list", "account:environments:api_keys:read", "account:environments:api_keys:create", "account:environments:api_keys:update", "account:environments:api_keys:delete"];
+export declare const ACCOUNT_API_KEY_SCOPES: readonly ["account:environments:list", "account:environments:read", "account:environments:read_secret", "account:environments:update", "account:environments:create", "account:environments:delete", "account:environments:set_production", "account:environments:api_keys:list", "account:environments:api_keys:read", "account:environments:api_keys:create", "account:environments:api_keys:update", "account:environments:api_keys:delete"];
 export type ConcreteAccountApiKeyScope = (typeof ACCOUNT_API_KEY_SCOPES)[number];
 export type AccountApiKeyScope = ConcreteAccountApiKeyScope | WildcardsFor<'account'>;
 export type CustomerKeyScope = ApiKeyScope | AccountApiKeyScope;

package/dist/api.endpoints.d.ts

@@ -14,12 +14,12 @@ import type { DeleteConnection, DeletePublicConnection, GetConnection, GetConnec
 import type { PostConnectionMetadata, SetMetadata, UpdateMetadata } from './connection/api/metadata.js';
 import type { GetConnectUISettings, PutConnectUISettings } from './connectUISettings/api.js';
 import type { PostDeploy, PostDeployConfirmation, PostDeployInternal } from './deploy/api.js';
-import type { CreateApiKey, DeleteApiKey, DeleteEnvironment, DeletePublicApiKey, DeletePublicEnvironment, GetEnvironment, GetEnvironments, GetPublicApiKey, GetPublicApiKeys, GetPublicEnvironment, GetPublicEnvironments, ListApiKeys, PatchApiKey, PatchEnvironment, PatchPublicApiKey, PostEnvironment, PostPublicApiKey, PostPublicEnvironment, PostPublicRotateWebhookSigningKey, PostRotateWebhookSigningKey } from './environment/api/index.js';
+import type { CreateApiKey, DeleteApiKey, DeleteEnvironment, DeletePublicApiKey, DeletePublicEnvironment, GetEnvironment, GetEnvironments, GetPublicApiKey, GetPublicApiKeys, GetPublicEnvironment, GetPublicEnvironments, ListApiKeys, PatchApiKey, PatchEnvironment, PatchPublicApiKey, PatchPublicEnvironment, PostEnvironment, PostPublicApiKey, PostPublicEnvironment, PostPublicRotateWebhookSigningKey, PostRotateWebhookSigningKey } from './environment/api/index.js';
 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 { DeleteFunctionVariant, DeleteIntegrationFunction, DeletePublicIntegrationFunction, GetFunction, GetFunctionDeployment, GetFunctionDryrun, GetFunctionInvocation, GetFunctions, GetIntegrationFunction, GetIntegrationFunctions, GetIntegrationTemplates, GetProviderTemplateCode, GetProviderTemplates, GetPublicIntegrationFunction, GetPublicIntegrationFunctions, GetPublicProviderTemplateCode, GetPublicProviderTemplates, PatchConnectionFunction, PatchFunction, PatchFunctionVariant, PostFunctionCompile, PostFunctionDeployment, PostFunctionDeploymentBundle, PostFunctionDeploymentBundlePreview, PostFunctionDeploymentResult, PostFunctionDryrun, PostFunctionDryrunResult, PostFunctionInvocation, PostFunctionVariant, PostToolCall } from './functions/api.js';
-import type { GetGettingStarted, PatchGettingStarted } from './gettingStarted/api.js';
+import type { GetAgentGettingStarted, GetGettingStarted, PatchGettingStarted, PostAgentGettingStartedDismiss, PostAgentGettingStartedRestart } 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';
 import type { GetOperation, PostInsights, SearchFilters, SearchMessages, SearchOperations } from './logs/api.js';
@@ -37,8 +37,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 | PostConnectionToolsMcp | GetConnectionToolsMcp | 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 | PostToolCall | DeletePublicIntegrationFunction | GetPublicProviderTemplates | GetPublicProviderTemplateCode | PostPublicRotateWebhookSigningKey | AllPublicProxy | PostPublicEnvironment | DeletePublicEnvironment | GetPublicEnvironment | GetPublicEnvironments | GetPublicApiKey | GetPublicApiKeys | PostPublicApiKey | PatchPublicApiKey | 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 | GetProviderTemplateCode | 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 | PostInternalInvokeFunction | GetMFAStatus | PostMFAEnrollment | PostMFAActivation | PostMFARecoveryCodes | PostMFALoginVerification | DeleteMFA | GetPlainHmac | PostAgentPlaygroundChat;
+export type PublicApiEndpoints = SetMetadata | UpdateMetadata | PostDeploy | PostDeployConfirmation | PostPublicTrigger | PostPublicTbaAuthorization | PostPublicJwtAuthorization | PostPublicUnauthenticatedAuthorization | PostPublicApiKeyAuthorization | PostPublicBasicAuthorization | GetPublicProviders | GetPublicProvider | GetPublicListIntegrations | GetPublicIntegration | DeletePublicIntegration | PostConnectSessions | PostAgentSessions | DeleteAgentSession | PostAgentSessionMcp | GetAgentSessionMcp | PostConnectionToolsMcp | GetConnectionToolsMcp | 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 | PostToolCall | DeletePublicIntegrationFunction | GetPublicProviderTemplates | GetPublicProviderTemplateCode | PostPublicRotateWebhookSigningKey | AllPublicProxy | PostPublicEnvironment | PatchPublicEnvironment | DeletePublicEnvironment | GetPublicEnvironment | GetPublicEnvironments | GetPublicApiKey | GetPublicApiKeys | PostPublicApiKey | PatchPublicApiKey | 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 | GetProviderTemplateCode | 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 | GetAgentGettingStarted | PostAgentGettingStartedRestart | PostAgentGettingStartedDismiss | PatchGettingStarted | GetConnectUISettings | PutConnectUISettings | GetProviders | GetProvider | PostInternalInvokeFunction | GetMFAStatus | PostMFAEnrollment | PostMFAActivation | PostMFARecoveryCodes | PostMFALoginVerification | DeleteMFA | GetPlainHmac | PostAgentPlaygroundChat;
 export type APIEndpoints = PrivateApiEndpoints | PublicApiEndpoints;
 /**
  * Automatically narrow endpoints type with Method + Path

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

@@ -78,6 +78,8 @@ export interface UserUpdatedMetadata {
     gettingStartedClosed?: boolean;
 }
 export interface EnvironmentUpdatedMetadata {
+    primaryUrl?: string | null;
+    secondaryUrl?: string | null;
     name?: string;
     changedFields?: string[];
 }

package/dist/deploy/api.d.ts

@@ -1,5 +1,6 @@
 import type { ApiEndpoint, ApiError } from '../api.js';
 import type { AuditPolicy } from '../audit-trail/event.js';
+import type { FunctionReconciliationScope } from '../functions/api.js';
 import type { OnEventType } from '../scripts/on-events/api.js';
 import type { FunctionSource } from '../syncConfigs/db.js';
 import type { CLIDeployFlowConfig, OnEventScriptsByProvider } from './incomingFlow.js';
@@ -17,7 +18,9 @@ export type PostDeployConfirmation = ApiEndpoint<{
         onEventScriptsByProvider?: OnEventScriptsByProvider[] | undefined;
         reconcile: boolean;
         debug: boolean;
+        /** @deprecated Use reconciliationScope. */
         deployMode?: 'all' | 'single' | 'integration';
+        reconciliationScope?: FunctionReconciliationScope | undefined;
         /** @deprecated Use CLIDeployFlowConfig.models_json_schema */
         jsonSchema?: JSONSchema7 | undefined;
         sdkVersion?: string | undefined;
@@ -34,7 +37,9 @@ export type PostDeploy = ApiEndpoint<{
         nangoYamlBody: string;
         reconcile: boolean;
         debug: boolean;
+        /** @deprecated Use reconciliationScope. */
         deployMode?: 'all' | 'single' | 'integration';
+        reconciliationScope?: FunctionReconciliationScope | undefined;
         /** @deprecated Use CLIDeployFlowConfig.models_json_schema */
         jsonSchema?: JSONSchema7 | undefined;
         sdkVersion?: string | undefined;
@@ -58,7 +63,9 @@ export type PostDeployInternal = ApiEndpoint<{
         nangoYamlBody: string;
         reconcile: boolean;
         debug: boolean;
+        /** @deprecated Use reconciliationScope. */
         deployMode?: 'all' | 'single' | 'integration';
+        reconciliationScope?: FunctionReconciliationScope | undefined;
         /** @deprecated Use CLIDeployFlowConfig.models_json_schema */
         jsonSchema?: JSONSchema7 | undefined;
         sdkVersion?: string | undefined;

package/dist/environment/api/index.d.ts

@@ -4,6 +4,7 @@ import type { AuditPolicy } from '../../audit-trail/event.js';
 import type { ApiPlan } from '../../plans/http.api.js';
 import type { DBEnvironment, DBExternalWebhook } from '../db.js';
 import type { ApiEnvironmentVariable } from '../variable/api.js';
+import type { WebhookSettings } from './webhook.js';
 import type { Merge } from 'type-fest';
 export type ApiEnvironment = Merge<DBEnvironment, {
     callback_url: string;
@@ -94,17 +95,9 @@ export type PostPublicEnvironment = ApiEndpoint<{
             name: string;
             value: string;
         }[] | undefined;
-        webhooks?: {
-            primary_url?: string | undefined;
-            secondary_url?: string | undefined;
-            on_sync_completion_always?: boolean | undefined;
-            on_auth_creation?: boolean | undefined;
-            on_auth_refresh_error?: boolean | undefined;
-            on_sync_error?: boolean | undefined;
-            on_async_action_completion?: boolean | undefined;
-            on_connection_deletion?: boolean | undefined;
+        webhooks?: (WebhookSettings & {
             signing_key?: string | undefined;
-        } | undefined;
+        }) | undefined;
     };
     Success: {
         data: {
@@ -126,6 +119,30 @@ export type PostPublicEnvironment = ApiEndpoint<{
     };
     Error: ApiError<'conflict' | 'resource_capped' | 'invalid_is_prod_flag'>;
 }>;
+export type PatchPublicEnvironment = ApiEndpoint<{
+    Audit: AuditPolicy<'environment', 'updated', 'environment'>;
+    Method: 'PATCH';
+    Path: '/environments/:environmentUuid';
+    Params: {
+        environmentUuid: string;
+    };
+    Body: {
+        name?: string | undefined;
+        is_production?: boolean | undefined;
+        callback_url?: string | undefined;
+        slack_notifications?: boolean | undefined;
+        otlp_endpoint?: string | undefined;
+        otlp_headers?: {
+            name: string;
+            value: string;
+        }[] | undefined;
+        webhooks?: WebhookSettings | undefined;
+    };
+    Success: {
+        success: true;
+    };
+    Error: ApiError<'conflict' | 'cannot_change_prod_environment_name' | 'cannot_toggle_prod_environment'>;
+}>;
 export type DeletePublicEnvironment = ApiEndpoint<{
     Audit: AuditPolicy<'environment', 'deleted', 'account'>;
     Method: 'DELETE';
@@ -178,7 +195,7 @@ export type PatchEnvironment = ApiEndpoint<{
     Success: {
         data: ApiEnvironment;
     };
-    Error: ApiError<'conflict' | 'cannot_toggle_prod_environment'>;
+    Error: ApiError<'conflict' | 'cannot_change_prod_environment_name' | 'cannot_toggle_prod_environment'>;
 }>;
 export type DeleteEnvironment = ApiEndpoint<{
     Audit: AuditPolicy<'environment', 'deleted', 'environment'>;
@@ -202,6 +219,9 @@ export type PostPublicRotateWebhookSigningKey = ApiEndpoint<{
     Audit: AuditPolicy<'environment', 'webhook_signing_key_rotated', 'environment'>;
     Method: 'POST';
     Path: '/environment/webhook-signing-key/rotate';
+    Body: {
+        webhook_signing_key?: string | undefined;
+    };
     Success: {
         data: {
             webhook_signing_key: string;

package/dist/environment/api/webhook.d.ts

@@ -1,22 +1,23 @@
 import type { ApiEndpoint } from '../../api.js';
 import type { AuditPolicy } from '../../audit-trail/event.js';
+export interface WebhookSettings {
+    primary_url?: string | undefined;
+    secondary_url?: string | undefined;
+    on_sync_completion_always?: boolean | undefined;
+    on_auth_creation?: boolean | undefined;
+    on_auth_refresh_error?: boolean | undefined;
+    on_sync_error?: boolean | undefined;
+    on_async_action_completion?: boolean | undefined;
+    on_connection_deletion?: boolean | undefined;
+}
 export type PatchWebhook = ApiEndpoint<{
-    Audit: AuditPolicy<'environment', 'webhook_urls_changed', 'environment'>;
+    Audit: AuditPolicy<'environment', 'updated', 'environment'>;
     Method: 'PATCH';
     Querystring: {
         env: string;
     };
     Path: '/api/v1/environments/webhook';
-    Body: {
-        primary_url?: string | undefined;
-        secondary_url?: string | undefined;
-        on_sync_completion_always?: boolean | undefined;
-        on_auth_creation?: boolean | undefined;
-        on_auth_refresh_error?: boolean | undefined;
-        on_sync_error?: boolean | undefined;
-        on_async_action_completion?: boolean | undefined;
-        on_connection_deletion?: boolean | undefined;
-    };
+    Body: WebhookSettings;
     Success: {
         success: boolean;
     };

package/dist/functions/api.d.ts

@@ -102,6 +102,10 @@ export interface FunctionDeploymentCreateSuccess {
     status: FunctionDeploymentStatus;
     created_at: string;
 }
+export interface DeployedFunction {
+    name: string;
+    version?: string | undefined;
+}
 export interface FunctionDeploymentResultSuccess {
     id: string;
     status: FunctionDeploymentStatus;
@@ -114,10 +118,7 @@ export interface FunctionDeploymentResultSuccess {
     completed_at?: string | undefined;
     duration_ms?: number | undefined;
     deployed?: boolean | undefined;
-    deployed_functions?: {
-        name: string;
-        version: string;
-    }[] | undefined;
+    deployed_functions?: DeployedFunction[] | undefined;
     output?: string | undefined;
     error?: ApiError<FunctionErrorCode>['error'] | undefined;
 }
@@ -636,12 +637,17 @@ export interface FunctionDeploymentArtifact {
         js: string;
         ts: string;
     };
+    source: Exclude<FunctionSource, 'catalog'>;
 }
 export type FunctionReconciliationScope = {
     kind: 'environment';
 } | {
     kind: 'integration';
     integrationId: string;
+} | {
+    kind: 'function';
+    integrationId: string;
+    name: string;
 };
 export interface FunctionDeploymentBundleBody {
     reconciliationScope: FunctionReconciliationScope;

package/dist/gettingStarted/api.d.ts

@@ -29,3 +29,41 @@ export type PatchGettingStarted = ApiEndpoint<{
     Body: PatchGettingStartedProgressInput;
     Error: ApiError<'connection_not_found' | 'getting_started_progress_not_found' | 'failed_to_update_getting_started_progress'>;
 }>;
+export interface ApiAgentGettingStarted {
+    first_agent_connection_at: string | null;
+    first_tool_call_at: string | null;
+    dismissed_at: string | null;
+}
+export type GetAgentGettingStarted = ApiEndpoint<{
+    Audit: {
+        kind: 'no-audit';
+        reason: 'non-auditable';
+    };
+    Method: 'GET';
+    Path: '/api/v1/agent-getting-started';
+    Success: {
+        data: ApiAgentGettingStarted;
+    };
+}>;
+export type PostAgentGettingStartedRestart = ApiEndpoint<{
+    Audit: {
+        kind: 'no-audit';
+        reason: 'non-auditable';
+    };
+    Method: 'POST';
+    Path: '/api/v1/agent-getting-started/restart';
+    Success: {
+        data: ApiAgentGettingStarted;
+    };
+}>;
+export type PostAgentGettingStartedDismiss = ApiEndpoint<{
+    Audit: {
+        kind: 'no-audit';
+        reason: 'non-auditable';
+    };
+    Method: 'POST';
+    Path: '/api/v1/agent-getting-started/dismiss';
+    Success: {
+        data: ApiAgentGettingStarted;
+    };
+}>;

package/dist/gettingStarted/db.d.ts

@@ -8,6 +8,16 @@ export interface DBGettingStartedMeta extends Timestamps {
     environment_id: number;
     integration_id: number;
 }
+/**
+ * One per account. Progress of the agent-first getting started flow, shared by everyone in the account.
+ * Each timestamp is set the first time its event happens.
+ */
+export interface DBAccountGettingStarted extends Timestamps {
+    account_id: number;
+    first_agent_connection_at: Date | null;
+    first_tool_call_at: Date | null;
+    dismissed_at: Date | null;
+}
 /**
  * One per user. Holds progress for each user in the getting started flow.
  */

package/dist/index.d.ts

@@ -101,6 +101,7 @@ 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 './license.js';
 export type * from './persist/api.js';
 export type * from './jobs/api.js';
 export type * from './checkpoint/types.js';

package/dist/license.d.ts

@@ -0,0 +1,9 @@
+export interface License {
+    version: 1;
+    installation_id: string;
+    name: string;
+    issued_at: string;
+    expires_at: string;
+    grace_until: string;
+    telemetry: boolean;
+}

package/dist/meta/api.d.ts

@@ -27,6 +27,8 @@ export type GetMeta = ApiEndpoint<{
             baseUrl: string;
             debugMode: boolean;
             gettingStartedClosed: boolean;
+            /** Getting started was hidden for the whole account */
+            gettingStartedDismissed: boolean;
             auditTrail: boolean;
             toolsCatalog: boolean;
             accountGroup: AccountGroupProperties;

package/dist/providers/provider.d.ts

@@ -103,7 +103,7 @@ export interface BaseProvider {
     body_format?: OAuthBodyFormatType;
     require_client_certificate?: boolean;
     allow_unverified_https?: boolean;
-    token_request_auth_method?: 'basic' | 'custom' | 'private_key_jwt';
+    token_request_auth_method?: 'basic' | 'custom' | 'private_key_jwt' | 'none';
     available_scopes?: string[];
 }
 export interface ProviderOAuth2 extends BaseProvider {

package/dist/sharedCredentials/db.d.ts

@@ -11,4 +11,5 @@ export interface DBSharedCredentials extends Timestamps {
     id: number;
     name: string;
     credentials: SharedCredentials;
+    enabled: boolean;
 }

package/package.json

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