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

package/dist/index.d.cts

@@ -2,6 +2,66 @@ import z, { z as z$1 } from 'zod';
 import { AxiosResponse, AxiosError, CreateAxiosDefaults, AxiosInstance } from 'axios';
 import { ServiceError, ErrorRecord, ErrorData } from '@lowerdeck/error';
 
+interface SlateAttachmentUrlContent {
+    type: 'url';
+    url: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    refreshReference?: unknown;
+    refreshAt?: string;
+}
+interface SlateAttachmentInlineContent {
+    type: 'content';
+    encoding: 'base64' | 'utf-8';
+    content: string;
+}
+interface SlateAttachmentUploadReferenceContent {
+    type: 'upload_reference';
+    referenceId: string;
+}
+interface SlateAttachment {
+    mimeType?: string;
+    attachmentHash?: string;
+    content: SlateAttachmentUrlContent | SlateAttachmentInlineContent | SlateAttachmentUploadReferenceContent;
+}
+declare let createUrlAttachment: (url: string, opts?: {
+    mimeType?: string;
+    attachmentHash?: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    refreshReference?: unknown;
+    refreshAt?: string;
+}) => SlateAttachment;
+declare let createBase64Attachment: (content: string, mimeType?: string, attachmentHash?: string) => SlateAttachment;
+declare let createTextAttachment: (content: string, mimeType?: string, attachmentHash?: string) => SlateAttachment;
+
+/**
+ * Placeholder prefix used to mark a redacted auth-config secret. Must match the hub's
+ * AuthConfigSecretSerializer (oss/src/slates/apps/hub/src/lib/secretSerializer.ts) exactly --
+ * the hub resolves these placeholders back to live secret values when it proxies an attachment.
+ */
+declare let AUTH_CONFIG_SECRET_PLACEHOLDER_PREFIX: string;
+/**
+ * Walks an auth config object and replaces any string value that exactly matches one of its
+ * leaf values with a `$$MT$secret$authConfig$<path>` placeholder. Literal, whole-value
+ * substitution only -- not a substring scan, and not a heuristic key-name/value-shape guess
+ * like the http trace redactor in '../axios/trace'.
+ */
+declare class AuthConfigSecretRedactor {
+    private readonly secretToPlaceholder;
+    constructor(authConfig: Record<string, unknown> | undefined);
+    redact<T>(value: T): T;
+    private buildSecretMap;
+    private transform;
+    private isPlainObject;
+}
+/**
+ * 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.
+ */
+declare let redactUrlAttachmentSecrets: (attachments: SlateAttachment[] | undefined, authConfig: Record<string, unknown> | undefined) => SlateAttachment[] | undefined;
+
 interface SlateHttpTraceTextBody {
     contentType?: string;
     text: string;
@@ -28,6 +88,19 @@ interface SlateHttpTrace {
     };
 }
 
+interface SlateLiveInvocationInfo {
+    token: string;
+    baseUrl: string;
+    maxAttachmentSizeBytes: number;
+}
+interface SlateDirectUploadInput {
+    live: SlateLiveInvocationInfo;
+    mimeType?: string;
+    filename?: string;
+    body: ReadableStream<Uint8Array> | Uint8Array;
+}
+declare let uploadAttachmentDirect: (d: SlateDirectUploadInput) => Promise<SlateAttachment>;
+
 type SlateLogType = 'info' | 'warn' | 'error' | 'progress';
 type SlateLogFields = Record<string, unknown>;
 type SlateLogMessageInput = string | Error | boolean | number | null | undefined | object | SlateLogMessageInput[];
@@ -74,7 +147,6 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
     scopes: {
         title: string;
         description?: string;
-        defaultChecked?: boolean;
         scope: string;
     }[];
     docs?: SlateAuthDocsReference[];
@@ -358,11 +430,27 @@ declare class SlateSpecification<ConfigType extends {}, AuthType extends {}> {
 }
 declare let spec: <ConfigType extends {}, AuthType extends {}>(params: SlateSpecificationCreateParameters<ConfigType, AuthType>) => SlateSpecification<ConfigType, AuthType>;
 
