@slates/provider 1.0.0-rc.27 → 1.0.0-rc.29

package/dist/index.d.cts

@@ -41,24 +41,35 @@ declare let createTextAttachment: (content: string, mimeType?: string, attachmen
  * the hub resolves these placeholders back to live secret values when it proxies an attachment.
  */
 declare let AUTH_CONFIG_SECRET_PLACEHOLDER_PREFIX: string;
+/** Decides whether an auth-config value (with its dotted path) may be replaced. */
+type AuthConfigSecretFilter = (secret: string, path: string) => boolean;
 /**
  * Maps auth-config string leaves to `$$MT$secret$authConfig$<path>` placeholders.
  * `redact` preserves whole-value substitution for HTTP traces; `redactEmbedded` also
  * replaces embedded values in attachment credentials, terminating those placeholders with `$$`.
+ * Both accept a `wholeValue` filter so diagnostics (traces, error text) can skip
+ * non-secret fields such as account IDs, emails, or subdomains; attachment callers keep
+ * the default, because the hub resolves every placeholder back to its value.
  */
 declare class AuthConfigSecretRedactor {
-    private readonly secretToPlaceholder;
+    private readonly secretToPaths;
     constructor(authConfig: Record<string, unknown> | undefined);
-    redact<T>(value: T): T;
-    redactEmbedded<T>(value: T): T;
+    redact<T>(value: T, wholeValue?: AuthConfigSecretFilter): T;
+    /**
+     * `embeddable` limits which secrets are also replaced inside longer strings;
+     * `wholeValue` limits which secrets replace a string that equals them exactly.
+     */
+    redactEmbedded<T>(value: T, embeddable?: AuthConfigSecretFilter, wholeValue?: AuthConfigSecretFilter): T;
+    private placeholderFor;
     private buildSecretMap;
     private transform;
     private isPlainObject;
 }
+declare let isUrlEmbeddedCredential: (secret: string, path: string) => boolean;
 /**
  * Applied to every finalized attachment list right before it's sent over
  * `slates/action.tool.invoke` (see @slates/provider-handler). Only `type: 'url'` attachments
- * carry headers/query -- content/upload_reference attachments pass through untouched.
+ * carry credentials -- content/upload_reference attachments pass through untouched.
  */
 declare let redactUrlAttachmentSecrets: (attachments: SlateAttachment[] | undefined, authConfig: Record<string, unknown> | undefined) => SlateAttachment[] | undefined;
 
@@ -523,6 +534,41 @@ type SlateTriggerGroupPollHandler<ConfigType extends {}, AuthType extends {}> =
     }[];
     updatedState?: any;
 }>;
+interface SlateGatewayEvent {
+    payload: any;
+    idempotencyKey?: string;
+}
+type SlateTriggerGroupGatewayConnectHandler<ConfigType extends {}, AuthType extends {}> = (context: SlateContext<ConfigType, AuthType, {
+    state: any | null;
+}>) => Promise<{
+    url: string;
+    state?: any;
+}>;
+/** `closed` is set, with no frames, when the socket closed unexpectedly. */
+type SlateTriggerGroupGatewayReceiveHandler<ConfigType extends {}, AuthType extends {}> = (context: SlateContext<ConfigType, AuthType, {
+    state: any | null;
+    frames: string[];
+    closed?: {
+        code: number;
+        reason: string;
+    } | null;
+}>) => Promise<{
+    state?: any;
+    send?: string[];
+    events?: SlateGatewayEvent[];
+    /** With `expectsAck`, the hub reconnects when no `heartbeatAcked` arrives before the next beat. */
+    heartbeat?: {
+        intervalMs: number;
+        frame: string;
+        expectsAck?: boolean;
+    } | null;
+    /** Set when `frames` included the provider's heartbeat acknowledgement. */
+    heartbeatAcked?: boolean;
+    close?: {
+        reconnect: boolean;
+        reason?: string;
+    } | null;
+}>;
 type SlateWebhookTargetListHandler<ConfigType extends {}, AuthType extends {}> = (context: SlateContext<ConfigType, AuthType, {
     pageToken: any | null;
 }>) => Promise<{
@@ -574,6 +620,10 @@ interface SlateTriggerGroupPollingParameters<ConfigType extends {}, AuthType ext
     intervalSeconds: number;
     pollEvents: SlateTriggerGroupPollHandler<ConfigType, AuthType>;
 }
