@slates/provider 1.0.0-rc.11 → 1.0.0-rc.14

package/dist/index.cjs

@@ -126,7 +126,10 @@ var import_axios = require("axios");
 
 // src/context/hook.ts
 var import_async_hooks = require("async_hooks");
-var asyncLocalStorage = new import_async_hooks.AsyncLocalStorage();
+var slateContextStorageKey = /* @__PURE__ */ Symbol.for("slates.provider.context.asyncLocalStorage");
+var globalWithSlateContext = globalThis;
+var asyncLocalStorage = globalWithSlateContext[slateContextStorageKey] ?? new import_async_hooks.AsyncLocalStorage();
+globalWithSlateContext[slateContextStorageKey] = asyncLocalStorage;
 var runWithContext = (context, fn) => {
   return asyncLocalStorage.run(context, fn);
 };
@@ -230,7 +233,7 @@ var normalizeRetryable = (code, retryable) => {
   return code === "request.rate_limited" || code === "upstream.rate_limited" || code === "upstream.timeout" || code === "upstream.network_error" || code === "upstream.unavailable" || code === "upstream.error" || code === "transport.invoke_failed" || code === "internal.timeout";
 };
 var getDefaultMessage = (code, message) => {
-  if (message && message.trim()) return message;
+  if (message?.trim()) return message;
   return DEFAULT_MESSAGES[code] ?? DEFAULT_MESSAGES[DEFAULT_CODE];
 };
 var cleanRecord = (value) => {
@@ -507,7 +510,9 @@ var normalizeServiceErrorIssues = (errors) => {
   return issues.length > 0 ? issues : void 0;
 };
 var getServiceErrorBaggage = (data) => {
-  let extraEntries = Object.entries(data).filter(([key]) => !SERVICE_ERROR_DATA_RESERVED_KEYS.has(key));
+  let extraEntries = Object.entries(data).filter(
+    ([key]) => !SERVICE_ERROR_DATA_RESERVED_KEYS.has(key)
+  );
   return cleanRecord({
     serviceError: {
       code: data.code,
@@ -725,7 +730,9 @@ var normalizeClause = (input) => {
 };
 var assertScopeValues = (scopes) => {
   if (scopes.length === 0) {
-    throw new SlateDeclarationError("Each action scope clause must include at least one OR scope");
+    throw new SlateDeclarationError(
+      "Each action scope clause must include at least one OR scope"
+    );
   }
   for (let scope of scopes) {
     if (typeof scope !== "string" || scope.trim().length === 0) {
@@ -1131,15 +1138,9 @@ var CORE_SECRET_KEY_ATOMS = [
   "license[-_.]?key"
 ];
 var URL_FORM_SECRET_KEY_ATOMS = [...CORE_SECRET_KEY_ATOMS, "code"];
-var buildKeyBoundaryPattern = (atoms, flags) => new RegExp(
-  `(?:^|[^A-Za-z0-9])(?:${atoms.join("|")})(?=[^A-Za-z0-9]|$)`,
-  flags
-);
+var buildKeyBoundaryPattern = (atoms, flags) => new RegExp(`(?:^|[^A-Za-z0-9])(?:${atoms.join("|")})(?=[^A-Za-z0-9]|$)`, flags);
 var SECRET_KEY_PATTERN = buildKeyBoundaryPattern(CORE_SECRET_KEY_ATOMS, "i");
-var URL_FORM_SECRET_KEY_PATTERN = buildKeyBoundaryPattern(
-  URL_FORM_SECRET_KEY_ATOMS,
-  "i"
-);
+var URL_FORM_SECRET_KEY_PATTERN = buildKeyBoundaryPattern(URL_FORM_SECRET_KEY_ATOMS, "i");
 var NON_SECRET_KEY_EXACT = /* @__PURE__ */ new Set([
   "token_type",
   "token-type",
@@ -1317,7 +1318,7 @@ var redactStructuredValue = (value, depth = 0) => {
 var maybeParseJson = (text, contentType) => {
   let trimmed = text.trim();
   if (!trimmed) return null;
-  if (!contentType?.includes("json") && !/^[\[{]/.test(trimmed)) {
+  if (!contentType?.includes("json") && !/^[[{]/.test(trimmed)) {
     return null;
   }
   try {
@@ -1377,7 +1378,7 @@ var buildUrl = (baseURL, url) => {
 var REDACTED_ENCODED = encodeURIComponent(REDACTED_VALUE);
 var decodeRedactedMarker = (value) => REDACTED_ENCODED === REDACTED_VALUE ? value : value.split(REDACTED_ENCODED).join(REDACTED_VALUE);
 var redactHashFragment = (hash) => {
-  if (!hash || !hash.includes("=")) return hash;
+  if (!hash?.includes("=")) return hash;
   let withoutHash = hash.startsWith("#") ? hash.slice(1) : hash;
   let redacted = withoutHash.replace(
     /(?<![A-Za-z0-9])([A-Za-z0-9][A-Za-z0-9_\-.]*)=([^&]*)/g,
@@ -1455,7 +1456,7 @@ var takeTraceDraft = (config2) => {
 var clearTraceDraft = (config2, draft) => {
   if (!config2) return;
   if (config2.__slatesHttpTraceDraft === draft) {
-    delete config2.__slatesHttpTraceDraft;
+    config2.__slatesHttpTraceDraft = void 0;
   }
   if (isObjectLike(config2)) {
     traceDraftsByConfig.delete(config2);

package/dist/index.d.cts

@@ -50,6 +50,7 @@ declare class SlateLogger {
     progress(...message: SlateLogMessageInput[]): void;
 }
 
+type SlateAuthCallbackConfig = Record<string, any>;
 type SlateAuthWithOauth<InputType extends {}, OutputType extends {
     token: string;
     refreshToken?: string;
@@ -64,6 +65,10 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         defaultChecked?: boolean;
         scope: string;
     }[];
+    docs?: {
+        oauthDocsLink?: string;
+        oauthScopesLink?: string;
+    };
     inputSchema?: z.ZodType<InputType>;
     onInputChanged?: (params: {
         previousInput: InputType | null;
@@ -79,6 +84,7 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         clientId: string;
         clientSecret: string;
         scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         url: string;
         input?: InputType;
@@ -92,7 +98,9 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         clientId: string;
         clientSecret: string;
         scopes: string[];
+        callbackParams?: Record<string, string>;
         callbackState: Record<string, any>;
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         output: OutputType;
         input?: InputType;
@@ -104,6 +112,7 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         clientId: string;
         clientSecret: string;
         scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         output: OutputType;
         input?: InputType;
@@ -112,6 +121,7 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         output: OutputType;
         input: InputType;
         scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         profile: Record<string, any>;
     }>;
@@ -123,6 +133,9 @@ type SlateAuthWithToken<InputType extends {}, OutputType extends {
     name: string;
     key: string;
     inputSchema?: z.ZodType<InputType>;
+    docs?: {
+        tokenDocsLink?: string;
+    };
     getOutput: (ctx: {
         input: InputType;
     }) => Promise<{
@@ -147,6 +160,9 @@ type SlateAuthWithServiceAccount<InputType extends {}, OutputType extends {}> =
     name: string;
     key: string;
     inputSchema?: z.ZodType<InputType>;
+    docs?: {
+        serviceAccountDocsLink?: string;
+    };
     getOutput: (ctx: {
         input: InputType;
     }) => Promise<{
@@ -171,6 +187,9 @@ type SlateAuthWithCustomData<InputType extends {}, OutputType extends {}> = {
     name: string;
     key: string;
     inputSchema?: z.ZodType<InputType>;
+    docs?: {
+        customAuthDocsLink?: string;
+    };
     getOutput: (ctx: {
         input: InputType;
     }) => Promise<{
@@ -454,15 +473,6 @@ declare abstract class SlateAction<Type extends SlateActionType, ConfigType exte
     get scopes(): SlateActionScopes | undefined;
 }
 
-type SlateActionScopeValue = string;
-type SlateActionScopeClauseInput = SlateActionScopeValue | readonly SlateActionScopeValue[] | SlateActionScopeClause;
-type SlateActionScopesInput = SlateActionScopeClauseInput | SlateActionScopes;
-declare let scopeClause: (...scopes: SlateActionScopeValue[]) => SlateActionScopeClause;
-declare let anyOf: (...scopes: SlateActionScopeValue[]) => SlateActionScopes;
-declare let allOf: (...inputs: SlateActionScopesInput[]) => SlateActionScopes;
-declare let mergeScopes: (...inputs: Array<SlateActionScopes | null | undefined | false>) => SlateActionScopes | undefined;
-declare let validateScopes: (scopes: SlateActionScopes) => SlateActionScopes;
-
 declare class SlateActionBuilder<Type extends SlateActionType, ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}, Result extends SlateAction<Type, ConfigType, AuthType, any, any>> {
     #private;
     private readonly type;
@@ -488,6 +498,15 @@ declare class SlateActionBuilder<Type extends SlateActionType, ConfigType extend
     build(): Result;
 }
 
+type SlateActionScopeValue = string;
+type SlateActionScopeClauseInput = SlateActionScopeValue | readonly SlateActionScopeValue[] | SlateActionScopeClause;
+type SlateActionScopesInput = SlateActionScopeClauseInput | SlateActionScopes;
+declare let scopeClause: (...scopes: SlateActionScopeValue[]) => SlateActionScopeClause;
+declare let anyOf: (...scopes: SlateActionScopeValue[]) => SlateActionScopes;
+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>;
 }
@@ -584,7 +603,7 @@ interface SlateErrorInput extends Omit<SlateErrorResponse, 'kind'> {
 interface SlateAxiosErrorOptions {
     defaults?: Partial<SlateErrorResponse>;
     extractResponseData?: (response: AxiosResponse) => unknown;
-    mapAxiosError?: (error: AxiosError, inferred: SlateErrorResponse) => SlateError | Partial<SlateErrorResponse> | void;
+    mapAxiosError?: (error: AxiosError, inferred: SlateErrorResponse) => SlateError | Partial<SlateErrorResponse> | undefined;
 }
 interface SlateServiceErrorData {
     status: number;

package/dist/index.d.ts

@@ -50,6 +50,7 @@ declare class SlateLogger {
     progress(...message: SlateLogMessageInput[]): void;
 }
 
+type SlateAuthCallbackConfig = Record<string, any>;
 type SlateAuthWithOauth<InputType extends {}, OutputType extends {
     token: string;
     refreshToken?: string;
@@ -64,6 +65,10 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         defaultChecked?: boolean;
         scope: string;
     }[];
+    docs?: {
+        oauthDocsLink?: string;
+        oauthScopesLink?: string;
+    };
     inputSchema?: z.ZodType<InputType>;
     onInputChanged?: (params: {
         previousInput: InputType | null;
@@ -79,6 +84,7 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         clientId: string;
         clientSecret: string;
         scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         url: string;
         input?: InputType;
@@ -92,7 +98,9 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         clientId: string;
         clientSecret: string;
         scopes: string[];
+        callbackParams?: Record<string, string>;
         callbackState: Record<string, any>;
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         output: OutputType;
         input?: InputType;
@@ -104,6 +112,7 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         clientId: string;
         clientSecret: string;
         scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         output: OutputType;
         input?: InputType;
@@ -112,6 +121,7 @@ type SlateAuthWithOauth<InputType extends {}, OutputType extends {
         output: OutputType;
         input: InputType;
         scopes: string[];
+        config?: SlateAuthCallbackConfig;
     }) => Promise<{
         profile: Record<string, any>;
     }>;
@@ -123,6 +133,9 @@ type SlateAuthWithToken<InputType extends {}, OutputType extends {
     name: string;
     key: string;
     inputSchema?: z.ZodType<InputType>;
+    docs?: {
+        tokenDocsLink?: string;
+    };
     getOutput: (ctx: {
         input: InputType;
     }) => Promise<{
@@ -147,6 +160,9 @@ type SlateAuthWithServiceAccount<InputType extends {}, OutputType extends {}> =
     name: string;
     key: string;
     inputSchema?: z.ZodType<InputType>;
+    docs?: {
+        serviceAccountDocsLink?: string;
+    };
     getOutput: (ctx: {
         input: InputType;
     }) => Promise<{
@@ -171,6 +187,9 @@ type SlateAuthWithCustomData<InputType extends {}, OutputType extends {}> = {
     name: string;
     key: string;
     inputSchema?: z.ZodType<InputType>;
+    docs?: {
+        customAuthDocsLink?: string;
+    };
     getOutput: (ctx: {
         input: InputType;
     }) => Promise<{
@@ -454,15 +473,6 @@ declare abstract class SlateAction<Type extends SlateActionType, ConfigType exte
     get scopes(): SlateActionScopes | undefined;
 }
 
-type SlateActionScopeValue = string;
-type SlateActionScopeClauseInput = SlateActionScopeValue | readonly SlateActionScopeValue[] | SlateActionScopeClause;
-type SlateActionScopesInput = SlateActionScopeClauseInput | SlateActionScopes;
-declare let scopeClause: (...scopes: SlateActionScopeValue[]) => SlateActionScopeClause;
-declare let anyOf: (...scopes: SlateActionScopeValue[]) => SlateActionScopes;
-declare let allOf: (...inputs: SlateActionScopesInput[]) => SlateActionScopes;
-declare let mergeScopes: (...inputs: Array<SlateActionScopes | null | undefined | false>) => SlateActionScopes | undefined;
-declare let validateScopes: (scopes: SlateActionScopes) => SlateActionScopes;
-
 declare class SlateActionBuilder<Type extends SlateActionType, ConfigType extends {}, AuthType extends {}, InputType extends {}, OutputType extends {}, Result extends SlateAction<Type, ConfigType, AuthType, any, any>> {
     #private;
     private readonly type;
@@ -488,6 +498,15 @@ declare class SlateActionBuilder<Type extends SlateActionType, ConfigType extend
     build(): Result;
 }
 
+type SlateActionScopeValue = string;
+type SlateActionScopeClauseInput = SlateActionScopeValue | readonly SlateActionScopeValue[] | SlateActionScopeClause;
+type SlateActionScopesInput = SlateActionScopeClauseInput | SlateActionScopes;
+declare let scopeClause: (...scopes: SlateActionScopeValue[]) => SlateActionScopeClause;
+declare let anyOf: (...scopes: SlateActionScopeValue[]) => SlateActionScopes;
+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>;
 }
@@ -584,7 +603,7 @@ interface SlateErrorInput extends Omit<SlateErrorResponse, 'kind'> {
 interface SlateAxiosErrorOptions {
     defaults?: Partial<SlateErrorResponse>;
     extractResponseData?: (response: AxiosResponse) => unknown;
-    mapAxiosError?: (error: AxiosError, inferred: SlateErrorResponse) => SlateError | Partial<SlateErrorResponse> | void;
+    mapAxiosError?: (error: AxiosError, inferred: SlateErrorResponse) => SlateError | Partial<SlateErrorResponse> | undefined;
 }
 interface SlateServiceErrorData {
     status: number;

package/dist/index.module.js

@@ -55,7 +55,10 @@ import { isAxiosError } from "axios";
 
 // src/context/hook.ts
 import { AsyncLocalStorage } from "async_hooks";
-var asyncLocalStorage = new AsyncLocalStorage();
+var slateContextStorageKey = /* @__PURE__ */ Symbol.for("slates.provider.context.asyncLocalStorage");
+var globalWithSlateContext = globalThis;
+var asyncLocalStorage = globalWithSlateContext[slateContextStorageKey] ?? new AsyncLocalStorage();
+globalWithSlateContext[slateContextStorageKey] = asyncLocalStorage;
 var runWithContext = (context, fn) => {
   return asyncLocalStorage.run(context, fn);
 };
@@ -159,7 +162,7 @@ var normalizeRetryable = (code, retryable) => {
   return code === "request.rate_limited" || code === "upstream.rate_limited" || code === "upstream.timeout" || code === "upstream.network_error" || code === "upstream.unavailable" || code === "upstream.error" || code === "transport.invoke_failed" || code === "internal.timeout";
 };
 var getDefaultMessage = (code, message) => {
-  if (message && message.trim()) return message;
+  if (message?.trim()) return message;
   return DEFAULT_MESSAGES[code] ?? DEFAULT_MESSAGES[DEFAULT_CODE];
 };
 var cleanRecord = (value) => {
@@ -436,7 +439,9 @@ var normalizeServiceErrorIssues = (errors) => {
   return issues.length > 0 ? issues : void 0;
 };
 var getServiceErrorBaggage = (data) => {
-  let extraEntries = Object.entries(data).filter(([key]) => !SERVICE_ERROR_DATA_RESERVED_KEYS.has(key));
+  let extraEntries = Object.entries(data).filter(
+    ([key]) => !SERVICE_ERROR_DATA_RESERVED_KEYS.has(key)
+  );
   return cleanRecord({
     serviceError: {
       code: data.code,
@@ -654,7 +659,9 @@ var normalizeClause = (input) => {
 };
 var assertScopeValues = (scopes) => {
   if (scopes.length === 0) {
-    throw new SlateDeclarationError("Each action scope clause must include at least one OR scope");
+    throw new SlateDeclarationError(
+      "Each action scope clause must include at least one OR scope"
+    );
   }
   for (let scope of scopes) {
     if (typeof scope !== "string" || scope.trim().length === 0) {
@@ -1060,15 +1067,9 @@ var CORE_SECRET_KEY_ATOMS = [
   "license[-_.]?key"
 ];
 var URL_FORM_SECRET_KEY_ATOMS = [...CORE_SECRET_KEY_ATOMS, "code"];
-var buildKeyBoundaryPattern = (atoms, flags) => new RegExp(
-  `(?:^|[^A-Za-z0-9])(?:${atoms.join("|")})(?=[^A-Za-z0-9]|$)`,
-  flags
-);
+var buildKeyBoundaryPattern = (atoms, flags) => new RegExp(`(?:^|[^A-Za-z0-9])(?:${atoms.join("|")})(?=[^A-Za-z0-9]|$)`, flags);
 var SECRET_KEY_PATTERN = buildKeyBoundaryPattern(CORE_SECRET_KEY_ATOMS, "i");
-var URL_FORM_SECRET_KEY_PATTERN = buildKeyBoundaryPattern(
-  URL_FORM_SECRET_KEY_ATOMS,
-  "i"
-);
+var URL_FORM_SECRET_KEY_PATTERN = buildKeyBoundaryPattern(URL_FORM_SECRET_KEY_ATOMS, "i");
 var NON_SECRET_KEY_EXACT = /* @__PURE__ */ new Set([
   "token_type",
   "token-type",
@@ -1246,7 +1247,7 @@ var redactStructuredValue = (value, depth = 0) => {
 var maybeParseJson = (text, contentType) => {
   let trimmed = text.trim();
   if (!trimmed) return null;
-  if (!contentType?.includes("json") && !/^[\[{]/.test(trimmed)) {
+  if (!contentType?.includes("json") && !/^[[{]/.test(trimmed)) {
     return null;
   }
   try {
@@ -1306,7 +1307,7 @@ var buildUrl = (baseURL, url) => {
 var REDACTED_ENCODED = encodeURIComponent(REDACTED_VALUE);
 var decodeRedactedMarker = (value) => REDACTED_ENCODED === REDACTED_VALUE ? value : value.split(REDACTED_ENCODED).join(REDACTED_VALUE);
 var redactHashFragment = (hash) => {
-  if (!hash || !hash.includes("=")) return hash;
+  if (!hash?.includes("=")) return hash;
   let withoutHash = hash.startsWith("#") ? hash.slice(1) : hash;
   let redacted = withoutHash.replace(
     /(?<![A-Za-z0-9])([A-Za-z0-9][A-Za-z0-9_\-.]*)=([^&]*)/g,
@@ -1384,7 +1385,7 @@ var takeTraceDraft = (config2) => {
 var clearTraceDraft = (config2, draft) => {
   if (!config2) return;
   if (config2.__slatesHttpTraceDraft === draft) {
-    delete config2.__slatesHttpTraceDraft;
+    config2.__slatesHttpTraceDraft = void 0;
   }
   if (isObjectLike(config2)) {
     traceDraftsByConfig.delete(config2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slates/provider",
-  "version": "1.0.0-rc.11",
+  "version": "1.0.0-rc.14",
   "publishConfig": {
     "access": "public"
   },
@@ -26,9 +26,9 @@
   "unpkg": "./dist/index.module.js",
   "scripts": {
     "test": "vitest run --passWithNoTests",
-    "lint": "prettier src/**/*.ts --check",
     "build": "tsup --config ../../tsup.packages.config.ts --external async_hooks",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "biome:check": "biome check --write src"
   },
   "dependencies": {
     "@lowerdeck/error": "^1.1.0",
@@ -42,4 +42,4 @@
     "typescript": "5.8.2",
     "vitest": "^3.1.2"
   }
-}
+}

package/src/action/builder.ts

@@ -4,10 +4,10 @@ import type { SlateSpecification } from '../specification/specification';
 import type {
   SlateAction,
   SlateActionCreateParameters,
-  SlateActionScopes,
   SlateActionParameters,
   SlateActionParametersTool,
   SlateActionParametersTrigger,
+  SlateActionScopes,
   SlateActionType,
   SlatePollingOptions,
   SlateToolInvocationHandler,

package/src/action/index.ts

@@ -1,5 +1,5 @@
 export * from './action';
-export * from './scopes';
 export type * from './builder';
+export * from './scopes';
 export * from './tool';
 export * from './trigger';

package/src/action/scopes.test.ts

@@ -12,10 +12,7 @@ describe('action scope helpers', () => {
     });
 
     expect(allOf(['scope:calendar'], ['scope:sharing', 'scope:sharing:admin'])).toEqual({
-      AND: [
-        { OR: ['scope:calendar'] },
-        { OR: ['scope:sharing', 'scope:sharing:admin'] }
-      ]
+      AND: [{ OR: ['scope:calendar'] }, { OR: ['scope:sharing', 'scope:sharing:admin'] }]
     });
   });
 
@@ -68,7 +65,9 @@ describe('action scope helpers', () => {
   });
 
   it('throws helpful errors for invalid scope definitions', () => {
-    expect(() => scopeClause()).toThrow('Each action scope clause must include at least one OR scope');
+    expect(() => scopeClause()).toThrow(
+      'Each action scope clause must include at least one OR scope'
+    );
     expect(() => scopeClause('')).toThrow('Action scopes must be non-empty strings');
     expect(() => validateScopes({ AND: [] })).toThrow(
       'Action scopes must include at least one AND clause'

package/src/action/scopes.ts

@@ -78,7 +78,9 @@ let normalizeClause = (input: SlateActionScopeClauseInput): SlateActionScopeClau
 
 let assertScopeValues = (scopes: readonly SlateActionScopeValue[]) => {
   if (scopes.length === 0) {
-    throw new SlateDeclarationError('Each action scope clause must include at least one OR scope');
+    throw new SlateDeclarationError(
+      'Each action scope clause must include at least one OR scope'
+    );
   }
 
   for (let scope of scopes) {

package/src/auth/types.ts

@@ -1,5 +1,7 @@
 import type z from 'zod';
 
+type SlateAuthCallbackConfig = Record<string, any>;
+
 export type SlateAuthWithOauth<
   InputType extends {},
   OutputType extends {
@@ -20,6 +22,11 @@ export type SlateAuthWithOauth<
     scope: string;
   }[];
 
+  docs?: {
+    oauthDocsLink?: string;
+    oauthScopesLink?: string;
+  };
+
   inputSchema?: z.ZodType<InputType>;
 
   onInputChanged?: (params: {
@@ -36,6 +43,7 @@ export type SlateAuthWithOauth<
     clientId: string;
     clientSecret: string;
     scopes: string[];
+    config?: SlateAuthCallbackConfig;
   }) => Promise<{
     url: string;
     input?: InputType;
@@ -50,7 +58,9 @@ export type SlateAuthWithOauth<
     clientId: string;
     clientSecret: string;
     scopes: string[];
+    callbackParams?: Record<string, string>;
     callbackState: Record<string, any>;
+    config?: SlateAuthCallbackConfig;
   }) => Promise<{
     output: OutputType;
     input?: InputType;
@@ -63,12 +73,18 @@ export type SlateAuthWithOauth<
     clientId: string;
     clientSecret: string;
     scopes: string[];
+    config?: SlateAuthCallbackConfig;
   }) => Promise<{
     output: OutputType;
     input?: InputType;
   }>;
 
-  getProfile?: (ctx: { output: OutputType; input: InputType; scopes: string[] }) => Promise<{
+  getProfile?: (ctx: {
+    output: OutputType;
+    input: InputType;
+    scopes: string[];
+    config?: SlateAuthCallbackConfig;
+  }) => Promise<{
     profile: Record<string, any>;
   }>;
 };
@@ -81,6 +97,10 @@ export type SlateAuthWithToken<InputType extends {}, OutputType extends { token?
 
   inputSchema?: z.ZodType<InputType>;
 
+  docs?: {
+    tokenDocsLink?: string;
+  };
+
   getOutput: (ctx: { input: InputType }) => Promise<{ output: OutputType }>;
 
   onInputChanged?: (params: {
@@ -103,6 +123,10 @@ export type SlateAuthWithServiceAccount<InputType extends {}, OutputType extends
 
   inputSchema?: z.ZodType<InputType>;
 
+  docs?: {
+    serviceAccountDocsLink?: string;
+  };
+
   getOutput: (ctx: { input: InputType }) => Promise<{ output: OutputType }>;
 
   onInputChanged?: (params: {
@@ -125,6 +149,10 @@ export type SlateAuthWithCustomData<InputType extends {}, OutputType extends {}>
 
   inputSchema?: z.ZodType<InputType>;
 
+  docs?: {
+    customAuthDocsLink?: string;
+  };
+
   getOutput: (ctx: { input: InputType }) => Promise<{ output: OutputType }>;
 
   handleTokenRefresh?: (ctx: {

package/src/axios/index.ts

@@ -19,7 +19,7 @@ let applySlateInterceptors = (
 ) => {
   instance.interceptors.request.use(
     request => {
-       // Has to be called in the context of an action execution
+      // Has to be called in the context of an action execution
       let ctx = getCurrentContext();
       let spec = ctx.specification;
       let providerToken = spec.key.replace(/[^A-Za-z0-9!#$%&'*+\-.^_`|~]/g, '-');

package/src/axios/trace.test.ts

@@ -174,7 +174,7 @@ describe('sanitizeFreeText', () => {
   });
 
   it('redacts GitHub tokens', () => {
-    let token = 'ghp_' + 'a'.repeat(40);
+    let token = `ghp_${'a'.repeat(40)}`;
     expect(sanitizeFreeText(token)).toBe('[redacted]');
   });
 
@@ -184,22 +184,22 @@ describe('sanitizeFreeText', () => {
   });
 
   it('redacts Stripe secret keys', () => {
-    let key = 'sk_live_' + 'a'.repeat(24);
+    let key = `sk_live_${'a'.repeat(24)}`;
     expect(sanitizeFreeText(`{"key":"${key}"}`)).not.toContain(key);
   });
 
   it('redacts OpenAI API keys', () => {
-    let key = 'sk-proj-' + 'a'.repeat(40);
+    let key = `sk-proj-${'a'.repeat(40)}`;
     expect(sanitizeFreeText(key)).toBe('[redacted]');
   });
 
   it('redacts Anthropic API keys', () => {
-    let key = 'sk-ant-' + 'a'.repeat(40);
+    let key = `sk-ant-${'a'.repeat(40)}`;
     expect(sanitizeFreeText(key)).toBe('[redacted]');
   });
 
   it('redacts Google API keys', () => {
-    let key = 'AIza' + 'a'.repeat(35);
+    let key = `AIza${'a'.repeat(35)}`;
     expect(sanitizeFreeText(key)).toBe('[redacted]');
   });
 
@@ -265,8 +265,7 @@ describe('sanitizeUrl', () => {
   });
 
   it('redacts secrets embedded in URL fragment (OAuth implicit flow)', () => {
-    let input =
-      'https://example.com/cb#access_token=xyz&token_type=bearer&expires_in=3600';
+    let input = 'https://example.com/cb#access_token=xyz&token_type=bearer&expires_in=3600';
     let out = sanitizeUrl(input);
     expect(out).toContain('access_token=[redacted]');
     expect(out).toContain('token_type=bearer');

package/src/axios/trace.ts

@@ -205,16 +205,10 @@ let CORE_SECRET_KEY_ATOMS = [
 let URL_FORM_SECRET_KEY_ATOMS = [...CORE_SECRET_KEY_ATOMS, 'code'];
 
 let buildKeyBoundaryPattern = (atoms: string[], flags: string) =>
-  new RegExp(
-    `(?:^|[^A-Za-z0-9])(?:${atoms.join('|')})(?=[^A-Za-z0-9]|$)`,
-    flags
-  );
+  new RegExp(`(?:^|[^A-Za-z0-9])(?:${atoms.join('|')})(?=[^A-Za-z0-9]|$)`, flags);
 
 let SECRET_KEY_PATTERN = buildKeyBoundaryPattern(CORE_SECRET_KEY_ATOMS, 'i');
-let URL_FORM_SECRET_KEY_PATTERN = buildKeyBoundaryPattern(
-  URL_FORM_SECRET_KEY_ATOMS,
-  'i'
-);
+let URL_FORM_SECRET_KEY_PATTERN = buildKeyBoundaryPattern(URL_FORM_SECRET_KEY_ATOMS, 'i');
 
 // Explicit non-secret keys that would otherwise trip the patterns above because
 // they embed a secret-sounding token (e.g. `token_type` contains `token`).
@@ -307,7 +301,8 @@ let HTTP_AUTH_SCHEME_PATTERN =
 
 // Generic `key=value` scan; the key is filtered via isUrlFormSecretKeyName at replace time
 // so we can apply a deny-list for compound keys like `token_type` or `grant_type`.
-let GENERIC_KEY_VALUE_PATTERN = /(?<![A-Za-z0-9])([A-Za-z0-9][A-Za-z0-9_\-.]*)(\s*=\s*)([^&#\s;]+)/g;
+let GENERIC_KEY_VALUE_PATTERN =
+  /(?<![A-Za-z0-9])([A-Za-z0-9][A-Za-z0-9_\-.]*)(\s*=\s*)([^&#\s;]+)/g;
 
 // Generic `"key": "value"` scan; the key is filtered via isSecretKeyName at replace time.
 let GENERIC_JSON_KEY_VALUE_PATTERN =
@@ -438,9 +433,7 @@ let redactStructuredValue = (value: unknown, depth = 0): unknown => {
         .slice(0, STRUCTURED_ENTRY_LIMIT)
         .map(([key, entry]) => [
           key,
-          isSecretKeyName(key)
-            ? REDACTED_VALUE
-            : redactStructuredValue(entry, depth + 1)
+          isSecretKeyName(key) ? REDACTED_VALUE : redactStructuredValue(entry, depth + 1)
         ])
     );
   }
@@ -451,7 +444,7 @@ let redactStructuredValue = (value: unknown, depth = 0): unknown => {
 let maybeParseJson = (text: string, contentType?: string) => {
   let trimmed = text.trim();
   if (!trimmed) return null;
-  if (!contentType?.includes('json') && !/^[\[{]/.test(trimmed)) {
+  if (!contentType?.includes('json') && !/^[[{]/.test(trimmed)) {
     return null;
   }
 
@@ -541,7 +534,7 @@ let decodeRedactedMarker = (value: string) =>
     : value.split(REDACTED_ENCODED).join(REDACTED_VALUE);
 
 let redactHashFragment = (hash: string) => {
-  if (!hash || !hash.includes('=')) return hash;
+  if (!hash?.includes('=')) return hash;
   let withoutHash = hash.startsWith('#') ? hash.slice(1) : hash;
   let redacted = withoutHash.replace(
     /(?<![A-Za-z0-9])([A-Za-z0-9][A-Za-z0-9_\-.]*)=([^&]*)/g,
@@ -657,7 +650,7 @@ let clearTraceDraft = (
   if (!config) return;
 
   if (config.__slatesHttpTraceDraft === draft) {
-    delete config.__slatesHttpTraceDraft;
+    config.__slatesHttpTraceDraft = undefined;
   }
 
   if (isObjectLike(config)) {

package/src/context/hook.test.ts

@@ -0,0 +1,27 @@
+import { describe, expect, it } from 'vitest';
+import { SlateContext } from './context';
+import { runWithContext } from './hook';
+
+describe('slate context hook', () => {
+  it('shares context storage across duplicate module instances', async () => {
+    // @ts-expect-error Vite treats the query as a distinct module instance.
+    let duplicateHook: typeof import('./hook') = await import('./hook?duplicate-instance');
+    let context = new SlateContext(
+      {},
+      {},
+      {},
+      {} as any,
+      {
+        debug: () => {},
+        error: () => {},
+        info: () => {},
+        progress: () => {},
+        warn: () => {}
+      } as any
+    );
+
+    let result = await runWithContext(context, async () => duplicateHook.getCurrentContext());
+
+    expect(result).toBe(context);
+  });
+});

package/src/context/hook.ts

@@ -1,7 +1,16 @@
 import { AsyncLocalStorage } from 'async_hooks';
 import type { SlateContext } from './context';
 
-let asyncLocalStorage = new AsyncLocalStorage<SlateContext<any, any, any>>();
+let slateContextStorageKey = Symbol.for('slates.provider.context.asyncLocalStorage');
+let globalWithSlateContext = globalThis as typeof globalThis & {
+  [key: symbol]: AsyncLocalStorage<SlateContext<any, any, any>> | undefined;
+};
+
+let asyncLocalStorage =
+  globalWithSlateContext[slateContextStorageKey] ??
+  new AsyncLocalStorage<SlateContext<any, any, any>>();
+
+globalWithSlateContext[slateContextStorageKey] = asyncLocalStorage;
 
 export let runWithContext = <
   ConfigType extends {},

package/src/error/service.ts

@@ -1,8 +1,14 @@
-import { isServiceError } from '@lowerdeck/error';
 import type { ErrorData, ErrorRecord, ServiceError } from '@lowerdeck/error';
+import { isServiceError } from '@lowerdeck/error';
 import { DEFAULT_CODE, SERVICE_ERROR_CODE_MAP } from './defaults';
 import type { SlateErrorInput, SlateErrorIssue, SlateServiceErrorData } from './types';
-import { cleanRecord, isRecord, normalizeKind, normalizeRetryable, sanitizeForBaggage } from './utils';
+import {
+  cleanRecord,
+  isRecord,
+  normalizeKind,
+  normalizeRetryable,
+  sanitizeForBaggage
+} from './utils';
 
 let SERVICE_ERROR_DATA_RESERVED_KEYS = new Set([
   'status',
@@ -46,9 +52,7 @@ let normalizeServiceErrorIssues = (errors: unknown): SlateErrorIssue[] | undefin
       };
     }
 
-    let path = Array.isArray(error.path)
-      ? error.path.map(entry => String(entry))
-      : undefined;
+    let path = Array.isArray(error.path) ? error.path.map(entry => String(entry)) : undefined;
 
     return {
       ...error,
@@ -67,7 +71,9 @@ let normalizeServiceErrorIssues = (errors: unknown): SlateErrorIssue[] | undefin
 };
 
 let getServiceErrorBaggage = (data: SlateServiceErrorData) => {
-  let extraEntries = Object.entries(data).filter(([key]) => !SERVICE_ERROR_DATA_RESERVED_KEYS.has(key));
+  let extraEntries = Object.entries(data).filter(
+    ([key]) => !SERVICE_ERROR_DATA_RESERVED_KEYS.has(key)
+  );
 
   return cleanRecord({
     serviceError: {
@@ -111,7 +117,11 @@ export let getServiceErrorData = (error: unknown): SlateServiceErrorData | null
     return error.data;
   }
 
-  if (isStructuredValue(error) && 'toResponse' in error && typeof error.toResponse === 'function') {
+  if (
+    isStructuredValue(error) &&
+    'toResponse' in error &&
+    typeof error.toResponse === 'function'
+  ) {
     let response = error.toResponse();
     return isServiceErrorData(response) ? response : null;
   }

package/src/error/types.ts

@@ -60,7 +60,7 @@ export interface SlateAxiosErrorOptions {
   mapAxiosError?: (
     error: AxiosError,
     inferred: SlateErrorResponse
-  ) => SlateError | Partial<SlateErrorResponse> | void;
+  ) => SlateError | Partial<SlateErrorResponse> | undefined;
 }
 
 export interface SlateServiceErrorData {

package/src/error/utils.ts

@@ -62,7 +62,7 @@ export let normalizeRetryable = (code: string, retryable?: boolean) => {
 };
 
 export let getDefaultMessage = (code: string, message?: string) => {
-  if (message && message.trim()) return message;
+  if (message?.trim()) return message;
   return DEFAULT_MESSAGES[code] ?? DEFAULT_MESSAGES[DEFAULT_CODE];
 };
 

package/src/logger/logger.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { SlateLogger, type SlateLogEntry } from './logger';
+import { type SlateLogEntry, SlateLogger } from './logger';
 
 let flushLogs = async () => {
   await new Promise(resolve => setTimeout(resolve, 20));

package/src/specification/specification.ts

@@ -9,10 +9,8 @@ export interface SlateSpecificationParameters {
   metadata?: Record<string, any>;
 }
 
-export interface SlateSpecificationCreateParameters<
-  ConfigType extends {},
-  AuthType extends {}
-> extends SlateSpecificationParameters {
+export interface SlateSpecificationCreateParameters<ConfigType extends {}, AuthType extends {}>
+  extends SlateSpecificationParameters {
   config: SlateConfig<ConfigType>;
   auth: SlateAuth<AuthType>;
 }