+type SlateAddAttachmentContent = Buffer | Uint8Array | ArrayBuffer | ReadableStream<Uint8Array> | NodeJS.ReadableStream | Response;
+type SlateAddAttachmentInput = {
+    type: 'url';
+    url: string | URL;
+    mimeType?: string;
+    filename?: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    refreshReference?: unknown;
+    refreshAt?: string;
+} | {
+    type: 'content';
+    content: SlateAddAttachmentContent;
+    mimeType?: string;
+    filename?: string;
+};
 declare class SlatePublicContext<InputType extends {}> {
     #private;
     private readonly spec;
     private readonly logger;
-    constructor(input: InputType, spec: SlateSpecification<any, any>, logger: SlateLogger);
+    constructor(input: InputType, spec: SlateSpecification<any, any>, logger: SlateLogger, liveInvocation?: SlateLiveInvocationInfo | null);
     get specification(): SlateSpecification<any, any>;
     get input(): Readonly<InputType>;
     get event(): Readonly<InputType>;
@@ -394,34 +482,21 @@ declare class SlatePublicContext<InputType extends {}> {
     warn(message: SlateLogMessageInput): void;
     error(message: SlateLogMessageInput): void;
     progress(message: SlateLogMessageInput): void;
+    addAttachment(input: SlateAddAttachmentInput): Promise<void>;
+    _finalizeAttachments(): Promise<SlateAttachment[]>;
+    _getAuthConfigForRedaction(): Record<string, unknown> | undefined;
 }
 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);
+    constructor(config: ConfigType, input: InputType, auth: AuthType, spec: SlateSpecification<ConfigType, AuthType>, logger: SlateLogger, liveInvocation?: SlateLiveInvocationInfo | null);
     get config(): Readonly<ConfigType>;
     get auth(): Readonly<AuthType>;
+    _getAuthConfigForRedaction(): Record<string, unknown> | undefined;
 }
 
 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 {
-    type: 'url';
-    url: string;
-}
-interface SlateAttachmentInlineContent {
-    type: 'content';
-    encoding: 'base64' | 'utf-8';
-    content: string;
-}
-interface SlateAttachment {
-    mimeType?: string;
-    content: SlateAttachmentUrlContent | SlateAttachmentInlineContent;
-}
-declare let createUrlAttachment: (url: string, mimeType?: string) => SlateAttachment;
-declare let createBase64Attachment: (content: string, mimeType?: string) => SlateAttachment;
-declare let createTextAttachment: (content: string, mimeType?: string) => SlateAttachment;
-
 type SlateActionType = 'tool' | 'trigger';
 interface SlateActionScopeClause {
     OR: string[];
@@ -616,6 +691,22 @@ declare class SlateTool<ConfigType extends {}, AuthType extends {}, InputType ex
 }
 declare let tool: <ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters) => SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<ConfigType, AuthType, any, any>, false>;
 
+declare let GET_FILE_URL_TOOL_ID: string;
+declare let getFileUrlToolInputSchema: z$1.ZodObject<{
+    url: z$1.ZodString;
+    reference: z$1.ZodNullable<z$1.ZodAny>;
+}, z$1.core.$strip>;
+type GetFileUrlToolInput = z$1.infer<typeof getFileUrlToolInputSchema>;
+declare let getFileUrlToolOutputSchema: z$1.ZodObject<{
+    url: z$1.ZodString;
+    expiresAt: z$1.ZodString;
+    headers: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>;
+    query: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>;
+}, z$1.core.$strip>;
+type GetFileUrlToolOutput = z$1.infer<typeof getFileUrlToolOutputSchema>;
+type GetFileUrlHandler<ConfigType extends {}, AuthType extends {}> = (context: SlateContext<ConfigType, AuthType, GetFileUrlToolInput>) => Promise<GetFileUrlToolOutput>;
+declare let getFileUrlTool: <ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, handleGetFileUrl: GetFileUrlHandler<ConfigType, AuthType>) => SlateTool<ConfigType, AuthType, any, any>;
+
 interface SlatePublicToolParameters<InputType extends {}, OutputType extends {}> extends SlateActionParameters {
     handleInvocation: SlatePublicToolInvocationHandler<InputType, OutputType>;
 }