+interface SlateTriggerGroupGatewayParameters<ConfigType extends {}, AuthType extends {}> {
+    connect: SlateTriggerGroupGatewayConnectHandler<ConfigType, AuthType>;
+    receive: SlateTriggerGroupGatewayReceiveHandler<ConfigType, AuthType>;
+}
 interface SlateTriggerGroupWebhookAutoRegistrationParameters<ConfigType extends {}, AuthType extends {}> {
     webhookTargetList: SlateWebhookTargetListHandler<ConfigType, AuthType>;
     webhookRegister: SlateWebhookRegisterHandler<ConfigType, AuthType>;
@@ -598,9 +648,10 @@ interface SlateTriggerGroupCreateParameters<InputType extends {} = Record<string
     eventSchema?: z$1.ZodType<InputType>;
 }
 interface SlateTriggerGroupParameters<ConfigType extends {}, AuthType extends {}, InputType extends {} = Record<string, unknown>> extends SlateTriggerGroupCreateParameters<InputType> {
-    source: 'polling' | 'webhook';
+    source: 'polling' | 'webhook' | 'gateway';
     polling?: SlateTriggerGroupPollingParameters<ConfigType, AuthType>;
     webhook?: SlateTriggerGroupWebhookParameters<ConfigType, AuthType>;
+    gateway?: SlateTriggerGroupGatewayParameters<ConfigType, AuthType>;
     routingMatchers: SlateTriggerGroupRoutingMatchersHandler<ConfigType, AuthType>;
 }
 declare class SlateTriggerGroup<ConfigType extends {}, AuthType extends {}, InputType extends {} = Record<string, unknown>> {
@@ -614,9 +665,10 @@ declare class SlateTriggerGroup<ConfigType extends {}, AuthType extends {}, Inpu
     get description(): string | undefined;
     get metadata(): Record<string, any> | undefined;
     get eventSchema(): z$1.ZodType<InputType, unknown, z$1.core.$ZodTypeInternals<InputType, unknown>>;
-    get source(): "polling" | "webhook";
+    get source(): "polling" | "webhook" | "gateway";
     get polling(): SlateTriggerGroupPollingParameters<ConfigType, AuthType> | undefined;
     get webhook(): SlateTriggerGroupWebhookParameters<ConfigType, AuthType> | undefined;
+    get gateway(): SlateTriggerGroupGatewayParameters<ConfigType, AuthType> | undefined;
     get routingMatchers(): SlateTriggerGroupRoutingMatchersHandler<ConfigType, AuthType>;
 }
 declare class SlateTriggerGroupBuilder<ConfigType extends {}, AuthType extends {}, InputType extends {} = Record<string, unknown>> {
@@ -634,6 +686,8 @@ declare class SlateTriggerGroupBuilder<ConfigType extends {}, AuthType extends {
         manualRegistration?: SlateTriggerGroupWebhookManualRegistrationParameters<UserConfigSchema, FullConfigSchema>;
         process: SlateWebhookProcessHandler;
     }): SlateTriggerGroupBuilder<ConfigType, AuthType, InputType>;
+    /** Receive events over a platform-managed persistent connection (e.g. a WebSocket gateway). */
+    gateway(props: SlateTriggerGroupGatewayParameters<ConfigType, AuthType>): SlateTriggerGroupBuilder<ConfigType, AuthType, InputType>;
     routingMatchers(handler: SlateTriggerGroupRoutingMatchersHandler<ConfigType, AuthType>): SlateTriggerGroupBuilder<ConfigType, AuthType, InputType>;
     build(): SlateTriggerGroup<ConfigType, AuthType, InputType>;
 }
