@slates/provider 1.0.0-rc.16 → 1.0.0-rc.18

package/dist/index.d.ts

@@ -145,6 +145,7 @@ type SlateAuthWithToken<InputType extends {}, OutputType extends {
     docs?: SlateAuthDocsReference[];
     getOutput: (ctx: {
         input: InputType;
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         output: OutputType;
         scopes?: string[];
@@ -159,6 +160,8 @@ type SlateAuthWithToken<InputType extends {}, OutputType extends {
     getProfile?: (ctx: {
         output: OutputType;
         input: InputType;
+        scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         profile: Record<string, any>;
     }>;
@@ -171,6 +174,7 @@ type SlateAuthWithServiceAccount<InputType extends {}, OutputType extends {}> =
     docs?: SlateAuthDocsReference[];
     getOutput: (ctx: {
         input: InputType;
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         output: OutputType;
         scopes?: string[];
@@ -185,6 +189,8 @@ type SlateAuthWithServiceAccount<InputType extends {}, OutputType extends {}> =
     getProfile?: (ctx: {
         output: OutputType;
         input: InputType;
+        scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         profile: Record<string, any>;
     }>;
@@ -197,6 +203,7 @@ type SlateAuthWithCustomData<InputType extends {}, OutputType extends {}> = {
     docs?: SlateAuthDocsReference[];
     getOutput: (ctx: {
         input: InputType;
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         output: OutputType;
         scopes?: string[];
@@ -207,6 +214,7 @@ type SlateAuthWithCustomData<InputType extends {}, OutputType extends {}> = {
         clientId: string;
         clientSecret: string;
         scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         output: OutputType;
         input?: InputType;
@@ -221,6 +229,8 @@ type SlateAuthWithCustomData<InputType extends {}, OutputType extends {}> = {
     getProfile?: (ctx: {
         output: OutputType;
         input: InputType;
+        scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         profile: Record<string, any>;
     }>;
@@ -264,6 +274,34 @@ declare class SlateAuth<OutputType extends {} = {}> {
 }
 declare let auth: <OutputType extends {} = {}>() => SlateAuth<OutputType>;
 
+type OAuthTokenResponse = {
+    access_token?: unknown;
+    refresh_token?: unknown;
+    expires_in?: unknown;
+    [key: string]: unknown;
+};
+type OAuthRefreshTokenFallbackMode = 'nullish' | 'falsy';
+type OAuthExpiresAtOptions = {
+    nowMs?: number;
+    providerLabel?: string;
+    operation?: string;
+    required?: boolean;
+    expiresInType?: 'number' | 'numberLike';
+    message?: string;
+};
+type NormalizeOAuthTokenResponseOptions = OAuthExpiresAtOptions & {
+    previousRefreshToken?: string;
+    refreshTokenFallbackMode?: OAuthRefreshTokenFallbackMode;
+    accessTokenMessage?: string;
+    expiresInMessage?: string;
+};
+declare let getOAuthExpiresAtFromExpiresIn: (expiresIn: unknown, options?: OAuthExpiresAtOptions) => string | undefined;
+declare let normalizeOAuthTokenResponse: (data: unknown, options?: NormalizeOAuthTokenResponseOptions) => {
+    token: string;
+    refreshToken: string | undefined;
+    expiresAt: string | undefined;
+};
+
 declare class SlateConfig<ConfigType extends {}> {
     #private;
     private constructor();
@@ -320,18 +358,17 @@ declare class SlateSpecification<ConfigType extends {}, AuthType extends {}> {
 }
 declare let spec: <ConfigType extends {}, AuthType extends {}>(params: SlateSpecificationCreateParameters<ConfigType, AuthType>) => SlateSpecification<ConfigType, AuthType>;
 
-declare class SlateContext<ConfigType extends {}, AuthType extends {}, InputType extends {}> {
+declare class SlatePublicContext<InputType extends {}> {
     #private;
     private readonly spec;
     private readonly logger;
-    constructor(config: ConfigType, input: InputType, auth: AuthType, spec: SlateSpecification<ConfigType, AuthType>, logger: SlateLogger);
-    get specification(): SlateSpecification<ConfigType, AuthType>;
-    get config(): Readonly<ConfigType>;
+    constructor(input: InputType, spec: SlateSpecification<any, any>, logger: SlateLogger);
+    get specification(): SlateSpecification<any, any>;
     get input(): Readonly<InputType>;
     get event(): Readonly<InputType>;
     get state(): "state" extends keyof InputType ? InputType["state"] : never;
     get request(): "request" extends keyof InputType ? InputType["request"] : never;
-    get auth(): Readonly<AuthType>;
+    get registrationDetails(): "registrationDetails" extends keyof InputType ? InputType["registrationDetails"] : never;
     recordHttpTrace(trace: SlateHttpTrace): void;
     getHttpTraces(): {
         error?: {
@@ -358,8 +395,14 @@ declare class SlateContext<ConfigType extends {}, AuthType extends {}, InputType
     error(message: SlateLogMessageInput): void;
     progress(message: SlateLogMessageInput): void;
 }
+declare class SlateContext<ConfigType extends {}, AuthType extends {}, InputType extends {}> extends SlatePublicContext<InputType> {
+    #private;
+    constructor(config: ConfigType, input: InputType, auth: AuthType, spec: SlateSpecification<ConfigType, AuthType>, logger: SlateLogger);
+    get config(): Readonly<ConfigType>;
+    get auth(): Readonly<AuthType>;
+}
 
-declare let runWithContext: <ConfigType extends {}, AuthType extends {}, InputType extends {}, RV>(context: SlateContext<ConfigType, AuthType, InputType>, fn: () => Promise<RV>) => Promise<RV>;
+declare let runWithContext: <InputType extends {}, RV>(context: SlatePublicContext<InputType>, fn: () => Promise<RV>) => Promise<RV>;
 declare let getCurrentContext: <ConfigType extends {}, AuthType extends {}, InputType extends {}>() => SlateContext<ConfigType, AuthType, InputType>;
 
 interface SlateAttachmentUrlContent {
@@ -401,12 +444,19 @@ interface SlateActionParameters {
     scopes?: SlateActionScopes;
     authMethods?: string[];
     docs?: SlateActionDocsReference[];
+    adapter?: string | null;
+    isPublic?: boolean;
 }
 type SlateToolInvocationHandler<ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}> = (context: SlateContext<ConfigType, AuthType, InputType>) => Promise<{
     output: OutputType;
     message: string;
     attachments?: SlateAttachment[];
 }>;
+type SlatePublicToolInvocationHandler<InputType extends {}, OutputType extends {}> = (context: SlatePublicContext<InputType>) => Promise<{
+    output: OutputType;
+    message: string;
+    attachments?: SlateAttachment[];
+}>;
 type SlateTriggerMappingHandler<ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}> = (context: SlateContext<ConfigType, AuthType, InputType>) => Promise<{
     type: string;
     id: string;
@@ -418,12 +468,41 @@ type SlateTriggerPollingHandler<ConfigType extends {}, AuthType extends {}, Inpu
     inputs: InputType[];
     updatedState?: any;
 }>;
+interface SlateWebhookHttpResponseInit {
+    status?: number;
+    headers?: Record<string, string>;
+    body?: string | Uint8Array | null;
+}
+type SlateWebhookHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+interface SlateWebhookRequestMatcher {
+    method?: string;
+    hasQueryParam?: string;
+    hasHeader?: string;
+    jsonBodyField?: {
+        path: string;
+        equals?: string;
+    };
+    formBodyField?: {
+        path: string;
+        equals?: string;
+    };
+}
+interface SlateWebhookHttpOptions {
+    methods?: SlateWebhookHttpMethod[];
+    sync?: {
+        mode: 'never' | 'match' | 'always';
+        match?: SlateWebhookRequestMatcher[];
+        timeoutMs?: number;
+    };
+}
 type SlateTriggerWebhookRequestHandler<ConfigType extends {}, AuthType extends {}, InputType extends {}> = (context: SlateContext<ConfigType, AuthType, {
     request: Request;
     state: any | null;
+    registrationDetails: any | null;
 }>) => Promise<{
     inputs: InputType[];
     updatedState?: any;
+    response?: Response | SlateWebhookHttpResponseInit;
 }>;
 type SlateTriggerWebhookAutoRegistrationHandler<ConfigType extends {}, AuthType extends {}> = (context: SlateContext<ConfigType, AuthType, {
     webhookBaseUrl: string;
@@ -449,6 +528,7 @@ interface SlateActionParametersTrigger<ConfigType extends {}, AuthType extends {
     polling?: SlatePollingOptions;
     handleEvent: SlateTriggerMappingHandler<ConfigType, AuthType, InputType, OutputType>;
     handleRequest?: SlateTriggerWebhookRequestHandler<ConfigType, AuthType, InputType>;
+    http?: SlateWebhookHttpOptions;
     pollEvents?: SlateTriggerPollingHandler<ConfigType, AuthType, InputType>;
     autoRegisterWebhook?: SlateTriggerWebhookAutoRegistrationHandler<ConfigType, AuthType>;
     autoUnregisterWebhook?: SlateTriggerWebhookAutoUnregistrationHandler<ConfigType, AuthType>;
@@ -485,35 +565,66 @@ declare abstract class SlateAction<Type extends SlateActionType, ConfigType exte
     get scopes(): SlateActionScopes | undefined;
     get authMethods(): string[] | undefined;
     get docs(): SlateActionDocsReference[] | undefined;
+    get adapter(): string | null;
+    get isPublic(): boolean;
 }
 
-declare class SlateActionBuilder<Type extends SlateActionType, ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}, Result extends SlateAction<Type, ConfigType, AuthType, any, any>> {
+declare class SlateActionBuilder<Type extends SlateActionType, ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}, Result extends SlateAction<Type, ConfigType, AuthType, any, any>, IsPublic extends boolean = false> {
     #private;
     private readonly type;
     readonly spec: SlateSpecification<ConfigType, AuthType>;
     private readonly params;
     private readonly factory;
-    constructor(type: Type, spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters, factory: (params: SlateActionCreateParameters<any, any, any, any>) => Result);
-    input<NewInputType extends {}>(schema: z.ZodType<NewInputType>): SlateActionBuilder<Type, ConfigType, AuthType, NewInputType, OutputType, Result>;
-    output<NewOutputType extends {}>(schema: z.ZodType<NewOutputType>): SlateActionBuilder<Type, ConfigType, AuthType, InputType, NewOutputType, Result>;
-    scopes(scopes: SlateActionScopes): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result>;
-    authMethods(authMethods: string[]): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result>;
+    private readonly isPublicTool;
+    constructor(type: Type, spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters, factory: (params: SlateActionCreateParameters<any, any, any, any>) => Result, isPublicTool?: IsPublic);
+    input<NewInputType extends {}>(schema: z.ZodType<NewInputType>): SlateActionBuilder<Type, ConfigType, AuthType, NewInputType, OutputType, Result, IsPublic>;
+    output<NewOutputType extends {}>(schema: z.ZodType<NewOutputType>): SlateActionBuilder<Type, ConfigType, AuthType, InputType, NewOutputType, Result, IsPublic>;
+    lockInterface(): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result, IsPublic>;
+    scopes(scopes: SlateActionScopes): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result, IsPublic>;
+    authMethods(authMethods: string[]): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result, IsPublic>;
     private validateAuthMethods;
-    handleInvocation(handler: SlateToolInvocationHandler<ConfigType, AuthType, InputType, OutputType>): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result>;
+    handleInvocation(handler: IsPublic extends true ? SlatePublicToolInvocationHandler<InputType, OutputType> : SlateToolInvocationHandler<ConfigType, AuthType, InputType, OutputType>): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result, IsPublic>;
     webhook(props: {
         handleEvent: SlateTriggerMappingHandler<ConfigType, AuthType, InputType, OutputType>;
         handleRequest: SlateTriggerWebhookRequestHandler<ConfigType, AuthType, InputType>;
         autoRegisterWebhook?: SlateTriggerWebhookAutoRegistrationHandler<ConfigType, AuthType>;
         autoUnregisterWebhook?: SlateTriggerWebhookAutoUnregistrationHandler<ConfigType, AuthType>;
-    }): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result>;
+        http?: SlateWebhookHttpOptions;
+    }): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result, IsPublic>;
     polling(props: {
         options?: SlatePollingOptions;
         pollEvents?: SlateTriggerPollingHandler<ConfigType, AuthType, InputType>;
         handleEvent: SlateTriggerMappingHandler<ConfigType, AuthType, InputType, OutputType>;
-    }): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result>;
+    }): SlateActionBuilder<Type, ConfigType, AuthType, InputType, OutputType, Result, IsPublic>;
     build(): Result;
 }
 
+interface SlateToolParameters<ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}> extends SlateActionParameters {
+    handleInvocation: SlateToolInvocationHandler<ConfigType, AuthType, InputType, OutputType>;
+}
+declare class SlateTool<ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}> extends SlateAction<'tool', ConfigType, AuthType, InputType, OutputType> {
+    #private;
+    protected constructor(spec: SlateSpecification<ConfigType, AuthType>, inputSchema: z.ZodType<InputType>, outputSchema: z.ZodType<OutputType>, params: SlateToolParameters<ConfigType, AuthType, InputType, OutputType>);
+    static create<ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters): SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<ConfigType, AuthType, any, any>, false>;
+    static fromCreateParameters<ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: {
+        type: string;
+        inputSchema: z.ZodType<any>;
+        outputSchema: z.ZodType<any>;
+        handleInvocation?: SlateToolInvocationHandler<ConfigType, AuthType, any, any>;
+    } & SlateActionParameters): SlateTool<ConfigType, AuthType, any, any>;
+    get handleInvocation(): SlateToolInvocationHandler<ConfigType, AuthType, InputType, OutputType>;
+}
+declare let tool: <ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters) => SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<ConfigType, AuthType, any, any>, false>;
+
+interface SlatePublicToolParameters<InputType extends {}, OutputType extends {}> extends SlateActionParameters {
+    handleInvocation: SlatePublicToolInvocationHandler<InputType, OutputType>;
+}
+declare class SlatePublicTool {
+    private constructor();
+    static create<ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters): SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<ConfigType, AuthType, any, any>, true>;
+}
+declare let publicTool: <ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters) => SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<ConfigType, AuthType, any, any>, true>;
+
 type SlateActionScopeValue = string;
 type SlateActionScopeClauseInput = SlateActionScopeValue | readonly SlateActionScopeValue[] | SlateActionScopeClause;
 type SlateActionScopesInput = SlateActionScopeClauseInput | SlateActionScopes;
@@ -523,17 +634,6 @@ declare let allOf: (...inputs: SlateActionScopesInput[]) => SlateActionScopes;
 declare let mergeScopes: (...inputs: Array<SlateActionScopes | null | undefined | false>) => SlateActionScopes | undefined;
 declare let validateScopes: (scopes: SlateActionScopes) => SlateActionScopes;
 
-interface SlateToolParameters<ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}> extends SlateActionParameters {
-    handleInvocation: SlateToolInvocationHandler<ConfigType, AuthType, InputType, OutputType>;
-}
-declare class SlateTool<ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}> extends SlateAction<'tool', ConfigType, AuthType, InputType, OutputType> {
-    #private;
-    private constructor();
-    static create<ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters): SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<any, any, any, any>>;
-    get handleInvocation(): SlateToolInvocationHandler<ConfigType, AuthType, InputType, OutputType>;
-}
-declare let tool: <ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters) => SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<any, any, any, any>>;
-
 declare let SlateDefaultPollingIntervalSeconds: number;
 interface SlateTriggerParameters<ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {
     type: string;
@@ -543,6 +643,7 @@ interface SlateTriggerParameters<ConfigType extends {}, AuthType extends {}, Inp
     polling?: SlatePollingOptions;
     handleEvent: SlateTriggerMappingHandler<ConfigType, AuthType, InputType, OutputType>;
     handleRequest?: SlateTriggerWebhookRequestHandler<ConfigType, AuthType, InputType>;
+    http?: SlateWebhookHttpOptions;
     pollEvents?: SlateTriggerPollingHandler<ConfigType, AuthType, InputType>;
     autoRegisterWebhook?: SlateTriggerWebhookAutoRegistrationHandler<ConfigType, AuthType>;
     autoUnregisterWebhook?: SlateTriggerWebhookAutoUnregistrationHandler<ConfigType, AuthType>;
@@ -552,16 +653,119 @@ declare class SlateTrigger<ConfigType extends {}, AuthType extends {}, InputType
 }> extends SlateAction<'trigger', ConfigType, AuthType, InputType, OutputType> {
     #private;
     private constructor();
-    static create<ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters): SlateActionBuilder<"trigger", ConfigType, AuthType, {}, {}, SlateTrigger<any, any, any, any>>;
+    static create<ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters): SlateActionBuilder<"trigger", ConfigType, AuthType, {}, {}, SlateTrigger<ConfigType, AuthType, any, any>, false>;
     get polling(): SlatePollingOptions;
     get source(): "polling" | "webhook";
     get handleEvent(): SlateTriggerMappingHandler<ConfigType, AuthType, InputType, OutputType>;
     get handleRequest(): SlateTriggerWebhookRequestHandler<ConfigType, AuthType, InputType> | undefined;
+    get http(): SlateWebhookHttpOptions | undefined;
     get pollEvents(): SlateTriggerPollingHandler<ConfigType, AuthType, InputType> | undefined;
     get autoRegisterWebhook(): SlateTriggerWebhookAutoRegistrationHandler<ConfigType, AuthType> | undefined;
     get autoUnregisterWebhook(): SlateTriggerWebhookAutoUnregistrationHandler<ConfigType, AuthType> | undefined;
 }
-declare let trigger: <ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters) => SlateActionBuilder<"trigger", ConfigType, AuthType, {}, {}, SlateTrigger<any, any, any, any>>;
+declare let trigger: <ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters) => SlateActionBuilder<"trigger", ConfigType, AuthType, {}, {}, SlateTrigger<ConfigType, AuthType, any, any>, false>;
+
+interface SlateAdapterCapability {
+    id: string;
+    value: any;
+}
+interface SlateAdapterSpecParameters {
+    id: string;
+    name: string;
+    capabilities?: SlateAdapterCapability[];
+}
+declare class SlateAdapterSpec {
+    private readonly _params;
+    private constructor();
+    static create(params: SlateAdapterSpecParameters): SlateAdapterSpec;
+    get id(): string;
+    get name(): string;
+    get capabilities(): SlateAdapterCapability[];
+    get parameters(): {
+        id: string;
+        name: string;
+        capabilities: SlateAdapterCapability[];
+    };
+    tool<ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters): SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<ConfigType, AuthType, any, any>, false>;
+    publicTool<ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters): SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<ConfigType, AuthType, any, any>, true>;
+    trigger<ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters): SlateActionBuilder<"trigger", ConfigType, AuthType, {}, {}, SlateTrigger<ConfigType, AuthType, any, any>, false>;
+    register<ConfigType extends {}, AuthType extends {}>(params: {
+        tools: SlateTool<ConfigType, AuthType, any, any>[];
+        triggers: SlateTrigger<ConfigType, AuthType, any, any>[];
+    }): SlateAdapter<ConfigType, AuthType>;
+    private linkAction;
+}
+declare let adapterSpec: (params: SlateAdapterSpecParameters) => SlateAdapterSpec;
+
+declare class SlateAdapter<ConfigType extends {}, AuthType extends {}> {
+    private readonly _spec;
+    private readonly _tools;
+    private readonly _triggers;
+    constructor(_spec: SlateAdapterSpec, _tools: SlateTool<ConfigType, AuthType, any, any>[], _triggers: SlateTrigger<ConfigType, AuthType, any, any>[]);
+    get spec(): SlateAdapterSpec;
+    get id(): string;
+    get name(): string;
+    get capabilities(): SlateAdapterCapability[];
+    get tools(): SlateTool<ConfigType, AuthType, any, any>[];
+    get triggers(): SlateTrigger<ConfigType, AuthType, any, any>[];
+    get actions(): (SlateTrigger<ConfigType, AuthType, any, any> | SlateTool<ConfigType, AuthType, any, any>)[];
+}
+
+type ApiErrorStatus = number | string;
+type ApiServiceError = ServiceError<ErrorRecord<any, any>>;
+type ApiErrorResponse = {
+    status?: ApiErrorStatus;
+    statusText?: string;
+    data?: unknown;
+};
+type ApiErrorDetailOptions = {
+    detailKeys?: readonly string[];
+    nestedKeys?: readonly string[];
+    includeNumbers?: boolean;
+    separator?: string;
+    fallbackMessage?: string;
+};
+type ApiErrorBuildHelpers = {
+    collectDetails: (value: unknown, details: string[], options?: ApiErrorDetailOptions) => void;
+    extractMessage: (error: unknown, options?: ApiErrorDetailOptions) => string;
+    getResponse: (error: unknown) => ApiErrorResponse | undefined;
+    getStatus: (error: unknown) => ApiErrorStatus | undefined;
+    isRecord: (value: unknown) => value is Record<string, unknown>;
+    statusLabelFor: (status?: ApiErrorStatus, statusText?: string) => string;
+};
+type BuildApiServiceErrorOptions = ApiErrorDetailOptions & {
+    providerLabel: string;
+    reason: string;
+    operation?: string;
+    extractMessage?: (error: unknown, helpers: ApiErrorBuildHelpers) => string | undefined;
+    extractResponse?: (error: unknown, helpers: ApiErrorBuildHelpers) => ApiErrorResponse | undefined;
+    extractStatus?: (error: unknown, response: ApiErrorResponse | undefined, helpers: ApiErrorBuildHelpers) => ApiErrorStatus | undefined;
+    extractUpstreamCode?: (error: unknown, response: ApiErrorResponse | undefined, helpers: ApiErrorBuildHelpers) => string | undefined;
+    formatMessage?: (parts: {
+        providerLabel: string;
+        operation: string;
+        statusLabel: string;
+        message: string;
+        response?: ApiErrorResponse;
+        status?: ApiErrorStatus;
+    }) => string;
+    parent?: unknown;
+};
+declare let isApiErrorRecord: (value: unknown) => value is Record<string, unknown>;
+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 statusLabelForApiError: (status?: ApiErrorStatus, statusText?: string) => string;
+declare let extractApiErrorMessage: (error: unknown, options?: ApiErrorDetailOptions & {
+    response?: ApiErrorResponse;
+}) => string;
+declare let createApiServiceError: (message: string, options?: {
+    reason?: string;
+    upstreamStatus?: ApiErrorStatus;
+    upstreamCode?: string;
+    parent?: unknown;
+}) => ServiceError<ErrorRecord<"bad_request", 400>>;
+declare let buildApiServiceError: (error: unknown, options: BuildApiServiceErrorOptions) => ServiceError<ErrorRecord<"bad_request", 400>>;
 
 declare class SlateError extends Error {
     cause?: unknown;
@@ -648,20 +852,77 @@ declare let mapServiceErrorToSlateErrorInput: (error: ServiceError<ErrorRecord<a
 interface SlateAxiosDefaults extends CreateAxiosDefaults {
     errorMapping?: SlateAxiosErrorOptions;
 }
+type SlateAxiosErrorAdapter = (error: unknown, operation: string) => unknown;
+interface SlateAuthenticatedAxiosDefaults extends SlateAxiosDefaults {
+    authHeader?: {
+        name?: string;
+        value: string;
+    };
+    contentType?: string | false;
+    errorAdapter?: (error: unknown) => unknown;
+}
 declare let createAxios: (config?: SlateAxiosDefaults) => AxiosInstance;
+declare let createAuthenticatedAxios: (config: SlateAuthenticatedAxiosDefaults) => AxiosInstance;
+declare let requestAxios: <T = unknown>(operation: string, request: () => Promise<AxiosResponse<T>>, errorAdapter: SlateAxiosErrorAdapter) => Promise<AxiosResponse<T, any, {}>>;
+declare let requestAxiosData: <T = unknown>(operation: string, request: () => Promise<AxiosResponse<T>>, errorAdapter: SlateAxiosErrorAdapter) => Promise<T>;
 declare let axios: AxiosInstance;
 
+interface CreateHmacSignatureOptions {
+    secret: string | Uint8Array;
+    payload: string | Uint8Array;
+    algorithm?: string;
+    digest: 'hex' | 'base64';
+    prefix?: string;
+}
+interface VerifyHmacSignatureOptions extends CreateHmacSignatureOptions {
+    signature: string;
+}
+declare let createHmacSignature: ({ secret, payload, algorithm, digest, prefix }: CreateHmacSignatureOptions) => string;
+declare let verifyHmacSignature: (options: VerifyHmacSignatureOptions) => boolean;
+
+declare let getResponseHeaderValue: (headers: unknown, name: string) => string | undefined;
+declare let getBase64ByteLength: (contentBase64: string) => number;
+
+declare let pickDefined: <T extends object>(value: T) => Partial<T> & Record<string, unknown>;
+declare let setIfDefined: (target: Record<string, unknown>, key: string, value: unknown) => Record<string, unknown>;
+
 declare class Slate<ConfigType extends {}, AuthType extends {}> {
     private readonly _spec;
     private readonly _actions;
+    private readonly _adapters;
     private constructor();
     static create<ConfigType extends {}, AuthType extends {}>(params: {
         spec: SlateSpecification<ConfigType, AuthType>;
         triggers: SlateTrigger<ConfigType, AuthType, any, any>[];
         tools: SlateTool<ConfigType, AuthType, any, any>[];
+        adapters?: SlateAdapter<ConfigType, AuthType>[];
     }): 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>[];
 }
 
-export { 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, type SlateAttachment, type SlateAttachmentInlineContent, type SlateAttachmentUrlContent, SlateAuth, type SlateAuthDocsReference, type SlateAuthType, type SlateAuthWithCustomData, type SlateAuthWithNone, type SlateAuthWithOauth, type SlateAuthWithServiceAccount, type SlateAuthWithToken, type SlateAxiosDefaults, type SlateAxiosErrorOptions, SlateConfig, type SlateConfigDocsReference, SlateContext, SlateDeclarationError, SlateDefaultPollingIntervalSeconds, type SlateDocsReference, SlateError, type SlateErrorInput, type SlateErrorIssue, type SlateErrorKind, type SlateErrorProviderInfo, type SlateErrorResponse, type SlateErrorUpstreamInfo, type SlateLogEntry, type SlateLogFields, type SlateLogListener, type SlateLogMessageInput, type SlateLogType, SlateLogger, type SlatePollingOptions, type SlateProviderDocsReference, type SlateServiceErrorData, SlateSpecification, type SlateSpecificationCreateParameters, type SlateSpecificationParameters, SlateTool, type SlateToolInvocationHandler, type SlateToolParameters, SlateTrigger, type SlateTriggerMappingHandler, type SlateTriggerParameters, type SlateTriggerPollingHandler, type SlateTriggerWebhookAutoRegistrationHandler, type SlateTriggerWebhookAutoUnregistrationHandler, type SlateTriggerWebhookRequestHandler, type SlateTypedDocsReference, allOf, anyOf, auth, axios, config, createAxios, createBase64Attachment, createSlateError, createTextAttachment, createUrlAttachment, getCurrentContext, getServiceErrorData, inferSlateErrorFromAxios, isAxiosErrorLike, isServiceErrorData, mapServiceErrorCode, mapServiceErrorToSlateErrorInput, mergeScopes, runWithContext, scopeClause, spec, tool, trigger, validateScopes };
+declare const graphWebhookHttp: {
+    methods: "POST"[];
+    sync: {
+        mode: "match";
+        match: {
+            hasQueryParam: string;
+        }[];
+    };
+};
+declare let getGraphWebhookValidationResponse: (request: Request) => SlateWebhookHttpResponseInit | null;
+
+declare const metaWebhookHttp: {
+    methods: ("GET" | "POST")[];
+    sync: {
+        mode: "match";
+        match: {
+            method: string;
+            hasQueryParam: string;
+        }[];
+    };
+};
+declare let getMetaWebhookVerificationResponse: (request: Request, expectedVerifyToken: string | undefined) => SlateWebhookHttpResponseInit | null;
+
+export { type ApiErrorBuildHelpers, type ApiErrorDetailOptions, type ApiErrorResponse, type ApiErrorStatus, type ApiServiceError, type BuildApiServiceErrorOptions, type CreateHmacSignatureOptions, 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 SlateAttachment, type SlateAttachmentInlineContent, 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 SlateDocsReference, SlateError, type SlateErrorInput, type SlateErrorIssue, type SlateErrorKind, type SlateErrorProviderInfo, type SlateErrorResponse, type SlateErrorUpstreamInfo, type SlateLogEntry, type SlateLogFields, type SlateLogListener, type SlateLogMessageInput, type SlateLogType, SlateLogger, type SlatePollingOptions, type SlateProviderDocsReference, SlatePublicContext, SlatePublicTool, type SlatePublicToolInvocationHandler, type SlatePublicToolParameters, type SlateServiceErrorData, SlateSpecification, type SlateSpecificationCreateParameters, type SlateSpecificationParameters, SlateTool, type SlateToolInvocationHandler, type SlateToolParameters, SlateTrigger, type SlateTriggerMappingHandler, type SlateTriggerParameters, type SlateTriggerPollingHandler, type SlateTriggerWebhookAutoRegistrationHandler, type SlateTriggerWebhookAutoUnregistrationHandler, type SlateTriggerWebhookRequestHandler, type SlateTypedDocsReference, type SlateWebhookHttpMethod, type SlateWebhookHttpOptions, type SlateWebhookHttpResponseInit, type SlateWebhookRequestMatcher, type VerifyHmacSignatureOptions, adapterSpec, allOf, anyOf, auth, axios, buildApiServiceError, collectApiErrorDetails, config, createApiServiceError, createAuthenticatedAxios, createAxios, createBase64Attachment, createHmacSignature, createSlateError, createTextAttachment, createUrlAttachment, extractApiErrorMessage, getApiErrorResponse, getApiErrorStatus, getBase64ByteLength, getCurrentContext, getGraphWebhookValidationResponse, getMetaWebhookVerificationResponse, getOAuthExpiresAtFromExpiresIn, getResponseHeaderValue, getServiceErrorData, graphWebhookHttp, inferSlateErrorFromAxios, isApiErrorRecord, isAxiosErrorLike, isServiceErrorData, mapServiceErrorCode, mapServiceErrorToSlateErrorInput, mergeScopes, metaWebhookHttp, normalizeOAuthTokenResponse, pickDefined, publicTool, requestAxios, requestAxiosData, runWithContext, scopeClause, setIfDefined, spec, statusLabelForApiError, tool, trigger, validateScopes, verifyHmacSignature };