@@ -914,7 +1005,7 @@ declare const graphWebhookHttp: {
 declare let getGraphWebhookValidationResponse: (request: Request) => SlateWebhookHttpResponseInit | null;
 
 declare const metaWebhookHttp: {
-    methods: ("GET" | "POST")[];
+    methods: ("POST" | "GET")[];
     sync: {
         mode: "match";
         match: {
@@ -925,4 +1016,4 @@ declare const metaWebhookHttp: {
 };
 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 };
+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 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, 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, spec, statusLabelForApiError, tool, trigger, uploadAttachmentDirect, validateScopes, verifyHmacSignature };

package/dist/index.d.ts

@@ -2,6 +2,66 @@ import z, { z as z$1 } from 'zod';
 import { AxiosResponse, AxiosError, CreateAxiosDefaults, AxiosInstance } from 'axios';
 import { ServiceError, ErrorRecord, ErrorData } from '@lowerdeck/error';
 
+interface SlateAttachmentUrlContent {
+    type: 'url';
+    url: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    refreshReference?: unknown;
+    refreshAt?: string;
+}
+interface SlateAttachmentInlineContent {
+    type: 'content';
+    encoding: 'base64' | 'utf-8';
+    content: string;
+}
+interface SlateAttachmentUploadReferenceContent {
+    type: 'upload_reference';
+    referenceId: string;
+}
+interface SlateAttachment {
+    mimeType?: string;
+    attachmentHash?: string;
+    content: SlateAttachmentUrlContent | SlateAttachmentInlineContent | SlateAttachmentUploadReferenceContent;
+}
+declare let createUrlAttachment: (url: string, opts?: {
+    mimeType?: string;
+    attachmentHash?: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    refreshReference?: unknown;
+    refreshAt?: string;
+}) => SlateAttachment;
+declare let createBase64Attachment: (content: string, mimeType?: string, attachmentHash?: string) => SlateAttachment;
+declare let createTextAttachment: (content: string, mimeType?: string, attachmentHash?: string) => SlateAttachment;
+
+/**
+ * Placeholder prefix used to mark a redacted auth-config secret. Must match the hub's
+ * AuthConfigSecretSerializer (oss/src/slates/apps/hub/src/lib/secretSerializer.ts) exactly --
+ * the hub resolves these placeholders back to live secret values when it proxies an attachment.
+ */
+declare let AUTH_CONFIG_SECRET_PLACEHOLDER_PREFIX: string;
+/**
+ * Walks an auth config object and replaces any string value that exactly matches one of its
+ * leaf values with a `$$MT$secret$authConfig$<path>` placeholder. Literal, whole-value
+ * substitution only -- not a substring scan, and not a heuristic key-name/value-shape guess
+ * like the http trace redactor in '../axios/trace'.
+ */
+declare class AuthConfigSecretRedactor {
+    private readonly secretToPlaceholder;
+    constructor(authConfig: Record<string, unknown> | undefined);
+    redact<T>(value: T): T;
+    private buildSecretMap;
+    private transform;
+    private isPlainObject;
+}
+/**
+ * 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.
+ */
+declare let redactUrlAttachmentSecrets: (attachments: SlateAttachment[] | undefined, authConfig: Record<string, unknown> | undefined) => SlateAttachment[] | undefined;
+
 interface SlateHttpTraceTextBody {
     contentType?: string;
     text: string;
@@ -28,6 +88,19 @@ interface SlateHttpTrace {
     };
 }
 
+interface SlateLiveInvocationInfo {
+    token: string;
+    baseUrl: string;
+    maxAttachmentSizeBytes: number;
+}
+interface SlateDirectUploadInput {
+    live: SlateLiveInvocationInfo;
+    mimeType?: string;
+    filename?: string;
+    body: ReadableStream<Uint8Array> | Uint8Array;
+}
+declare let uploadAttachmentDirect: (d: SlateDirectUploadInput) => Promise<SlateAttachment>;
+
 type SlateLogType = 'info' | 'warn' | 'error' | 'progress';
 type SlateLogFields = Record<string, unknown>;
 type SlateLogMessageInput = string | Error | boolean | number | null | undefined | object | SlateLogMessageInput[];
@@ -74,7 +147,6 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
     scopes: {
         title: string;
         description?: string;
-        defaultChecked?: boolean;
         scope: string;
     }[];
     docs?: SlateAuthDocsReference[];
@@ -358,11 +430,27 @@ declare class SlateSpecification<ConfigType extends {}, AuthType extends {}> {
 }
 declare let spec: <ConfigType extends {}, AuthType extends {}>(params: SlateSpecificationCreateParameters<ConfigType, AuthType>) => SlateSpecification<ConfigType, AuthType>;
 
+type SlateAddAttachmentContent = Buffer | Uint8Array | ArrayBuffer | ReadableStream<Uint8Array> | NodeJS.ReadableStream | Response;
+type SlateAddAttachmentInput = {
+    type: 'url';
+    url: string | URL;
+    mimeType?: string;
+    filename?: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    refreshReference?: unknown;
+    refreshAt?: string;
+} | {
+    type: 'content';
+    content: SlateAddAttachmentContent;
+    mimeType?: string;
+    filename?: string;
+};
 declare class SlatePublicContext<InputType extends {}> {
     #private;
     private readonly spec;
     private readonly logger;
-    constructor(input: InputType, spec: SlateSpecification<any, any>, logger: SlateLogger);
+    constructor(input: InputType, spec: SlateSpecification<any, any>, logger: SlateLogger, liveInvocation?: SlateLiveInvocationInfo | null);
     get specification(): SlateSpecification<any, any>;
     get input(): Readonly<InputType>;
     get event(): Readonly<InputType>;
@@ -394,34 +482,21 @@ declare class SlatePublicContext<InputType extends {}> {
     warn(message: SlateLogMessageInput): void;
     error(message: SlateLogMessageInput): void;
     progress(message: SlateLogMessageInput): void;
+    addAttachment(input: SlateAddAttachmentInput): Promise<void>;
+    _finalizeAttachments(): Promise<SlateAttachment[]>;
+    _getAuthConfigForRedaction(): Record<string, unknown> | undefined;
 }
 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);
+    constructor(config: ConfigType, input: InputType, auth: AuthType, spec: SlateSpecification<ConfigType, AuthType>, logger: SlateLogger, liveInvocation?: SlateLiveInvocationInfo | null);
     get config(): Readonly<ConfigType>;
     get auth(): Readonly<AuthType>;
+    _getAuthConfigForRedaction(): Record<string, unknown> | undefined;
 }
 
 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 {
-    type: 'url';
-    url: string;
-}
-interface SlateAttachmentInlineContent {
-    type: 'content';
-    encoding: 'base64' | 'utf-8';
-    content: string;
-}
-interface SlateAttachment {
-    mimeType?: string;
-    content: SlateAttachmentUrlContent | SlateAttachmentInlineContent;
-}
-declare let createUrlAttachment: (url: string, mimeType?: string) => SlateAttachment;
-declare let createBase64Attachment: (content: string, mimeType?: string) => SlateAttachment;
-declare let createTextAttachment: (content: string, mimeType?: string) => SlateAttachment;
-
 type SlateActionType = 'tool' | 'trigger';
 interface SlateActionScopeClause {
     OR: string[];
@@ -616,6 +691,22 @@ declare class SlateTool<ConfigType extends {}, AuthType extends {}, InputType ex
 }
 declare let tool: <ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, params: SlateActionParameters) => SlateActionBuilder<"tool", ConfigType, AuthType, {}, {}, SlateTool<ConfigType, AuthType, any, any>, false>;
 