@@ -887,6 +941,7 @@ type ApiErrorBuildHelpers = {
     collectDetails: (value: unknown, details: string[], options?: ApiErrorDetailOptions) => void;
     extractMessage: (error: unknown, options?: ApiErrorDetailOptions) => string;
     getResponse: (error: unknown) => ApiErrorResponse | undefined;
+    getResponseWithBody: (error: unknown) => ApiErrorResponse | undefined;
     getStatus: (error: unknown) => ApiErrorStatus | undefined;
     isRecord: (value: unknown) => value is Record<string, unknown>;
     statusLabelFor: (status?: ApiErrorStatus, statusText?: string) => string;
@@ -913,6 +968,25 @@ declare let isApiErrorRecord: (value: unknown) => value is Record<string, unknow
 declare let collectApiErrorDetails: (value: unknown, details: string[], options?: ApiErrorDetailOptions) => void;
 declare let getApiErrorResponse: (error: unknown) => ApiErrorResponse | undefined;
 declare let getApiErrorStatus: (error: unknown) => ApiErrorStatus | undefined;
+declare let getApiErrorResponseWithBody: (error: unknown) => ApiErrorResponse | undefined;
+declare let API_ERROR_MAX_DETAILS: number;
+declare let API_ERROR_MAX_MESSAGE_LENGTH: number;
+declare let API_ERROR_TRUNCATED_PLACEHOLDER: string;
+declare let looksLikeHtmlErrorBody: (value: string) => boolean;
+declare let truncateApiErrorMessage: (value: string, maxLength?: number) => string;
+type ApiErrorTextOptions = {
+    includeNumbers?: boolean;
+};
+declare let readApiErrorText: (value: unknown, options?: ApiErrorTextOptions) => string | undefined;
+type BoundedApiErrorDetailOptions = ApiErrorTextOptions & {
+    maxDetails?: number;
+    field?: string;
+};
+declare let pushBoundedApiErrorDetail: (details: string[], value: unknown, options?: BoundedApiErrorDetailOptions) => void;
+type DecodeApiErrorBodyOptions = {
+    maxBytes?: number;
+};
+declare let decodeApiErrorBody: (data: unknown, options?: DecodeApiErrorBodyOptions) => unknown;
 declare let statusLabelForApiError: (status?: ApiErrorStatus, statusText?: string) => string;
 declare let extractApiErrorMessage: (error: unknown, options?: ApiErrorDetailOptions & {
     response?: ApiErrorResponse;
@@ -923,7 +997,7 @@ declare let createApiServiceError: (message: string, options?: {
     upstreamCode?: string;
     parent?: unknown;
 }) => ServiceError<ErrorRecord<"bad_request", 400>>;
-declare let buildApiServiceError: (error: unknown, options: BuildApiServiceErrorOptions) => ServiceError<ErrorRecord<"bad_request", 400>>;
+declare let buildApiServiceError: (error: unknown, options: BuildApiServiceErrorOptions) => ServiceError<any>;
 
 declare class SlateError extends Error {
     cause?: unknown;
@@ -1094,4 +1168,4 @@ declare let skipWebhook: (reason: string, response?: Response | SlateWebhookHttp
     response: Response | SlateWebhookHttpResponseInit;
 };
 
-export { AUTH_CONFIG_SECRET_PLACEHOLDER_PREFIX, type ApiErrorBuildHelpers, type ApiErrorDetailOptions, type ApiErrorResponse, type ApiErrorStatus, type ApiServiceError, AuthConfigSecretRedactor, type BuildApiServiceErrorOptions, type CreateHmacSignatureOptions, GET_FILE_URL_TOOL_ID, type GetFileUrlHandler, type GetFileUrlToolInput, type GetFileUrlToolOutput, type NormalizeOAuthTokenResponseOptions, type OAuthExpiresAtOptions, type OAuthRefreshTokenFallbackMode, type OAuthTokenResponse, Slate, SlateAction, SlateActionBuilder, type SlateActionCreateParameters, type SlateActionDocsReference, type SlateActionParameters, type SlateActionParametersAny, type SlateActionParametersTool, type SlateActionParametersTrigger, type SlateActionScopeClause, type SlateActionScopeClauseInput, type SlateActionScopeValue, type SlateActionScopes, type SlateActionScopesInput, type SlateActionType, SlateAdapter, type SlateAdapterCapability, SlateAdapterSpec, type SlateAdapterSpecParameters, type SlateAddAttachmentContent, type SlateAddAttachmentInput, type SlateAttachment, type SlateAttachmentInlineContent, type SlateAttachmentUploadReferenceContent, type SlateAttachmentUrlContent, SlateAuth, type SlateAuthDocsReference, type SlateAuthType, type SlateAuthWithCustomData, type SlateAuthWithNone, type SlateAuthWithOauth, type SlateAuthWithServiceAccount, type SlateAuthWithToken, type SlateAuthenticatedAxiosDefaults, type SlateAxiosDefaults, type SlateAxiosErrorAdapter, type SlateAxiosErrorOptions, SlateConfig, type SlateConfigDocsReference, SlateContext, SlateDeclarationError, SlateDefaultPollingIntervalSeconds, type SlateDirectUploadInput, type SlateDocsReference, SlateError, type SlateErrorInput, type SlateErrorIssue, type SlateErrorKind, type SlateErrorProviderInfo, type SlateErrorResponse, type SlateErrorUpstreamInfo, type SlateLiveInvocationInfo, type SlateLogEntry, type SlateLogFields, type SlateLogListener, type SlateLogMessageInput, type SlateLogType, SlateLogger, type SlateProviderDocsReference, SlatePublicContext, SlatePublicTool, type SlatePublicToolInvocationHandler, type SlatePublicToolParameters, type SlateServiceErrorData, SlateSpecification, type SlateSpecificationCreateParameters, type SlateSpecificationParameters, SlateTool, type SlateToolInvocationHandler, type SlateToolParameters, SlateTrigger, SlateTriggerGroup, SlateTriggerGroupBuilder, type SlateTriggerGroupCreateParameters, type SlateTriggerGroupParameters, type SlateTriggerGroupPollHandler, type SlateTriggerGroupPollingParameters, type SlateTriggerGroupRoutingMatchersHandler, type SlateTriggerGroupWebhookAutoRegistrationParameters, type SlateTriggerGroupWebhookManualRegistrationParameters, type SlateTriggerGroupWebhookParameters, type SlateTriggerMappingHandler, type SlateTriggerMatchesHandler, type SlateTriggerParameters, type SlateTriggerRoutingMatcher, type SlateTypedDocsReference, type SlateWebhookHttpResponseInit, type SlateWebhookManualFinishHandler, type SlateWebhookManualSetupHandler, type SlateWebhookProcessHandler, type SlateWebhookRegisterHandler, type SlateWebhookSkipped, type SlateWebhookTarget, type SlateWebhookTargetListHandler, type SlateWebhookTargetOwnership, type SlateWebhookUnregisterHandler, type VerifyHmacSignatureOptions, adapterSpec, allOf, anyOf, auth, axios, buildApiServiceError, collectApiErrorDetails, config, createApiServiceError, createAuthenticatedAxios, createAxios, createBase64Attachment, createHmacSignature, createSlateError, createTextAttachment, createUrlAttachment, extractApiErrorMessage, getApiErrorResponse, getApiErrorStatus, getBase64ByteLength, getCurrentContext, getFileUrlTool, getFileUrlToolInputSchema, getFileUrlToolOutputSchema, getGraphWebhookValidationResponse, getMetaWebhookVerificationResponse, getOAuthExpiresAtFromExpiresIn, getResponseHeaderValue, getServiceErrorData, graphWebhookHttp, inferSlateErrorFromAxios, isApiErrorRecord, isAxiosErrorLike, isServiceErrorData, mapServiceErrorCode, mapServiceErrorToSlateErrorInput, mergeScopes, metaWebhookHttp, normalizeOAuthTokenResponse, pickDefined, publicTool, redactUrlAttachmentSecrets, requestAxios, requestAxiosData, runWithContext, scopeClause, setIfDefined, skipWebhook, spec, statusLabelForApiError, tool, trigger, triggerGroup, uploadAttachmentDirect, validateScopes, verifyHmacSignature };
+export { API_ERROR_MAX_DETAILS, API_ERROR_MAX_MESSAGE_LENGTH, API_ERROR_TRUNCATED_PLACEHOLDER, AUTH_CONFIG_SECRET_PLACEHOLDER_PREFIX, type ApiErrorBuildHelpers, type ApiErrorDetailOptions, type ApiErrorResponse, type ApiErrorStatus, type ApiErrorTextOptions, type ApiServiceError, type AuthConfigSecretFilter, AuthConfigSecretRedactor, type BoundedApiErrorDetailOptions, type BuildApiServiceErrorOptions, type CreateHmacSignatureOptions, type DecodeApiErrorBodyOptions, GET_FILE_URL_TOOL_ID, type GetFileUrlHandler, type GetFileUrlToolInput, type GetFileUrlToolOutput, type NormalizeOAuthTokenResponseOptions, type OAuthExpiresAtOptions, type OAuthRefreshTokenFallbackMode, type OAuthTokenResponse, Slate, SlateAction, SlateActionBuilder, type SlateActionCreateParameters, type SlateActionDocsReference, type SlateActionParameters, type SlateActionParametersAny, type SlateActionParametersTool, type SlateActionParametersTrigger, type SlateActionScopeClause, type SlateActionScopeClauseInput, type SlateActionScopeValue, type SlateActionScopes, type SlateActionScopesInput, type SlateActionType, SlateAdapter, type SlateAdapterCapability, SlateAdapterSpec, type SlateAdapterSpecParameters, type SlateAddAttachmentContent, type SlateAddAttachmentInput, type SlateAttachment, type SlateAttachmentInlineContent, type SlateAttachmentUploadReferenceContent, type SlateAttachmentUrlContent, SlateAuth, type SlateAuthDocsReference, type SlateAuthType, type SlateAuthWithCustomData, type SlateAuthWithNone, type SlateAuthWithOauth, type SlateAuthWithServiceAccount, type SlateAuthWithToken, type SlateAuthenticatedAxiosDefaults, type SlateAxiosDefaults, type SlateAxiosErrorAdapter, type SlateAxiosErrorOptions, SlateConfig, type SlateConfigDocsReference, SlateContext, SlateDeclarationError, SlateDefaultPollingIntervalSeconds, type SlateDirectUploadInput, type SlateDocsReference, SlateError, type SlateErrorInput, type SlateErrorIssue, type SlateErrorKind, type SlateErrorProviderInfo, type SlateErrorResponse, type SlateErrorUpstreamInfo, type SlateGatewayEvent, type SlateLiveInvocationInfo, type SlateLogEntry, type SlateLogFields, type SlateLogListener, type SlateLogMessageInput, type SlateLogType, SlateLogger, type SlateProviderDocsReference, SlatePublicContext, SlatePublicTool, type SlatePublicToolInvocationHandler, type SlatePublicToolParameters, type SlateServiceErrorData, SlateSpecification, type SlateSpecificationCreateParameters, type SlateSpecificationParameters, SlateTool, type SlateToolInvocationHandler, type SlateToolParameters, SlateTrigger, SlateTriggerGroup, SlateTriggerGroupBuilder, type SlateTriggerGroupCreateParameters, type SlateTriggerGroupGatewayConnectHandler, type SlateTriggerGroupGatewayParameters, type SlateTriggerGroupGatewayReceiveHandler, type SlateTriggerGroupParameters, type SlateTriggerGroupPollHandler, type SlateTriggerGroupPollingParameters, type SlateTriggerGroupRoutingMatchersHandler, type SlateTriggerGroupWebhookAutoRegistrationParameters, type SlateTriggerGroupWebhookManualRegistrationParameters, type SlateTriggerGroupWebhookParameters, type SlateTriggerMappingHandler, type SlateTriggerMatchesHandler, type SlateTriggerParameters, type SlateTriggerRoutingMatcher, type SlateTypedDocsReference, type SlateWebhookHttpResponseInit, type SlateWebhookManualFinishHandler, type SlateWebhookManualSetupHandler, type SlateWebhookProcessHandler, type SlateWebhookRegisterHandler, type SlateWebhookSkipped, type SlateWebhookTarget, type SlateWebhookTargetListHandler, type SlateWebhookTargetOwnership, type SlateWebhookUnregisterHandler, type VerifyHmacSignatureOptions, adapterSpec, allOf, anyOf, auth, axios, buildApiServiceError, collectApiErrorDetails, config, createApiServiceError, createAuthenticatedAxios, createAxios, createBase64Attachment, createHmacSignature, createSlateError, createTextAttachment, createUrlAttachment, decodeApiErrorBody, extractApiErrorMessage, getApiErrorResponse, getApiErrorResponseWithBody, getApiErrorStatus, getBase64ByteLength, getCurrentContext, getFileUrlTool, getFileUrlToolInputSchema, getFileUrlToolOutputSchema, getGraphWebhookValidationResponse, getMetaWebhookVerificationResponse, getOAuthExpiresAtFromExpiresIn, getResponseHeaderValue, getServiceErrorData, graphWebhookHttp, inferSlateErrorFromAxios, isApiErrorRecord, isAxiosErrorLike, isServiceErrorData, isUrlEmbeddedCredential, looksLikeHtmlErrorBody, mapServiceErrorCode, mapServiceErrorToSlateErrorInput, mergeScopes, metaWebhookHttp, normalizeOAuthTokenResponse, pickDefined, publicTool, pushBoundedApiErrorDetail, readApiErrorText, redactUrlAttachmentSecrets, requestAxios, requestAxiosData, runWithContext, scopeClause, setIfDefined, skipWebhook, spec, statusLabelForApiError, tool, trigger, triggerGroup, truncateApiErrorMessage, uploadAttachmentDirect, validateScopes, verifyHmacSignature };

package/dist/index.d.ts

@@ -41,24 +41,35 @@ declare let createTextAttachment: (content: string, mimeType?: string, attachmen
  * the hub resolves these placeholders back to live secret values when it proxies an attachment.
  */
 declare let AUTH_CONFIG_SECRET_PLACEHOLDER_PREFIX: string;
+/** Decides whether an auth-config value (with its dotted path) may be replaced. */
+type AuthConfigSecretFilter = (secret: string, path: string) => boolean;
 /**
  * Maps auth-config string leaves to `$$MT$secret$authConfig$<path>` placeholders.
  * `redact` preserves whole-value substitution for HTTP traces; `redactEmbedded` also
  * replaces embedded values in attachment credentials, terminating those placeholders with `$$`.
+ * Both accept a `wholeValue` filter so diagnostics (traces, error text) can skip
+ * non-secret fields such as account IDs, emails, or subdomains; attachment callers keep
+ * the default, because the hub resolves every placeholder back to its value.
  */
 declare class AuthConfigSecretRedactor {
-    private readonly secretToPlaceholder;
+    private readonly secretToPaths;
     constructor(authConfig: Record<string, unknown> | undefined);
-    redact<T>(value: T): T;
-    redactEmbedded<T>(value: T): T;
+    redact<T>(value: T, wholeValue?: AuthConfigSecretFilter): T;
+    /**
+     * `embeddable` limits which secrets are also replaced inside longer strings;
+     * `wholeValue` limits which secrets replace a string that equals them exactly.
+     */
+    redactEmbedded<T>(value: T, embeddable?: AuthConfigSecretFilter, wholeValue?: AuthConfigSecretFilter): T;
+    private placeholderFor;
     private buildSecretMap;
     private transform;
     private isPlainObject;
 }
+declare let isUrlEmbeddedCredential: (secret: string, path: string) => boolean;
 /**
  * Applied to every finalized attachment list right before it's sent over
  * `slates/action.tool.invoke` (see @slates/provider-handler). Only `type: 'url'` attachments
- * carry headers/query -- content/upload_reference attachments pass through untouched.
+ * carry credentials -- content/upload_reference attachments pass through untouched.
  */
 declare let redactUrlAttachmentSecrets: (attachments: SlateAttachment[] | undefined, authConfig: Record<string, unknown> | undefined) => SlateAttachment[] | undefined;
 
@@ -523,6 +534,41 @@ type SlateTriggerGroupPollHandler<ConfigType extends {}, AuthType extends {}> =
     }[];
     updatedState?: any;
 }>;
+interface SlateGatewayEvent {
+    payload: any;
+    idempotencyKey?: string;
+}
+type SlateTriggerGroupGatewayConnectHandler<ConfigType extends {}, AuthType extends {}> = (context: SlateContext<ConfigType, AuthType, {
+    state: any | null;
+}>) => Promise<{
+    url: string;
+    state?: any;
+}>;
+/** `closed` is set, with no frames, when the socket closed unexpectedly. */
+type SlateTriggerGroupGatewayReceiveHandler<ConfigType extends {}, AuthType extends {}> = (context: SlateContext<ConfigType, AuthType, {
+    state: any | null;
+    frames: string[];
+    closed?: {
+        code: number;
+        reason: string;
+    } | null;
+}>) => Promise<{
+    state?: any;
+    send?: string[];
+    events?: SlateGatewayEvent[];
+    /** With `expectsAck`, the hub reconnects when no `heartbeatAcked` arrives before the next beat. */
+    heartbeat?: {
+        intervalMs: number;
+        frame: string;
+        expectsAck?: boolean;
+    } | null;
+    /** Set when `frames` included the provider's heartbeat acknowledgement. */
+    heartbeatAcked?: boolean;
+    close?: {
+        reconnect: boolean;
+        reason?: string;
+    } | null;
+}>;
 type SlateWebhookTargetListHandler<ConfigType extends {}, AuthType extends {}> = (context: SlateContext<ConfigType, AuthType, {
     pageToken: any | null;
 }>) => Promise<{
@@ -574,6 +620,10 @@ interface SlateTriggerGroupPollingParameters<ConfigType extends {}, AuthType ext
     intervalSeconds: number;
     pollEvents: SlateTriggerGroupPollHandler<ConfigType, AuthType>;
 }
+interface SlateTriggerGroupGatewayParameters<ConfigType extends {}, AuthType extends {}> {
+    connect: SlateTriggerGroupGatewayConnectHandler<ConfigType, AuthType>;
+    receive: SlateTriggerGroupGatewayReceiveHandler<ConfigType, AuthType>;
+}
 interface SlateTriggerGroupWebhookAutoRegistrationParameters<ConfigType extends {}, AuthType extends {}> {
     webhookTargetList: SlateWebhookTargetListHandler<ConfigType, AuthType>;
     webhookRegister: SlateWebhookRegisterHandler<ConfigType, AuthType>;
@@ -598,9 +648,10 @@ interface SlateTriggerGroupCreateParameters<InputType extends {} = Record<string
     eventSchema?: z$1.ZodType<InputType>;
 }
 interface SlateTriggerGroupParameters<ConfigType extends {}, AuthType extends {}, InputType extends {} = Record<string, unknown>> extends SlateTriggerGroupCreateParameters<InputType> {
-    source: 'polling' | 'webhook';
+    source: 'polling' | 'webhook' | 'gateway';
     polling?: SlateTriggerGroupPollingParameters<ConfigType, AuthType>;
     webhook?: SlateTriggerGroupWebhookParameters<ConfigType, AuthType>;
+    gateway?: SlateTriggerGroupGatewayParameters<ConfigType, AuthType>;
     routingMatchers: SlateTriggerGroupRoutingMatchersHandler<ConfigType, AuthType>;
 }
 declare class SlateTriggerGroup<ConfigType extends {}, AuthType extends {}, InputType extends {} = Record<string, unknown>> {
@@ -614,9 +665,10 @@ declare class SlateTriggerGroup<ConfigType extends {}, AuthType extends {}, Inpu
     get description(): string | undefined;
     get metadata(): Record<string, any> | undefined;
     get eventSchema(): z$1.ZodType<InputType, unknown, z$1.core.$ZodTypeInternals<InputType, unknown>>;
-    get source(): "polling" | "webhook";
+    get source(): "polling" | "webhook" | "gateway";
     get polling(): SlateTriggerGroupPollingParameters<ConfigType, AuthType> | undefined;
     get webhook(): SlateTriggerGroupWebhookParameters<ConfigType, AuthType> | undefined;
+    get gateway(): SlateTriggerGroupGatewayParameters<ConfigType, AuthType> | undefined;
     get routingMatchers(): SlateTriggerGroupRoutingMatchersHandler<ConfigType, AuthType>;
 }
 declare class SlateTriggerGroupBuilder<ConfigType extends {}, AuthType extends {}, InputType extends {} = Record<string, unknown>> {
@@ -634,6 +686,8 @@ declare class SlateTriggerGroupBuilder<ConfigType extends {}, AuthType extends {
         manualRegistration?: SlateTriggerGroupWebhookManualRegistrationParameters<UserConfigSchema, FullConfigSchema>;
         process: SlateWebhookProcessHandler;
     }): SlateTriggerGroupBuilder<ConfigType, AuthType, InputType>;
+    /** Receive events over a platform-managed persistent connection (e.g. a WebSocket gateway). */
+    gateway(props: SlateTriggerGroupGatewayParameters<ConfigType, AuthType>): SlateTriggerGroupBuilder<ConfigType, AuthType, InputType>;
     routingMatchers(handler: SlateTriggerGroupRoutingMatchersHandler<ConfigType, AuthType>): SlateTriggerGroupBuilder<ConfigType, AuthType, InputType>;
     build(): SlateTriggerGroup<ConfigType, AuthType, InputType>;
 }
@@ -887,6 +941,7 @@ type ApiErrorBuildHelpers = {
     collectDetails: (value: unknown, details: string[], options?: ApiErrorDetailOptions) => void;
     extractMessage: (error: unknown, options?: ApiErrorDetailOptions) => string;
     getResponse: (error: unknown) => ApiErrorResponse | undefined;
+    getResponseWithBody: (error: unknown) => ApiErrorResponse | undefined;
     getStatus: (error: unknown) => ApiErrorStatus | undefined;
     isRecord: (value: unknown) => value is Record<string, unknown>;
     statusLabelFor: (status?: ApiErrorStatus, statusText?: string) => string;
@@ -913,6 +968,25 @@ declare let isApiErrorRecord: (value: unknown) => value is Record<string, unknow
 declare let collectApiErrorDetails: (value: unknown, details: string[], options?: ApiErrorDetailOptions) => void;
 declare let getApiErrorResponse: (error: unknown) => ApiErrorResponse | undefined;
 declare let getApiErrorStatus: (error: unknown) => ApiErrorStatus | undefined;
+declare let getApiErrorResponseWithBody: (error: unknown) => ApiErrorResponse | undefined;
+declare let API_ERROR_MAX_DETAILS: number;
+declare let API_ERROR_MAX_MESSAGE_LENGTH: number;
+declare let API_ERROR_TRUNCATED_PLACEHOLDER: string;
+declare let looksLikeHtmlErrorBody: (value: string) => boolean;
+declare let truncateApiErrorMessage: (value: string, maxLength?: number) => string;
+type ApiErrorTextOptions = {
+    includeNumbers?: boolean;
+};
+declare let readApiErrorText: (value: unknown, options?: ApiErrorTextOptions) => string | undefined;
+type BoundedApiErrorDetailOptions = ApiErrorTextOptions & {
+    maxDetails?: number;
+    field?: string;
+};
+declare let pushBoundedApiErrorDetail: (details: string[], value: unknown, options?: BoundedApiErrorDetailOptions) => void;
+type DecodeApiErrorBodyOptions = {
+    maxBytes?: number;
+};
+declare let decodeApiErrorBody: (data: unknown, options?: DecodeApiErrorBodyOptions) => unknown;
 declare let statusLabelForApiError: (status?: ApiErrorStatus, statusText?: string) => string;
 declare let extractApiErrorMessage: (error: unknown, options?: ApiErrorDetailOptions & {
     response?: ApiErrorResponse;
@@ -923,7 +997,7 @@ declare let createApiServiceError: (message: string, options?: {
     upstreamCode?: string;
     parent?: unknown;
 }) => ServiceError<ErrorRecord<"bad_request", 400>>;
-declare let buildApiServiceError: (error: unknown, options: BuildApiServiceErrorOptions) => ServiceError<ErrorRecord<"bad_request", 400>>;
+declare let buildApiServiceError: (error: unknown, options: BuildApiServiceErrorOptions) => ServiceError<any>;
 
 declare class SlateError extends Error {
     cause?: unknown;
@@ -1094,4 +1168,4 @@ declare let skipWebhook: (reason: string, response?: Response | SlateWebhookHttp
     response: Response | SlateWebhookHttpResponseInit;
 };
 
-export { AUTH_CONFIG_SECRET_PLACEHOLDER_PREFIX, type ApiErrorBuildHelpers, type ApiErrorDetailOptions, type ApiErrorResponse, type ApiErrorStatus, type ApiServiceError, AuthConfigSecretRedactor, type BuildApiServiceErrorOptions, type CreateHmacSignatureOptions, GET_FILE_URL_TOOL_ID, type GetFileUrlHandler, type GetFileUrlToolInput, type GetFileUrlToolOutput, type NormalizeOAuthTokenResponseOptions, type OAuthExpiresAtOptions, type OAuthRefreshTokenFallbackMode, type OAuthTokenResponse, Slate, SlateAction, SlateActionBuilder, type SlateActionCreateParameters, type SlateActionDocsReference, type SlateActionParameters, type SlateActionParametersAny, type SlateActionParametersTool, type SlateActionParametersTrigger, type SlateActionScopeClause, type SlateActionScopeClauseInput, type SlateActionScopeValue, type SlateActionScopes, type SlateActionScopesInput, type SlateActionType, SlateAdapter, type SlateAdapterCapability, SlateAdapterSpec, type SlateAdapterSpecParameters, type SlateAddAttachmentContent, type SlateAddAttachmentInput, type SlateAttachment, type SlateAttachmentInlineContent, type SlateAttachmentUploadReferenceContent, type SlateAttachmentUrlContent, SlateAuth, type SlateAuthDocsReference, type SlateAuthType, type SlateAuthWithCustomData, type SlateAuthWithNone, type SlateAuthWithOauth, type SlateAuthWithServiceAccount, type SlateAuthWithToken, type SlateAuthenticatedAxiosDefaults, type SlateAxiosDefaults, type SlateAxiosErrorAdapter, type SlateAxiosErrorOptions, SlateConfig, type SlateConfigDocsReference, SlateContext, SlateDeclarationError, SlateDefaultPollingIntervalSeconds, type SlateDirectUploadInput, type SlateDocsReference, SlateError, type SlateErrorInput, type SlateErrorIssue, type SlateErrorKind, type SlateErrorProviderInfo, type SlateErrorResponse, type SlateErrorUpstreamInfo, type SlateLiveInvocationInfo, type SlateLogEntry, type SlateLogFields, type SlateLogListener, type SlateLogMessageInput, type SlateLogType, SlateLogger, type SlateProviderDocsReference, SlatePublicContext, SlatePublicTool, type SlatePublicToolInvocationHandler, type SlatePublicToolParameters, type SlateServiceErrorData, SlateSpecification, type SlateSpecificationCreateParameters, type SlateSpecificationParameters, SlateTool, type SlateToolInvocationHandler, type SlateToolParameters, SlateTrigger, SlateTriggerGroup, SlateTriggerGroupBuilder, type SlateTriggerGroupCreateParameters, type SlateTriggerGroupParameters, type SlateTriggerGroupPollHandler, type SlateTriggerGroupPollingParameters, type SlateTriggerGroupRoutingMatchersHandler, type SlateTriggerGroupWebhookAutoRegistrationParameters, type SlateTriggerGroupWebhookManualRegistrationParameters, type SlateTriggerGroupWebhookParameters, type SlateTriggerMappingHandler, type SlateTriggerMatchesHandler, type SlateTriggerParameters, type SlateTriggerRoutingMatcher, type SlateTypedDocsReference, type SlateWebhookHttpResponseInit, type SlateWebhookManualFinishHandler, type SlateWebhookManualSetupHandler, type SlateWebhookProcessHandler, type SlateWebhookRegisterHandler, type SlateWebhookSkipped, type SlateWebhookTarget, type SlateWebhookTargetListHandler, type SlateWebhookTargetOwnership, type SlateWebhookUnregisterHandler, type VerifyHmacSignatureOptions, adapterSpec, allOf, anyOf, auth, axios, buildApiServiceError, collectApiErrorDetails, config, createApiServiceError, createAuthenticatedAxios, createAxios, createBase64Attachment, createHmacSignature, createSlateError, createTextAttachment, createUrlAttachment, extractApiErrorMessage, getApiErrorResponse, getApiErrorStatus, getBase64ByteLength, getCurrentContext, getFileUrlTool, getFileUrlToolInputSchema, getFileUrlToolOutputSchema, getGraphWebhookValidationResponse, getMetaWebhookVerificationResponse, getOAuthExpiresAtFromExpiresIn, getResponseHeaderValue, getServiceErrorData, graphWebhookHttp, inferSlateErrorFromAxios, isApiErrorRecord, isAxiosErrorLike, isServiceErrorData, mapServiceErrorCode, mapServiceErrorToSlateErrorInput, mergeScopes, metaWebhookHttp, normalizeOAuthTokenResponse, pickDefined, publicTool, redactUrlAttachmentSecrets, requestAxios, requestAxiosData, runWithContext, scopeClause, setIfDefined, skipWebhook, spec, statusLabelForApiError, tool, trigger, triggerGroup, uploadAttachmentDirect, validateScopes, verifyHmacSignature };
+export { API_ERROR_MAX_DETAILS, API_ERROR_MAX_MESSAGE_LENGTH, API_ERROR_TRUNCATED_PLACEHOLDER, AUTH_CONFIG_SECRET_PLACEHOLDER_PREFIX, type ApiErrorBuildHelpers, type ApiErrorDetailOptions, type ApiErrorResponse, type ApiErrorStatus, type ApiErrorTextOptions, type ApiServiceError, type AuthConfigSecretFilter, AuthConfigSecretRedactor, type BoundedApiErrorDetailOptions, type BuildApiServiceErrorOptions, type CreateHmacSignatureOptions, type DecodeApiErrorBodyOptions, GET_FILE_URL_TOOL_ID, type GetFileUrlHandler, type GetFileUrlToolInput, type GetFileUrlToolOutput, type NormalizeOAuthTokenResponseOptions, type OAuthExpiresAtOptions, type OAuthRefreshTokenFallbackMode, type OAuthTokenResponse, Slate, SlateAction, SlateActionBuilder, type SlateActionCreateParameters, type SlateActionDocsReference, type SlateActionParameters, type SlateActionParametersAny, type SlateActionParametersTool, type SlateActionParametersTrigger, type SlateActionScopeClause, type SlateActionScopeClauseInput, type SlateActionScopeValue, type SlateActionScopes, type SlateActionScopesInput, type SlateActionType, SlateAdapter, type SlateAdapterCapability, SlateAdapterSpec, type SlateAdapterSpecParameters, type SlateAddAttachmentContent, type SlateAddAttachmentInput, type SlateAttachment, type SlateAttachmentInlineContent, type SlateAttachmentUploadReferenceContent, type SlateAttachmentUrlContent, SlateAuth, type SlateAuthDocsReference, type SlateAuthType, type SlateAuthWithCustomData, type SlateAuthWithNone, type SlateAuthWithOauth, type SlateAuthWithServiceAccount, type SlateAuthWithToken, type SlateAuthenticatedAxiosDefaults, type SlateAxiosDefaults, type SlateAxiosErrorAdapter, type SlateAxiosErrorOptions, SlateConfig, type SlateConfigDocsReference, SlateContext, SlateDeclarationError, SlateDefaultPollingIntervalSeconds, type SlateDirectUploadInput, type SlateDocsReference, SlateError, type SlateErrorInput, type SlateErrorIssue, type SlateErrorKind, type SlateErrorProviderInfo, type SlateErrorResponse, type SlateErrorUpstreamInfo, type SlateGatewayEvent, type SlateLiveInvocationInfo, type SlateLogEntry, type SlateLogFields, type SlateLogListener, type SlateLogMessageInput, type SlateLogType, SlateLogger, type SlateProviderDocsReference, SlatePublicContext, SlatePublicTool, type SlatePublicToolInvocationHandler, type SlatePublicToolParameters, type SlateServiceErrorData, SlateSpecification, type SlateSpecificationCreateParameters, type SlateSpecificationParameters, SlateTool, type SlateToolInvocationHandler, type SlateToolParameters, SlateTrigger, SlateTriggerGroup, SlateTriggerGroupBuilder, type SlateTriggerGroupCreateParameters, type SlateTriggerGroupGatewayConnectHandler, type SlateTriggerGroupGatewayParameters, type SlateTriggerGroupGatewayReceiveHandler, type SlateTriggerGroupParameters, type SlateTriggerGroupPollHandler, type SlateTriggerGroupPollingParameters, type SlateTriggerGroupRoutingMatchersHandler, type SlateTriggerGroupWebhookAutoRegistrationParameters, type SlateTriggerGroupWebhookManualRegistrationParameters, type SlateTriggerGroupWebhookParameters, type SlateTriggerMappingHandler, type SlateTriggerMatchesHandler, type SlateTriggerParameters, type SlateTriggerRoutingMatcher, type SlateTypedDocsReference, type SlateWebhookHttpResponseInit, type SlateWebhookManualFinishHandler, type SlateWebhookManualSetupHandler, type SlateWebhookProcessHandler, type SlateWebhookRegisterHandler, type SlateWebhookSkipped, type SlateWebhookTarget, type SlateWebhookTargetListHandler, type SlateWebhookTargetOwnership, type SlateWebhookUnregisterHandler, type VerifyHmacSignatureOptions, adapterSpec, allOf, anyOf, auth, axios, buildApiServiceError, collectApiErrorDetails, config, createApiServiceError, createAuthenticatedAxios, createAxios, createBase64Attachment, createHmacSignature, createSlateError, createTextAttachment, createUrlAttachment, decodeApiErrorBody, extractApiErrorMessage, getApiErrorResponse, getApiErrorResponseWithBody, getApiErrorStatus, getBase64ByteLength, getCurrentContext, getFileUrlTool, getFileUrlToolInputSchema, getFileUrlToolOutputSchema, getGraphWebhookValidationResponse, getMetaWebhookVerificationResponse, getOAuthExpiresAtFromExpiresIn, getResponseHeaderValue, getServiceErrorData, graphWebhookHttp, inferSlateErrorFromAxios, isApiErrorRecord, isAxiosErrorLike, isServiceErrorData, isUrlEmbeddedCredential, looksLikeHtmlErrorBody, mapServiceErrorCode, mapServiceErrorToSlateErrorInput, mergeScopes, metaWebhookHttp, normalizeOAuthTokenResponse, pickDefined, publicTool, pushBoundedApiErrorDetail, readApiErrorText, redactUrlAttachmentSecrets, requestAxios, requestAxiosData, runWithContext, scopeClause, setIfDefined, skipWebhook, spec, statusLabelForApiError, tool, trigger, triggerGroup, truncateApiErrorMessage, uploadAttachmentDirect, validateScopes, verifyHmacSignature };