@dainprotocol/service-sdk 2.0.53 → 2.0.54

package/dist/client/types.d.ts

@@ -14,6 +14,7 @@ export declare const MetadataSchema: z.ZodObject<{
     author: z.ZodString;
     tags: z.ZodArray<z.ZodString>;
     requiredScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    supportsUserActions: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const ServiceConfigSchema: z.ZodObject<{
     id: z.ZodString;
@@ -50,6 +51,7 @@ export declare const ToolConfigSchema: z.ZodObject<{
     interface: z.ZodOptional<z.ZodString>;
     suggestConfirmation: z.ZodOptional<z.ZodBoolean>;
     suggestConfirmationUISchema: z.ZodOptional<z.ZodAny>;
+    supportsUserActions: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const ServiceContextSchema: z.ZodObject<{
     id: z.ZodString;
@@ -113,6 +115,7 @@ export declare const ToolWithJsonSchemaSchema: z.ZodObject<{
     interface: z.ZodOptional<z.ZodString>;
     suggestConfirmation: z.ZodOptional<z.ZodBoolean>;
     suggestConfirmationUISchema: z.ZodOptional<z.ZodAny>;
+    supportsUserActions: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const GetAllToolsAsJsonSchemaResponseSchema: z.ZodObject<{
     tools: z.ZodArray<z.ZodObject<{
@@ -125,6 +128,7 @@ export declare const GetAllToolsAsJsonSchemaResponseSchema: z.ZodObject<{
         interface: z.ZodOptional<z.ZodString>;
         suggestConfirmation: z.ZodOptional<z.ZodBoolean>;
         suggestConfirmationUISchema: z.ZodOptional<z.ZodAny>;
+        supportsUserActions: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     reccomendedPrompts: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
@@ -165,6 +169,38 @@ export declare const OAuth2ProviderInfoSchema: z.ZodObject<{
     }, z.core.$strip>;
     connected: z.ZodBoolean;
 }, z.core.$strip>;
+export declare const ProviderInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        oauth2: "oauth2";
+        direct: "direct";
+    }>;
+    connected: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+    requiredTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    logoUrl: z.ZodOptional<z.ZodString>;
+    authMethod: z.ZodUnion<readonly [z.ZodNull, z.ZodObject<{
+        type: z.ZodLiteral<"oauth2">;
+        authUrl: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"direct">;
+        onboardingTool: z.ZodString;
+    }, z.core.$strip>]>;
+}, z.core.$strip>;
+export declare const DirectAuthStatusSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        complete: "complete";
+        authorization_pending: "authorization_pending";
+        not_found: "not_found";
+    }>;
+    config: z.ZodOptional<z.ZodObject<{
+        configuredAt: z.ZodNumber;
+    }, z.core.$strip>>;
+    expires_in: z.ZodOptional<z.ZodNumber>;
+    interval: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const ExampleQuerySchema: z.ZodObject<{
     category: z.ZodString;
     queries: z.ZodArray<z.ZodString>;
@@ -214,6 +250,8 @@ export type ToolWithJsonSchema = z.infer<typeof ToolWithJsonSchemaSchema>;
 export type ServiceWidget = z.infer<typeof ServiceWidgetSchema>;
 export type ServiceWidgetWithData = z.infer<typeof ServiceWidgetWithDataSchema>;
 export type OAuth2ProviderInfo = z.infer<typeof OAuth2ProviderInfoSchema>;
+export type ProviderInfo = z.infer<typeof ProviderInfoSchema>;
+export type DirectAuthStatus = z.infer<typeof DirectAuthStatusSchema>;
 export type ExampleQuery = z.infer<typeof ExampleQuerySchema>;
 export type ExampleQueries = z.infer<typeof ExampleQueriesSchema>;
 export type HumanActionStep = z.infer<typeof HumanActionStepSchema>;

package/dist/client/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HumanActionStepSchema = exports.ExampleQueriesSchema = exports.ExampleQuerySchema = exports.OAuth2ProviderInfoSchema = exports.ServiceWidgetWithDataSchema = exports.ServiceWidgetSchema = exports.GetAllToolsAsJsonSchemaResponseSchema = exports.ToolWithJsonSchemaSchema = exports.ServiceAgentSchema = exports.ServiceDatasourceWithDataSchema = exports.ServiceDatasourceSchema = exports.DatasourceTypeSchema = exports.ServiceContextWithDataSchema = exports.ServiceContextSchema = exports.ToolConfigSchema = exports.ToolboxConfigSchema = exports.ServiceConfigSchema = exports.MetadataSchema = exports.PricingInfoSchema = void 0;
+exports.HumanActionStepSchema = exports.ExampleQueriesSchema = exports.ExampleQuerySchema = exports.DirectAuthStatusSchema = exports.ProviderInfoSchema = exports.OAuth2ProviderInfoSchema = exports.ServiceWidgetWithDataSchema = exports.ServiceWidgetSchema = exports.GetAllToolsAsJsonSchemaResponseSchema = exports.ToolWithJsonSchemaSchema = exports.ServiceAgentSchema = exports.ServiceDatasourceWithDataSchema = exports.ServiceDatasourceSchema = exports.DatasourceTypeSchema = exports.ServiceContextWithDataSchema = exports.ServiceContextSchema = exports.ToolConfigSchema = exports.ToolboxConfigSchema = exports.ServiceConfigSchema = exports.MetadataSchema = exports.PricingInfoSchema = void 0;
 const zod_1 = require("zod");
 // Define and export types for DAIN service responses
 exports.PricingInfoSchema = zod_1.z.object({
@@ -18,6 +18,7 @@ exports.MetadataSchema = zod_1.z.object({
     author: zod_1.z.string(),
     tags: zod_1.z.array(zod_1.z.string()),
     requiredScopes: zod_1.z.array(zod_1.z.string()).optional(), // OAuth scopes required by this service
+    supportsUserActions: zod_1.z.boolean().optional(), // True if ANY tool supports interactive user actions (HITL)
 });
 exports.ServiceConfigSchema = zod_1.z.object({
     id: zod_1.z.string(),
@@ -51,6 +52,7 @@ exports.ToolConfigSchema = zod_1.z.object({
     interface: zod_1.z.string().optional(), // Tool interface type
     suggestConfirmation: zod_1.z.boolean().optional(),
     suggestConfirmationUISchema: zod_1.z.any().optional(), // The UI schema will be handled separately
+    supportsUserActions: zod_1.z.boolean().optional(), // Tool can send actionable messages (HITL)
 });
 exports.ServiceContextSchema = zod_1.z.object({
     id: zod_1.z.string(),
@@ -91,6 +93,7 @@ exports.ToolWithJsonSchemaSchema = zod_1.z.object({
     interface: zod_1.z.string().optional(),
     suggestConfirmation: zod_1.z.boolean().optional(),
     suggestConfirmationUISchema: zod_1.z.any().optional(),
+    supportsUserActions: zod_1.z.boolean().optional(),
 });
 exports.GetAllToolsAsJsonSchemaResponseSchema = zod_1.z.object({
     tools: zod_1.z.array(exports.ToolWithJsonSchemaSchema),
@@ -121,6 +124,37 @@ exports.OAuth2ProviderInfoSchema = zod_1.z.object({
     }),
     connected: zod_1.z.boolean()
 });
+// Unified authentication provider schema (OAuth2 + Direct)
+exports.ProviderInfoSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    type: zod_1.z.enum(['oauth2', 'direct']),
+    connected: zod_1.z.boolean(),
+    reason: zod_1.z.string().optional(),
+    requiredTools: zod_1.z.array(zod_1.z.string()).optional(),
+    scopes: zod_1.z.array(zod_1.z.string()).optional(),
+    logoUrl: zod_1.z.string().optional(),
+    authMethod: zod_1.z.union([
+        zod_1.z.null(),
+        zod_1.z.object({
+            type: zod_1.z.literal('oauth2'),
+            authUrl: zod_1.z.string()
+        }),
+        zod_1.z.object({
+            type: zod_1.z.literal('direct'),
+            onboardingTool: zod_1.z.string()
+        })
+    ])
+});
+// Direct auth setup status (RFC 8628 Device Authorization Grant)
+exports.DirectAuthStatusSchema = zod_1.z.object({
+    status: zod_1.z.enum(['complete', 'authorization_pending', 'not_found']),
+    config: zod_1.z.object({
+        configuredAt: zod_1.z.number()
+    }).optional(),
+    expires_in: zod_1.z.number().optional(),
+    interval: zod_1.z.number().optional(),
+    error: zod_1.z.string().optional()
+});
 exports.ExampleQuerySchema = zod_1.z.object({
     category: zod_1.z.string(),
     queries: zod_1.z.array(zod_1.z.string()),

package/dist/client/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}

package/dist/service/actionable-tools.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Actionable Tool Schema & Utilities
+ *
+ * Provides standardized schema and helpers for tools that send actionable messages.
+ * These tools enable users to trigger system actions through responses (buttons, callbacks, links).
+ *
+ * @see automation-core/src/core/tools/actionable-tool.schema.ts (matching schema)
+ */
+import { z } from 'zod';
+import { ToolConfig, AgentInfo, ToolContext } from './types';
+/**
+ * Action button/option schema
+ */
+export declare const ActionSchema: z.ZodObject<{
+    label: z.ZodString;
+    type: z.ZodEnum<{
+        url: "url";
+        custom: "custom";
+        callback: "callback";
+        approve: "approve";
+        reject: "reject";
+    }>;
+    value: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Automation metadata schema (auto-injected by automation-core)
+ */
+export declare const MetadataSchema: z.ZodObject<{
+    runId: z.ZodOptional<z.ZodString>;
+    waitId: z.ZodOptional<z.ZodString>;
+    automationId: z.ZodOptional<z.ZodString>;
+    interactionUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Base schema for all actionable tools
+ * Tools marked with supportsUserActions: true MUST accept these fields
+ */
+export declare const ActionableToolBaseSchema: z.ZodObject<{
+    recipient: z.ZodString;
+    message: z.ZodString;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            url: "url";
+            custom: "custom";
+            callback: "callback";
+            approve: "approve";
+            reject: "reject";
+        }>;
+        value: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        runId: z.ZodOptional<z.ZodString>;
+        waitId: z.ZodOptional<z.ZodString>;
+        automationId: z.ZodOptional<z.ZodString>;
+        interactionUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from schema
+ */
+export type ActionableToolInput = z.infer<typeof ActionableToolBaseSchema>;
+export type Action = z.infer<typeof ActionSchema>;
+export type AutomationMetadata = z.infer<typeof MetadataSchema>;
+/**
+ * Extend base actionable schema with tool-specific fields
+ * Use this to add additional parameters while keeping the standard actionable fields
+ *
+ * @example
+ * ```typescript
+ * const TelegramInputSchema = extendActionableSchema({
+ *   parse_mode: z.enum(['HTML', 'Markdown']).optional(),
+ *   disable_notification: z.boolean().optional(),
+ * });
+ * ```
+ */
+export declare function extendActionableSchema<T extends z.ZodRawShape>(additionalFields: T): z.ZodObject<z.ZodRawShape>;
+/**
+ * Helper function to build an actionable tool with type safety and schema enforcement
+ * Automatically merges base actionable schema with tool-specific fields
+ *
+ * @example
+ * ```typescript
+ * export const sendTelegramMessage = buildActionableTool({
+ *   id: 'send-telegram-message',
+ *   name: 'Send Telegram Message',
+ *   description: 'Send a message with interactive buttons to a Telegram chat',
+ *   additionalFields: {
+ *     parse_mode: z.enum(['HTML', 'Markdown']).optional(),
+ *   },
+ *   handler: async (input, agentInfo, context) => {
+ *     // input is typed with: recipient, message, actions, metadata, parse_mode
+ *     const { recipient, message, actions, parse_mode } = input;
+ *
+ *     // Use recipient as chatId for Telegram API
+ *     const result = await sendToTelegram({
+ *       chat_id: recipient,
+ *       text: message,
+ *       parse_mode,
+ *       reply_markup: actions ? buildInlineKeyboard(actions) : undefined,
+ *     });
+ *
+ *     return {
+ *       text: `Message sent to ${recipient}`,
+ *       data: { messageId: result.message_id },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export declare function buildActionableTool<TAdditional extends z.ZodRawShape = {}, TOutput extends z.ZodType = z.ZodAny>(config: {
+    id: string;
+    name: string;
+    description: string;
+    additionalFields?: TAdditional;
+    output?: TOutput;
+    handler: (input: ActionableToolInput & z.infer<z.ZodObject<TAdditional>>, agentInfo: AgentInfo, context: ToolContext) => Promise<{
+        success?: boolean;
+        text: string;
+        data: z.output<TOutput>;
+        ui?: any;
+        pleasePay?: any;
+        processes?: string[] | any[];
+    }>;
+}): ToolConfig;
+/**
+ * Validate that a tool schema includes required actionable fields
+ * Use this to check if a manually-defined tool complies with actionable schema
+ */
+export declare function validateActionableSchema(toolConfig: ToolConfig): {
+    valid: boolean;
+    errors?: string[];
+};

package/dist/service/actionable-tools.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Actionable Tool Schema & Utilities
+ *
+ * Provides standardized schema and helpers for tools that send actionable messages.
+ * These tools enable users to trigger system actions through responses (buttons, callbacks, links).
+ *
+ * @see automation-core/src/core/tools/actionable-tool.schema.ts (matching schema)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionableToolBaseSchema = exports.MetadataSchema = exports.ActionSchema = void 0;
+exports.extendActionableSchema = extendActionableSchema;
+exports.buildActionableTool = buildActionableTool;
+exports.validateActionableSchema = validateActionableSchema;
+const zod_1 = require("zod");
+/**
+ * Action button/option schema
+ */
+exports.ActionSchema = zod_1.z.object({
+    label: zod_1.z.string().describe('Button/action label shown to user'),
+    type: zod_1.z
+        .enum(['approve', 'reject', 'callback', 'url', 'custom'])
+        .describe('Type of action'),
+    value: zod_1.z.string().optional().describe('Value sent back when action is triggered'),
+    url: zod_1.z.string().optional().describe('URL to open (for url type actions)'),
+});
+/**
+ * Automation metadata schema (auto-injected by automation-core)
+ */
+exports.MetadataSchema = zod_1.z.object({
+    runId: zod_1.z.string().optional().describe('Current run ID'),
+    waitId: zod_1.z.string().optional().describe('Wait node ID if applicable'),
+    automationId: zod_1.z.string().optional().describe('Automation ID'),
+    interactionUrl: zod_1.z.string().optional().describe('URL for user interaction'),
+});
+/**
+ * Base schema for all actionable tools
+ * Tools marked with supportsUserActions: true MUST accept these fields
+ */
+exports.ActionableToolBaseSchema = zod_1.z.object({
+    recipient: zod_1.z.string().describe('Who receives this message (chatId, channel, email, etc.)'),
+    message: zod_1.z.string().describe('The message text to send'),
+    actions: zod_1.z.array(exports.ActionSchema).optional().describe('Interactive actions the user can trigger'),
+    metadata: exports.MetadataSchema.optional().describe('Automation metadata (auto-injected by system)'),
+});
+/**
+ * Extend base actionable schema with tool-specific fields
+ * Use this to add additional parameters while keeping the standard actionable fields
+ *
+ * @example
+ * ```typescript
+ * const TelegramInputSchema = extendActionableSchema({
+ *   parse_mode: z.enum(['HTML', 'Markdown']).optional(),
+ *   disable_notification: z.boolean().optional(),
+ * });
+ * ```
+ */
+function extendActionableSchema(additionalFields) {
+    return exports.ActionableToolBaseSchema.extend(additionalFields);
+}
+/**
+ * Helper function to build an actionable tool with type safety and schema enforcement
+ * Automatically merges base actionable schema with tool-specific fields
+ *
+ * @example
+ * ```typescript
+ * export const sendTelegramMessage = buildActionableTool({
+ *   id: 'send-telegram-message',
+ *   name: 'Send Telegram Message',
+ *   description: 'Send a message with interactive buttons to a Telegram chat',
+ *   additionalFields: {
+ *     parse_mode: z.enum(['HTML', 'Markdown']).optional(),
+ *   },
+ *   handler: async (input, agentInfo, context) => {
+ *     // input is typed with: recipient, message, actions, metadata, parse_mode
+ *     const { recipient, message, actions, parse_mode } = input;
+ *
+ *     // Use recipient as chatId for Telegram API
+ *     const result = await sendToTelegram({
+ *       chat_id: recipient,
+ *       text: message,
+ *       parse_mode,
+ *       reply_markup: actions ? buildInlineKeyboard(actions) : undefined,
+ *     });
+ *
+ *     return {
+ *       text: `Message sent to ${recipient}`,
+ *       data: { messageId: result.message_id },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+function buildActionableTool(config) {
+    // Merge base actionable schema with additional fields
+    const inputSchema = config.additionalFields
+        ? exports.ActionableToolBaseSchema.extend(config.additionalFields)
+        : exports.ActionableToolBaseSchema;
+    const outputSchema = config.output || zod_1.z.any();
+    return {
+        id: config.id,
+        name: config.name,
+        description: config.description,
+        input: inputSchema,
+        output: outputSchema,
+        supportsUserActions: true, // Always true for actionable tools
+        handler: config.handler,
+    };
+}
+/**
+ * Validate that a tool schema includes required actionable fields
+ * Use this to check if a manually-defined tool complies with actionable schema
+ */
+function validateActionableSchema(toolConfig) {
+    if (!toolConfig.supportsUserActions) {
+        return { valid: true }; // Not an actionable tool, no validation needed
+    }
+    const errors = [];
+    // Check if input schema is a Zod object
+    if (!(toolConfig.input instanceof zod_1.z.ZodObject)) {
+        errors.push('Input schema must be a Zod object for actionable tools');
+        return { valid: false, errors };
+    }
+    const shape = toolConfig.input.shape;
+    // Check required fields
+    if (!shape.recipient) {
+        errors.push("Missing required field: 'recipient'");
+    }
+    if (!shape.message) {
+        errors.push("Missing required field: 'message'");
+    }
+    // Check field types
+    if (shape.recipient && !(shape.recipient instanceof zod_1.z.ZodString)) {
+        errors.push("Field 'recipient' must be a string");
+    }
+    if (shape.message && !(shape.message instanceof zod_1.z.ZodString)) {
+        errors.push("Field 'message' must be a string");
+    }
+    return {
+        valid: errors.length === 0,
+        errors: errors.length > 0 ? errors : undefined,
+    };
+}
+//# sourceMappingURL=actionable-tools.js.map

package/dist/service/actionable-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionable-tools.js","sourceRoot":"","sources":["../../src/service/actionable-tools.ts"],"names":[],"mappings":"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"}

package/dist/service/direct-auth-setup.d.ts

@@ -0,0 +1,154 @@
+import { StorageAdapter } from '@dainprotocol/oauth2-token-manager';
+/**
+ * Pending setup information
+ */
+export interface PendingSetup {
+    setupCode: string;
+    userId: string;
+    provider: string;
+    expiresAt: number;
+}
+/**
+ * Setup completion result
+ */
+export interface SetupCompletionResult {
+    success: boolean;
+    userId?: string;
+    error?: string;
+}
+/**
+ * Onboarding UI configuration
+ * Returned by adapter to display setup instructions to user
+ */
+export interface OnboardingUI {
+    /** Primary action URL (e.g., deep link, authorization URL) */
+    actionUrl: string;
+    /** QR code image URL */
+    qrCodeUrl?: string;
+    /** Instructions to display to the user */
+    instructions: string[];
+    /** Button label for primary action */
+    buttonLabel?: string;
+    /** Provider logo URL */
+    logoUrl?: string;
+}
+/**
+ * DirectAuthAdapter Interface
+ *
+ * Contract for provider-specific direct authentication adapters.
+ * Implementations handle provider-specific UI generation.
+ * Webhook parsing is handled by the service's existing infrastructure.
+ */
+export interface DirectAuthAdapter {
+    /** Provider name */
+    provider: string;
+    /**
+     * Generate the onboarding UI for the user
+     * @param setupCode - The generated setup code
+     * @param expiresAt - Timestamp when the setup code expires
+     */
+    generateOnboardingUI(setupCode: string, expiresAt: number): OnboardingUI;
+    /**
+     * Send a confirmation message after successful setup
+     * @param config - The stored configuration
+     */
+    sendConfirmation?(config: Record<string, any>): Promise<void>;
+}
+/**
+ * DirectAuthSetupManager - Manages temporary setup codes for direct authentication providers
+ *
+ * Used for services that require user-provided configuration without external OAuth flow
+ * Examples: Telegram bot (chat ID), SMS (phone number), custom API endpoints
+ *
+ * Storage Strategy:
+ * - Uses StorageAdapter (backed by database from @dainprotocol/oauth2-storage-drizzle)
+ * - Pending setups: Stored as tokens with provider `setup_pending_{provider}`
+ *   - userId field = setup code (for quick lookup)
+ *   - email field = actual user ID
+ *   - metadata = { originalUserId, provider, expiresAt }
+ *   - token.expiresAt = expiry timestamp
+ * - Completed setups: Stored as tokens with provider `{provider}`
+ *   - userId field = user ID
+ *   - metadata = { chatId, username, firstName, etc. }
+ */
+export declare class DirectAuthSetupManager {
+    private storage;
+    constructor(storage: StorageAdapter);
+    /**
+     * Generate a cryptographically secure setup code
+     * 32 hex characters (16 bytes entropy)
+     */
+    private generateSetupCode;
+    /**
+     * Get the pending provider name for storage
+     */
+    private getPendingProviderName;
+    /**
+     * Create a pending setup for a user and provider
+     *
+     * @param userId - The user ID (e.g., smart account ID)
+     * @param provider - The provider name (e.g., 'telegram')
+     * @param expiryMinutes - How long the setup code is valid (default: 15 minutes)
+     * @returns The generated setup code
+     */
+    createSetup(userId: string, provider: string, expiryMinutes?: number): Promise<string>;
+    /**
+     * Verify a setup code is valid and not expired
+     *
+     * @param setupCode - The setup code to verify
+     * @param provider - The provider name
+     * @returns The pending setup info if valid, null otherwise
+     */
+    verifySetup(setupCode: string, provider: string): Promise<PendingSetup | null>;
+    /**
+     * Complete setup and store the provider configuration
+     *
+     * @param setupCode - The setup code that was verified
+     * @param provider - The provider name
+     * @param config - The configuration to store (e.g., { chatId: 123456789 })
+     * @returns Result indicating success or failure
+     */
+    completeSetup(setupCode: string, provider: string, config: Record<string, any>): Promise<SetupCompletionResult>;
+    /**
+     * Check if a user has completed setup for a provider
+     *
+     * @param userId - The user ID
+     * @param provider - The provider name
+     * @returns True if setup is complete
+     */
+    isSetupComplete(userId: string, provider: string): Promise<boolean>;
+    /**
+     * Get the stored configuration for a user and provider
+     *
+     * @param userId - The user ID
+     * @param provider - The provider name
+     * @returns The stored config or null if not found
+     */
+    getProviderConfig(userId: string, provider: string): Promise<Record<string, any> | null>;
+    /**
+     * Delete provider configuration for a user
+     * Used when user wants to disconnect/revoke access
+     *
+     * @param userId - The user ID
+     * @param provider - The provider name
+     * @returns True if deleted successfully
+     */
+    deleteProviderConfig(userId: string, provider: string): Promise<boolean>;
+    /**
+     * Get pending setup status for a user
+     * Useful for showing setup progress in UI
+     *
+     * @param userId - The user ID
+     * @param provider - The provider name
+     * @returns Pending setup info if exists, null otherwise
+     */
+    getPendingSetup(userId: string, provider: string): Promise<PendingSetup | null>;
+    /**
+     * Cleanup expired pending setups
+     * Should be called periodically to prevent stale data accumulation
+     *
+     * @param provider - The provider name to clean up
+     * @returns Number of expired setups cleaned up
+     */
+    cleanupExpiredSetups(provider: string): Promise<number>;
+}