+declare let GET_FILE_URL_TOOL_ID: string;
+declare let getFileUrlToolInputSchema: z$1.ZodObject<{
+    url: z$1.ZodString;
+    reference: z$1.ZodNullable<z$1.ZodAny>;
+}, z$1.core.$strip>;
+type GetFileUrlToolInput = z$1.infer<typeof getFileUrlToolInputSchema>;
+declare let getFileUrlToolOutputSchema: z$1.ZodObject<{
+    url: z$1.ZodString;
+    expiresAt: z$1.ZodString;
+    headers: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>;
+    query: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>;
+}, z$1.core.$strip>;
+type GetFileUrlToolOutput = z$1.infer<typeof getFileUrlToolOutputSchema>;
+type GetFileUrlHandler<ConfigType extends {}, AuthType extends {}> = (context: SlateContext<ConfigType, AuthType, GetFileUrlToolInput>) => Promise<GetFileUrlToolOutput>;
+declare let getFileUrlTool: <ConfigType extends {}, AuthType extends {}>(spec: SlateSpecification<ConfigType, AuthType>, handleGetFileUrl: GetFileUrlHandler<ConfigType, AuthType>) => SlateTool<ConfigType, AuthType, any, any>;
+
 interface SlatePublicToolParameters<InputType extends {}, OutputType extends {}> extends SlateActionParameters {
     handleInvocation: SlatePublicToolInvocationHandler<InputType, OutputType>;
 }
@@ -914,7 +1005,7 @@ declare const graphWebhookHttp: {
 declare let getGraphWebhookValidationResponse: (request: Request) => SlateWebhookHttpResponseInit | null;
 
 declare const metaWebhookHttp: {
-    methods: ("GET" | "POST")[];
+    methods: ("POST" | "GET")[];
     sync: {
         mode: "match";
         match: {
@@ -925,4 +1016,4 @@ declare const metaWebhookHttp: {
 };
 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 };
+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 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, 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, spec, statusLabelForApiError, tool, trigger, uploadAttachmentDirect, validateScopes, verifyHmacSignature };