@nangohq/types 0.71.7 → 0.71.9

package/dist/agent/api.d.ts

@@ -1,4 +1,5 @@
 import type { ApiEndpoint, ApiError } from '../api.js';
+import type { AuditPolicy } from '../audit-trail/event.js';
 import type { Tags } from '../db.js';
 import type { AgentSessionUnknownPinnedConnectionsPayload } from './connections.js';
 import type { AgentSessionEndedReason } from './session.js';
@@ -69,10 +70,7 @@ 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 type PostAgentSessions = ApiEndpoint<{
-    Audit: {
-        kind: 'no-audit';
-        reason: 'TODO: audit coverage pending';
-    };
+    Audit: AuditPolicy<'agent_session', 'created', 'environment'>;
     Method: 'POST';
     Path: '/sessions';
     Body: PostAgentSessionsBody;
@@ -94,10 +92,7 @@ export interface ApiTerminatedAgentSession {
     reason: AgentSessionEndedReason;
 }
 export type DeleteAgentSession = ApiEndpoint<{
-    Audit: {
-        kind: 'no-audit';
-        reason: 'TODO: audit coverage pending';
-    };
+    Audit: AuditPolicy<'agent_session', 'terminated', 'environment'>;
     Method: 'DELETE';
     Path: '/sessions/:sessionId';
     Params: {

package/dist/agent/connections.d.ts

@@ -18,6 +18,7 @@ export interface AgentSessionResolvedConnection {
     readonly configId: number;
 }
 export type AgentSessionResolvedConnections = Record<string, AgentSessionResolvedConnection>;
+export type AgentSessionResolvedConnectionSummary = Omit<AgentSessionResolvedConnection, 'internalConnectionId' | 'configId'>;
 export type AgentSessionConnectionResolutionErrorCode = 'ambiguous_connections' | 'pinned_connection_not_matched' | 'unknown_pinned_connection';
 export interface AgentSessionConnectionCandidateReport {
     readonly connection_id: string;

package/dist/agent/toolset.d.ts

@@ -18,6 +18,11 @@ export interface AgentSessionCompiledIntegration {
     readonly searchable: AgentSessionCompiledTool[];
 }
 export type AgentSessionCompiledToolset = Record<string, AgentSessionCompiledIntegration>;
+export interface AgentSessionToolNames {
+    readonly provider: string;
+    readonly pinned: string[];
+    readonly searchable: string[];
+}
 export type AgentSessionToolsetCompilationErrorCode = 'unknown_integration' | 'unknown_tool' | 'unsupported_function_type' | 'tool_not_in_toolset';
 export interface AgentSessionUnknownIntegrationsPayload {
     readonly integrations: string[];

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

@@ -1,4 +1,4 @@
-import type { ApiKeyUpdatedMetadata, AppAuthLoginMetadata, AuditTrailFiltersMetadata, AuditTrailQueriedMetadata, BillingPaymentMethodRemovedMetadata, BillingPlanChangedMetadata, BillingSpendAlertChangedMetadata, ConnectionMetadata, ConnectionUpdatedMetadata, EnvironmentCreatedMetadata, EnvironmentUpdatedMetadata, EnvironmentVariablesChangedMetadata, EnvironmentWebhookMetadata, FunctionDeletedMetadata, FunctionDeployedMetadata, 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, FunctionUpgradedMetadata, 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';
@@ -87,6 +87,10 @@ interface AuditEventTable {
         exported: AuditTrailFiltersMetadata;
         queried: AuditTrailQueriedMetadata;
     };
+    agent_session: {
+        created: AgentSessionCreatedMetadata;
+        terminated: never;
+    };
 }
 export type AuditResource = keyof AuditEventTable;
 export type AuditActionOf<R extends AuditResource> = R extends AuditResource ? keyof AuditEventTable[R] & string : never;
@@ -97,7 +101,7 @@ export type AuditEventKey = {
 /** The metadata an action may carry. `never` for the actions that carry none. */
 export type AuditMetadataFor<R extends AuditResource, A> = A extends keyof AuditEventTable[R] ? AuditEventTable[R][A] : never;
 export type AuditScope = 'account' | 'environment';
-export type AuditTargetType = 'connection' | 'sync' | 'function' | 'integration' | 'api_key' | 'member' | 'team' | 'user' | 'environment';
+export type AuditTargetType = 'connection' | 'sync' | 'function' | 'integration' | 'api_key' | 'member' | 'team' | 'user' | 'environment' | 'agent_session';
 export interface AuditActor {
     type: AuditActorType;
     id: string;

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

@@ -97,3 +97,6 @@ export interface MfaVerifiedMetadata {
 export interface BillingSpendAlertChangedMetadata {
     thresholdInCents?: number;
 }
+export interface AgentSessionCreatedMetadata {
+    expiresAt?: string;
+}

package/dist/functions/api.d.ts

@@ -1,7 +1,7 @@
 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 { DeployedNangoFunction, FunctionType, NangoActionFunction, NangoFunctionTemplate, NangoSyncFunction } from './domain.js';
+import type { FunctionType, ListedNangoFunction, NangoActionFunction, NangoFunctionTemplate, NangoSyncFunction } from './domain.js';
 import type { JSONSchema7 } from 'json-schema';
 export type RunnableFunctionType = Extract<FunctionType, 'action' | 'sync'>;
 export type FunctionErrorCode = 'invalid_request' | 'server_error' | 'integration_not_found' | 'compilation_error' | 'dryrun_error' | 'deployment_error' | 'connection_not_found' | 'dryrun_not_found' | 'deployment_not_found' | 'function_disabled' | 'execution_environment_unavailable' | 'timeout' | 'validation_error';
@@ -262,15 +262,15 @@ export interface FunctionListFilters {
     limit?: number;
 }
 export interface FunctionListSuccess {
-    data: DeployedNangoFunction[];
+    data: ListedNangoFunction[];
     pagination: {
         total: number;
         page: number;
         limit: number;
     };
 }
-export interface DeployedFunctionSuccess {
-    data: DeployedNangoFunction;
+export interface ListedFunctionSuccess {
+    data: ListedNangoFunction;
 }
 export interface FunctionDeletionSuccess {
     data: {
@@ -310,7 +310,7 @@ export type GetIntegrationFunction = ApiEndpoint<{
         providerConfigKey: string;
         functionName: string;
     };
-    Success: DeployedFunctionSuccess;
+    Success: ListedFunctionSuccess;
 }>;
 export type DeleteIntegrationFunction = ApiEndpoint<{
     Audit: AuditPolicy<'function', 'deleted', 'environment'>;
@@ -370,7 +370,7 @@ export type GetPublicIntegrationFunction = ApiEndpoint<{
         uniqueKey: string;
         name: string;
     };
-    Success: DeployedFunctionSuccess;
+    Success: ListedFunctionSuccess;
 }>;
 export type DeletePublicIntegrationFunction = ApiEndpoint<{
     Audit: AuditPolicy<'function', 'deleted', 'environment'>;

package/dist/functions/domain.d.ts

@@ -28,18 +28,18 @@ export interface NangoOnEventFunction extends NangoFunctionBase {
     event: OnEventType;
 }
 export type NangoFunction = NangoSyncFunction | NangoActionFunction | NangoOnEventFunction;
-export interface DeployedMeta {
+export interface FunctionAvailability {
     id: number;
     enabled: boolean;
     /** ISO-8601 timestamp. */
     last_deployed: string;
     source: FunctionSource;
 }
-export type DeployedNangoSyncFunction = NangoSyncFunction & DeployedMeta;
-export type DeployedNangoActionFunction = NangoActionFunction & DeployedMeta;
-export type DeployedNangoOnEventFunction = NangoOnEventFunction & DeployedMeta;
-export type DeployedNangoFunction = DeployedNangoSyncFunction | DeployedNangoActionFunction | DeployedNangoOnEventFunction;
+export type ListedNangoSyncFunction = NangoSyncFunction & FunctionAvailability;
+export type ListedNangoActionFunction = NangoActionFunction & FunctionAvailability;
+export type ListedNangoOnEventFunction = NangoOnEventFunction & FunctionAvailability;
+export type ListedNangoFunction = ListedNangoSyncFunction | ListedNangoActionFunction | ListedNangoOnEventFunction;
 export type NangoFunctionTemplate = (NangoSyncFunction | NangoActionFunction) & {
-    deployed?: DeployedMeta;
+    deployed?: FunctionAvailability;
 };
 export {};

package/dist/integration/api.d.ts

@@ -239,6 +239,7 @@ export interface MCPOAuth2GenericAuthBody {
     clientName?: string | undefined;
     clientUri?: string | undefined;
     clientLogoUri?: string | undefined;
+    scopes?: string | undefined;
 }
 export interface InstallPluginAuthBody {
     authType: Extract<AuthModeType, 'INSTALL_PLUGIN'>;

package/dist/logs/api.d.ts

@@ -24,6 +24,7 @@ export type SearchOperations = ApiEndpoint<{
         integrations?: SearchOperationsIntegration[] | undefined;
         connections?: SearchOperationsConnection[] | undefined;
         syncs?: SearchOperationsSync[] | undefined;
+        agentSessions?: SearchOperationsAgentSession[] | undefined;
         period?: SearchPeriod | undefined;
         cursor?: string | null | undefined;
     };
@@ -40,6 +41,7 @@ export type SearchOperationsType = 'all' | ConcatOperationListWithGroup;
 export type SearchOperationsIntegration = 'all' | string;
 export type SearchOperationsConnection = 'all' | string;
 export type SearchOperationsSync = 'all' | string;
+export type SearchOperationsAgentSession = 'all' | string;
 export interface SearchPeriod {
     from: string;
     to: string;
@@ -102,7 +104,7 @@ export type SearchFilters = ApiEndpoint<{
         env: string;
     };
     Body: {
-        category: 'integration' | 'syncConfig' | 'connection';
+        category: SearchFiltersCategory;
         search?: string | undefined;
     };
     Success: {
@@ -112,6 +114,7 @@ export type SearchFilters = ApiEndpoint<{
         }[];
     };
 }>;
+export type SearchFiltersCategory = 'integration' | 'syncConfig' | 'connection' | 'agentSession';
 export type SearchFiltersData = SearchMessages['Success']['data'][0];
 export type PostInsights = ApiEndpoint<{
     Audit: {

package/dist/logs/messages.d.ts

@@ -58,7 +58,7 @@ export interface OperationDeploy {
 }
 export interface OperationAgentSession {
     type: 'agent_session';
-    action: 'create' | 'terminate';
+    action: 'create' | 'terminate' | 'tool_search';
 }
 export type OperationList = OperationFunction | OperationSync | OperationProxy | OperationAction | OperationWebhook | OperationOnEvents | OperationDeploy | OperationAuth | OperationAdmin | OperationAgentSession;
 /**

package/dist/plans/db.d.ts

@@ -12,6 +12,7 @@ export interface DBPlan extends Timestamps {
     orb_future_plan_at: Date | null;
     orb_subscribed_at: Date | null;
     has_growth_features: boolean;
+    growth_features_starts_at: Date | null;
     growth_features_ends_at: Date | null;
     trial_start_at: Date | null;
     trial_end_at: Date | null;
@@ -61,6 +62,11 @@ export interface DBPlan extends Timestamps {
      * @default null
      */
     function_logs_max: number | null;
+    /** Limit the amount of billable data transfer (in bytes) that can be used in a month
+     * Set to null to remove limit
+     * @default null
+     */
+    data_transfer_max: number | null;
     /**
      * Limit the number of environments that can be created
      * @default 2

package/dist/providers/provider.d.ts

@@ -141,6 +141,7 @@ export interface ProviderMcpOAUTH2 extends Omit<BaseProvider, 'body_format'> {
 }
 export interface ProviderMcpOAuth2Generic extends Omit<BaseProvider, 'body_format'> {
     auth_mode: 'MCP_OAUTH2_GENERIC';
+    mcp_server_url?: string;
 }
 export interface ProviderJwt extends BaseProvider {
     auth_mode: 'JWT';

package/package.json

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