@slates/provider 1.0.0-rc.28 → 1.0.0-rc.30

package/dist/index.d.cts

@@ -41,17 +41,26 @@ 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;
-    /** `embeddable` limits which secrets are also replaced inside longer strings. */
-    redactEmbedded<T>(value: T, embeddable?: (secret: string, path: string) => boolean): 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;
@@ -848,6 +857,25 @@ declare let allOf: (...inputs: SlateActionScopesInput[]) => SlateActionScopes;
 declare let mergeScopes: (...inputs: Array<SlateActionScopes | null | undefined | false>) => SlateActionScopes | undefined;
 declare let validateScopes: (scopes: SlateActionScopes) => SlateActionScopes;
 
+interface SlateToolCategoryParameters {
+    key: string;
+    name: string;
+    description?: string;
+    imageUrl?: string;
+    tools: SlateTool<any, any, any, any>[];
+}
+declare class SlateToolCategory {
+    private readonly _params;
+    private constructor();
+    static create(params: SlateToolCategoryParameters): SlateToolCategory;
+    get key(): string;
+    get name(): string;
+    get description(): string | undefined;
+    get imageUrl(): string | undefined;
+    get tools(): SlateTool<any, any, any, any>[];
+}
+declare let toolCategory: (params: SlateToolCategoryParameters) => SlateToolCategory;
+
 interface SlateTriggerParameters<ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {
     type: string;
 }> extends SlateActionParameters {
@@ -932,6 +960,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;
@@ -958,6 +987,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;
@@ -968,7 +1016,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,6 +1142,8 @@ declare class Slate<ConfigType extends {}, AuthType extends {}> {
     private readonly _actions;
     private readonly _adapters;
     private readonly _triggerGroups;
+    private readonly _toolCategories;
+    private readonly _toolCategoryKeysByActionKey;
     private constructor();
     static create<ConfigType extends {}, AuthType extends {}>(params: {
         spec: SlateSpecification<ConfigType, AuthType>;
@@ -1101,11 +1151,14 @@ declare class Slate<ConfigType extends {}, AuthType extends {}> {
         tools: SlateTool<ConfigType, AuthType, any, any>[];
         adapters?: SlateAdapter<ConfigType, AuthType>[];
         triggerGroups?: SlateTriggerGroup<ConfigType, AuthType>[];
+        toolCategories?: SlateToolCategory[];
     }): Slate<ConfigType, AuthType>;
     get spec(): SlateSpecification<ConfigType, AuthType>;
     get actions(): (SlateTrigger<ConfigType, AuthType, any, any> | SlateTool<ConfigType, AuthType, any, any>)[];
     get adapters(): SlateAdapter<ConfigType, AuthType>[];
     get triggerGroups(): SlateTriggerGroup<ConfigType, AuthType, Record<string, unknown>>[];
+    get toolCategories(): SlateToolCategory[];
+    getToolCategoryKeys(actionKey: string): string[];
 }
 
 declare const graphWebhookHttp: {
@@ -1139,4 +1192,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 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, extractApiErrorMessage, getApiErrorResponse, getApiErrorStatus, getBase64ByteLength, getCurrentContext, getFileUrlTool, getFileUrlToolInputSchema, getFileUrlToolOutputSchema, getGraphWebhookValidationResponse, getMetaWebhookVerificationResponse, getOAuthExpiresAtFromExpiresIn, getResponseHeaderValue, getServiceErrorData, graphWebhookHttp, inferSlateErrorFromAxios, isApiErrorRecord, isAxiosErrorLike, isServiceErrorData, isUrlEmbeddedCredential, 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, SlateToolCategory, type SlateToolCategoryParameters, 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, toolCategory, trigger, triggerGroup, truncateApiErrorMessage, uploadAttachmentDirect, validateScopes, verifyHmacSignature };

package/dist/index.d.ts

@@ -41,17 +41,26 @@ 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;
-    /** `embeddable` limits which secrets are also replaced inside longer strings. */
-    redactEmbedded<T>(value: T, embeddable?: (secret: string, path: string) => boolean): 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;
@@ -848,6 +857,25 @@ declare let allOf: (...inputs: SlateActionScopesInput[]) => SlateActionScopes;
 declare let mergeScopes: (...inputs: Array<SlateActionScopes | null | undefined | false>) => SlateActionScopes | undefined;
 declare let validateScopes: (scopes: SlateActionScopes) => SlateActionScopes;
 
+interface SlateToolCategoryParameters {
+    key: string;
+    name: string;
+    description?: string;
+    imageUrl?: string;
+    tools: SlateTool<any, any, any, any>[];
+}
+declare class SlateToolCategory {
+    private readonly _params;
+    private constructor();
+    static create(params: SlateToolCategoryParameters): SlateToolCategory;
+    get key(): string;
+    get name(): string;
+    get description(): string | undefined;
+    get imageUrl(): string | undefined;
+    get tools(): SlateTool<any, any, any, any>[];
+}
+declare let toolCategory: (params: SlateToolCategoryParameters) => SlateToolCategory;
+
 interface SlateTriggerParameters<ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {
     type: string;
 }> extends SlateActionParameters {
@@ -932,6 +960,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;
@@ -958,6 +987,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;
@@ -968,7 +1016,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,6 +1142,8 @@ declare class Slate<ConfigType extends {}, AuthType extends {}> {
     private readonly _actions;
     private readonly _adapters;
     private readonly _triggerGroups;
+    private readonly _toolCategories;
+    private readonly _toolCategoryKeysByActionKey;
     private constructor();
     static create<ConfigType extends {}, AuthType extends {}>(params: {
         spec: SlateSpecification<ConfigType, AuthType>;
@@ -1101,11 +1151,14 @@ declare class Slate<ConfigType extends {}, AuthType extends {}> {
         tools: SlateTool<ConfigType, AuthType, any, any>[];
         adapters?: SlateAdapter<ConfigType, AuthType>[];
         triggerGroups?: SlateTriggerGroup<ConfigType, AuthType>[];
+        toolCategories?: SlateToolCategory[];
     }): Slate<ConfigType, AuthType>;
     get spec(): SlateSpecification<ConfigType, AuthType>;
     get actions(): (SlateTrigger<ConfigType, AuthType, any, any> | SlateTool<ConfigType, AuthType, any, any>)[];
     get adapters(): SlateAdapter<ConfigType, AuthType>[];
     get triggerGroups(): SlateTriggerGroup<ConfigType, AuthType, Record<string, unknown>>[];
+    get toolCategories(): SlateToolCategory[];
+    getToolCategoryKeys(actionKey: string): string[];
 }
 
 declare const graphWebhookHttp: {
@@ -1139,4 +1192,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 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, extractApiErrorMessage, getApiErrorResponse, getApiErrorStatus, getBase64ByteLength, getCurrentContext, getFileUrlTool, getFileUrlToolInputSchema, getFileUrlToolOutputSchema, getGraphWebhookValidationResponse, getMetaWebhookVerificationResponse, getOAuthExpiresAtFromExpiresIn, getResponseHeaderValue, getServiceErrorData, graphWebhookHttp, inferSlateErrorFromAxios, isApiErrorRecord, isAxiosErrorLike, isServiceErrorData, isUrlEmbeddedCredential, 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, SlateToolCategory, type SlateToolCategoryParameters, 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, toolCategory, trigger, triggerGroup, truncateApiErrorMessage, uploadAttachmentDirect, validateScopes, verifyHmacSignature };