@dainprotocol/service-sdk 2.0.53 → 2.0.54

package/dist/service/direct-auth-setup.js

@@ -0,0 +1,308 @@
+"use strict";
+// File: src/service/direct-auth-setup.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectAuthSetupManager = void 0;
+const crypto_1 = require("crypto");
+/**
+ * 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. }
+ */
+class DirectAuthSetupManager {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Generate a cryptographically secure setup code
+     * 32 hex characters (16 bytes entropy)
+     */
+    generateSetupCode() {
+        return (0, crypto_1.randomBytes)(16).toString('hex');
+    }
+    /**
+     * Get the pending provider name for storage
+     */
+    getPendingProviderName(provider) {
+        return `setup_pending_${provider}`;
+    }
+    /**
+     * 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
+     */
+    async createSetup(userId, provider, expiryMinutes = 15) {
+        const setupCode = this.generateSetupCode();
+        const expiresAt = Date.now() + (expiryMinutes * 60 * 1000);
+        const pendingProvider = this.getPendingProviderName(provider);
+        // Store pending setup using StorageAdapter
+        // We use setupCode as userId for quick lookup when verifying
+        // The actual userId is stored in the email field and metadata
+        await this.storage.saveToken({
+            provider: pendingProvider,
+            userId: setupCode, // Use setup code as userId for lookup
+            email: `${userId}@dain.local`, // Store actual userId in email field
+            token: {
+                accessToken: setupCode,
+                expiresAt: new Date(expiresAt),
+                tokenType: 'pending_setup'
+            },
+            metadata: {
+                originalUserId: userId,
+                provider: provider,
+                expiresAt: expiresAt,
+                createdAt: Date.now()
+            }
+        });
+        console.log(`[DirectAuthSetupManager] Created setup code for user ${userId}, provider ${provider}, expires in ${expiryMinutes} minutes`);
+        return setupCode;
+    }
+    /**
+     * 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
+     */
+    async verifySetup(setupCode, provider) {
+        const pendingProvider = this.getPendingProviderName(provider);
+        try {
+            // Look up the setup code (stored as userId)
+            const tokens = await this.storage.queryTokens({
+                userId: setupCode,
+                provider: pendingProvider
+            });
+            if (!tokens || tokens.length === 0) {
+                console.log(`[DirectAuthSetupManager] Setup code not found: ${setupCode.substring(0, 8)}...`);
+                return null;
+            }
+            const token = tokens[0];
+            const metadata = token.metadata;
+            // Check expiry
+            const expiresAt = metadata?.expiresAt || 0;
+            if (Date.now() > expiresAt) {
+                console.log(`[DirectAuthSetupManager] Setup code expired: ${setupCode.substring(0, 8)}...`);
+                // Clean up expired token
+                await this.storage.deleteTokenByProviderEmail(pendingProvider, `${metadata.originalUserId}@dain.local`);
+                return null;
+            }
+            return {
+                setupCode,
+                userId: metadata.originalUserId,
+                provider: metadata.provider,
+                expiresAt
+            };
+        }
+        catch (error) {
+            console.error(`[DirectAuthSetupManager] Error verifying setup:`, error);
+            return 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
+     */
+    async completeSetup(setupCode, provider, config) {
+        // First verify the setup code
+        const pendingSetup = await this.verifySetup(setupCode, provider);
+        if (!pendingSetup) {
+            return {
+                success: false,
+                error: 'Invalid or expired setup code'
+            };
+        }
+        const { userId } = pendingSetup;
+        const pendingProvider = this.getPendingProviderName(provider);
+        try {
+            // Store the completed setup as a token for the actual provider
+            // This makes it accessible via hasValidTokens() and getTokensByUserId()
+            // Use far-future expiry for direct auth configs (10 years)
+            const farFutureExpiry = new Date(Date.now() + 10 * 365 * 24 * 60 * 60 * 1000);
+            await this.storage.saveToken({
+                provider: provider,
+                userId: userId,
+                email: `${userId}@dain.local`,
+                token: {
+                    accessToken: 'direct_auth_configured',
+                    expiresAt: farFutureExpiry,
+                    tokenType: 'configured'
+                },
+                metadata: {
+                    ...config,
+                    configuredAt: Date.now(),
+                    setupCode: setupCode.substring(0, 8) + '...' // Store partial code for debugging
+                }
+            });
+            // Delete the pending setup
+            await this.storage.deleteTokenByProviderEmail(pendingProvider, `${userId}@dain.local`);
+            console.log(`[DirectAuthSetupManager] Completed setup for user ${userId}, provider ${provider}`);
+            return {
+                success: true,
+                userId
+            };
+        }
+        catch (error) {
+            console.error(`[DirectAuthSetupManager] Error completing setup:`, error);
+            return {
+                success: false,
+                error: error.message || 'Failed to complete setup'
+            };
+        }
+    }
+    /**
+     * 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
+     */
+    async isSetupComplete(userId, provider) {
+        try {
+            const tokens = await this.storage.queryTokens({
+                userId: userId,
+                provider: provider
+            });
+            return tokens.length > 0;
+        }
+        catch (error) {
+            console.error(`[DirectAuthSetupManager] Error checking setup status:`, error);
+            return false;
+        }
+    }
+    /**
+     * 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
+     */
+    async getProviderConfig(userId, provider) {
+        try {
+            const tokens = await this.storage.queryTokens({
+                userId: userId,
+                provider: provider
+            });
+            if (!tokens || tokens.length === 0) {
+                return null;
+            }
+            return tokens[0].metadata;
+        }
+        catch (error) {
+            console.error(`[DirectAuthSetupManager] Error getting provider config:`, error);
+            return 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
+     */
+    async deleteProviderConfig(userId, provider) {
+        try {
+            await this.storage.deleteTokenByProviderEmail(provider, `${userId}@dain.local`);
+            console.log(`[DirectAuthSetupManager] Deleted config for user ${userId}, provider ${provider}`);
+            return true;
+        }
+        catch (error) {
+            console.error(`[DirectAuthSetupManager] Error deleting config:`, error);
+            return false;
+        }
+    }
+    /**
+     * 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
+     */
+    async getPendingSetup(userId, provider) {
+        const pendingProvider = this.getPendingProviderName(provider);
+        try {
+            // We need to search by the actual user ID in email/metadata
+            // This is less efficient but necessary since we store by setup code
+            const allTokens = await this.storage.queryTokens({
+                provider: pendingProvider
+            });
+            for (const token of allTokens) {
+                const metadata = token.metadata;
+                if (metadata?.originalUserId === userId) {
+                    const expiresAt = metadata?.expiresAt || 0;
+                    // Check expiry
+                    if (Date.now() > expiresAt) {
+                        // Clean up expired token
+                        await this.storage.deleteTokenByProviderEmail(pendingProvider, `${userId}@dain.local`);
+                        return null;
+                    }
+                    return {
+                        setupCode: token.userId,
+                        userId: metadata.originalUserId,
+                        provider: metadata.provider,
+                        expiresAt
+                    };
+                }
+            }
+            return null;
+        }
+        catch (error) {
+            console.error(`[DirectAuthSetupManager] Error getting pending setup:`, error);
+            return 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
+     */
+    async cleanupExpiredSetups(provider) {
+        const pendingProvider = this.getPendingProviderName(provider);
+        let cleanedUp = 0;
+        try {
+            const allTokens = await this.storage.queryTokens({
+                provider: pendingProvider
+            });
+            for (const token of allTokens) {
+                const metadata = token.metadata;
+                const expiresAt = metadata?.expiresAt || 0;
+                if (Date.now() > expiresAt) {
+                    await this.storage.deleteTokenByProviderEmail(pendingProvider, token.email || `${metadata?.originalUserId}@dain.local`);
+                    cleanedUp++;
+                }
+            }
+            if (cleanedUp > 0) {
+                console.log(`[DirectAuthSetupManager] Cleaned up ${cleanedUp} expired ${provider} setups`);
+            }
+            return cleanedUp;
+        }
+        catch (error) {
+            console.error(`[DirectAuthSetupManager] Error cleaning up expired setups:`, error);
+            return 0;
+        }
+    }
+}
+exports.DirectAuthSetupManager = DirectAuthSetupManager;
+//# sourceMappingURL=direct-auth-setup.js.map

package/dist/service/direct-auth-setup.js.map

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

package/dist/service/index.d.ts

@@ -9,7 +9,9 @@ import { requireScope } from "./server";
 import { hasScope, hasAllScopes, hasAnyScope } from "./auth";
 import { WebhookTriggerRegistry, createWebhookTriggerRegistry, createSimpleTrigger, type WebhookTrigger, type WebhookTriggerDefinition, type WebhookProcessResult } from "./webhooks";
 import { HITLHandler, routeActionToService, type HITLConfig, type HITLResult } from "./hitl";
+import { ActionableToolBaseSchema, ActionSchema, MetadataSchema, extendActionableSchema, buildActionableTool, validateActionableSchema, type ActionableToolInput, type Action, type AutomationMetadata } from "./actionable-tools";
+import { DirectAuthSetupManager, type DirectAuthAdapter, type OnboardingUI, type PendingSetup, type SetupCompletionResult } from "./direct-auth-setup";
 export declare const defineDAINService: (config: DAINServiceConfig) => DAINService;
-export { defineNodeService, defineDenoService, defineCloudflareService, createNextDainService, createTool, createService, createToolbox, CoreUtils, createOAuth2Tool, createAgent, ProcessHandler, RedisProcessStore, MemoryProcessStore, requireScope, hasScope, hasAllScopes, hasAnyScope, WebhookTriggerRegistry, createWebhookTriggerRegistry, createSimpleTrigger, type WebhookTrigger, type WebhookTriggerDefinition, type WebhookProcessResult, HITLHandler, routeActionToService, type HITLConfig, type HITLResult, };
+export { defineNodeService, defineDenoService, defineCloudflareService, createNextDainService, createTool, createService, createToolbox, CoreUtils, createOAuth2Tool, createAgent, ProcessHandler, RedisProcessStore, MemoryProcessStore, requireScope, hasScope, hasAllScopes, hasAnyScope, WebhookTriggerRegistry, createWebhookTriggerRegistry, createSimpleTrigger, type WebhookTrigger, type WebhookTriggerDefinition, type WebhookProcessResult, HITLHandler, routeActionToService, type HITLConfig, type HITLResult, ActionableToolBaseSchema, ActionSchema, MetadataSchema, extendActionableSchema, buildActionableTool, validateActionableSchema, type ActionableToolInput, type Action, type AutomationMetadata, DirectAuthSetupManager, type DirectAuthAdapter, type OnboardingUI, type PendingSetup, type SetupCompletionResult, };
 export * from './types';
 export * from './oauth2Store';

package/dist/service/index.js

@@ -1,7 +1,7 @@
 "use strict";
 // File: src/service/index.ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.routeActionToService = exports.HITLHandler = exports.createSimpleTrigger = exports.createWebhookTriggerRegistry = exports.WebhookTriggerRegistry = exports.hasAnyScope = exports.hasAllScopes = exports.hasScope = exports.requireScope = exports.MemoryProcessStore = exports.RedisProcessStore = exports.ProcessHandler = exports.createAgent = exports.createOAuth2Tool = exports.CoreUtils = exports.createToolbox = exports.createService = exports.createTool = exports.createNextDainService = exports.defineCloudflareService = exports.defineDenoService = exports.defineNodeService = exports.defineDAINService = void 0;
+exports.DirectAuthSetupManager = exports.validateActionableSchema = exports.buildActionableTool = exports.extendActionableSchema = exports.MetadataSchema = exports.ActionSchema = exports.ActionableToolBaseSchema = exports.routeActionToService = exports.HITLHandler = exports.createSimpleTrigger = exports.createWebhookTriggerRegistry = exports.WebhookTriggerRegistry = exports.hasAnyScope = exports.hasAllScopes = exports.hasScope = exports.requireScope = exports.MemoryProcessStore = exports.RedisProcessStore = exports.ProcessHandler = exports.createAgent = exports.createOAuth2Tool = exports.CoreUtils = exports.createToolbox = exports.createService = exports.createTool = exports.createNextDainService = exports.defineCloudflareService = exports.defineDenoService = exports.defineNodeService = exports.defineDAINService = void 0;
 const tslib_1 = require("tslib");
 const nodeService_1 = require("./nodeService");
 Object.defineProperty(exports, "defineNodeService", { enumerable: true, get: function () { return nodeService_1.defineDAINService; } });
@@ -35,6 +35,15 @@ Object.defineProperty(exports, "createSimpleTrigger", { enumerable: true, get: f
 const hitl_1 = require("./hitl");
 Object.defineProperty(exports, "HITLHandler", { enumerable: true, get: function () { return hitl_1.HITLHandler; } });
 Object.defineProperty(exports, "routeActionToService", { enumerable: true, get: function () { return hitl_1.routeActionToService; } });
+const actionable_tools_1 = require("./actionable-tools");
+Object.defineProperty(exports, "ActionableToolBaseSchema", { enumerable: true, get: function () { return actionable_tools_1.ActionableToolBaseSchema; } });
+Object.defineProperty(exports, "ActionSchema", { enumerable: true, get: function () { return actionable_tools_1.ActionSchema; } });
+Object.defineProperty(exports, "MetadataSchema", { enumerable: true, get: function () { return actionable_tools_1.MetadataSchema; } });
+Object.defineProperty(exports, "extendActionableSchema", { enumerable: true, get: function () { return actionable_tools_1.extendActionableSchema; } });
+Object.defineProperty(exports, "buildActionableTool", { enumerable: true, get: function () { return actionable_tools_1.buildActionableTool; } });
+Object.defineProperty(exports, "validateActionableSchema", { enumerable: true, get: function () { return actionable_tools_1.validateActionableSchema; } });
+const direct_auth_setup_1 = require("./direct-auth-setup");
+Object.defineProperty(exports, "DirectAuthSetupManager", { enumerable: true, get: function () { return direct_auth_setup_1.DirectAuthSetupManager; } });
 const defineDAINService = (config) => {
     throw new Error("This is a fallback implementation. Use the appropriate runtime-specific import.");
 };

package/dist/service/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":";AAAA,6BAA6B;;;;AAG7B,+CAAuE;AA4BrE,kGA5B4B,+BAAiB,OA4B5B;AA3BnB,+CAAuE;AA4BrE,kGA5B4B,+BAAiB,OA4B5B;AA3BnB,2DAAmF;AA4BjF,wGA5B4B,qCAAuB,OA4B5B;AA3BzB,+CAAsD;AA4BpD,sGA5BO,mCAAqB,OA4BP;AA3BvB,iCAA4G;AA4B1G,2FA5BO,iBAAU,OA4BP;AACV,8FA7BmB,oBAAa,OA6BnB;AACb,8FA9BkC,oBAAa,OA8BlC;AACb,0FA/BiD,gBAAS,OA+BjD;AACT,iGAhC4D,uBAAgB,OAgC5D;AAChB,4FAjC8E,kBAAW,OAiC9E;AAhCb,2CAAoF;AAiClF,+FAjCO,0BAAc,OAiCP;AACd,kGAlCuB,6BAAiB,OAkCvB;AACjB,mGAnC0C,8BAAkB,OAmC1C;AAlCpB,qCAAwC;AAmCtC,6FAnCO,qBAAY,OAmCP;AAlCd,iCAA6D;AAmC3D,yFAnCO,eAAQ,OAmCP;AACR,6FApCiB,mBAAY,OAoCjB;AACZ,4FArC+B,kBAAW,OAqC/B;AApCb,yCAOoB;AA+BlB,uGArCA,iCAAsB,OAqCA;AACtB,6GArCA,uCAA4B,OAqCA;AAC5B,oGArCA,8BAAmB,OAqCA;AAhCrB,iCAKgB;AAgCd,4FApCA,kBAAW,OAoCA;AACX,qGApCA,2BAAoB,OAoCA;AA/Bf,MAAM,iBAAiB,GAAG,CAAC,MAAyB,EAAe,EAAE;IAC1E,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;AACrG,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B;AAkCF,sBAAsB;AACtB,kDAAwB;AAExB,wDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":";AAAA,6BAA6B;;;;AAG7B,+CAAuE;AA8CrE,kGA9C4B,+BAAiB,OA8C5B;AA7CnB,+CAAuE;AA8CrE,kGA9C4B,+BAAiB,OA8C5B;AA7CnB,2DAAmF;AA8CjF,wGA9C4B,qCAAuB,OA8C5B;AA7CzB,+CAAsD;AA8CpD,sGA9CO,mCAAqB,OA8CP;AA7CvB,iCAA4G;AA8C1G,2FA9CO,iBAAU,OA8CP;AACV,8FA/CmB,oBAAa,OA+CnB;AACb,8FAhDkC,oBAAa,OAgDlC;AACb,0FAjDiD,gBAAS,OAiDjD;AACT,iGAlD4D,uBAAgB,OAkD5D;AAChB,4FAnD8E,kBAAW,OAmD9E;AAlDb,2CAAoF;AAmDlF,+FAnDO,0BAAc,OAmDP;AACd,kGApDuB,6BAAiB,OAoDvB;AACjB,mGArD0C,8BAAkB,OAqD1C;AApDpB,qCAAwC;AAqDtC,6FArDO,qBAAY,OAqDP;AApDd,iCAA6D;AAqD3D,yFArDO,eAAQ,OAqDP;AACR,6FAtDiB,mBAAY,OAsDjB;AACZ,4FAvD+B,kBAAW,OAuD/B;AAtDb,yCAOoB;AAiDlB,uGAvDA,iCAAsB,OAuDA;AACtB,6GAvDA,uCAA4B,OAuDA;AAC5B,oGAvDA,8BAAmB,OAuDA;AAlDrB,iCAKgB;AAkDd,4FAtDA,kBAAW,OAsDA;AACX,qGAtDA,2BAAoB,OAsDA;AAlDtB,yDAU4B;AA4C1B,yGArDA,2CAAwB,OAqDA;AACxB,6FArDA,+BAAY,OAqDA;AACZ,+FArDA,iCAAc,OAqDA;AACd,uGArDA,yCAAsB,OAqDA;AACtB,oGArDA,sCAAmB,OAqDA;AACnB,yGArDA,2CAAwB,OAqDA;AAhD1B,2DAM6B;AA+C3B,uGApDA,0CAAsB,OAoDA;AA7CjB,MAAM,iBAAiB,GAAG,CAAC,MAAyB,EAAe,EAAE;IAC1E,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;AACrG,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B;AAkDF,sBAAsB;AACtB,kDAAwB;AAExB,wDAA8B"}

package/dist/service/nodeService.js

@@ -49,7 +49,9 @@ function defineDAINService(config) {
                     server.close();
                 },
                 app: service,
+                oauth2: service.oauth2,
                 oauth2Client: service.oauth2 ? service.oauth2.getClient() : undefined,
+                setupManager: service.oauth2 ? service.oauth2.getSetupManager() : undefined,
                 server: server,
             };
         }

package/dist/service/nodeService.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodeService.js","sourceRoot":"","sources":["../../src/service/nodeService.ts"],"names":[],"mappings":";;;AAeA,8CAqDC;;AAnED,uCAAkD;AAClD,iCAOgB;AA8Dd,2FApEA,iBAAU,OAoEA;AACV,8FApEA,oBAAa,OAoEA;AACb,8FApEA,oBAAa,OAoEA;AACb,0FApEA,gBAAS,OAoEA;AACT,iGApEA,uBAAgB,OAoEA;AAChB,4FApEA,kBAAW,OAoEA;AAjEb,2CAAoF;AAkElF,+FAlEO,0BAAc,OAkEP;AACd,kGAnEuB,6BAAiB,OAmEvB;AACjB,mGApE0C,8BAAkB,OAoE1C;AAnEpB,yCAAuG;AAoErG,uGApEO,iCAAsB,OAoEP;AACtB,6GArE+B,uCAA4B,OAqE/B;AAC5B,oGAtE6D,8BAAmB,OAsE7D;AArErB,iCAA2D;AAsEzD,4FAtEO,kBAAW,OAsEP;AACX,qGAvEoB,2BAAoB,OAuEpB;AArEtB,SAAgB,iBAAiB,CAAC,MAAyB;IACzD,MAAM,WAAW,GAAG,IAAA,+BAAqB,EAAC,MAAM,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,KAAK,EACrB,UAA6B;QAC3B,IAAI,EAAE,SAAS;KAChB,EACiD,EAAE;QACpD,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC;QAChF,MAAM,EAAE,KAAK,EAAE,GAAG,gEAAa,mBAAmB,GAAC,CAAC;QACpD,MAAM,OAAO,GAAG,WAAW,CAAC,YAAa,EAAE,CAAC;QAE5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,KAAK,CAAC;gBACnB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI;aACL,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC5B,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;oBAC5C,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,sBAAsB,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CACT,sCAAsC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAChE,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;gBACzB,QAAQ,EAAE,KAAK,IAAI,EAAE;oBACnB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;oBAC7C,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,CAAC;gBACD,GAAG,EAAE,OAAO;gBACZ,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;gBACrE,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ;oBACrC,CAAC,CAAC,2GAA2G,IAAI,GAAG,CAAC,IAAI;oBACzH,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,yGAAyG,UAAU,EAAE,CAAC,CAAC;YACnK,CAAC;YACD,MAAM,KAAK,CAAC,CAAC,wBAAwB;QACvC,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,GAAG,WAAW;QACd,SAAS;KACK,CAAC;AACnB,CAAC;AAmBD,sBAAsB;AACtB,kDAAwB"}
+{"version":3,"file":"nodeService.js","sourceRoot":"","sources":["../../src/service/nodeService.ts"],"names":[],"mappings":";;;AAeA,8CAuDC;;AArED,uCAAkD;AAClD,iCAOgB;AAgEd,2FAtEA,iBAAU,OAsEA;AACV,8FAtEA,oBAAa,OAsEA;AACb,8FAtEA,oBAAa,OAsEA;AACb,0FAtEA,gBAAS,OAsEA;AACT,iGAtEA,uBAAgB,OAsEA;AAChB,4FAtEA,kBAAW,OAsEA;AAnEb,2CAAoF;AAoElF,+FApEO,0BAAc,OAoEP;AACd,kGArEuB,6BAAiB,OAqEvB;AACjB,mGAtE0C,8BAAkB,OAsE1C;AArEpB,yCAAuG;AAsErG,uGAtEO,iCAAsB,OAsEP;AACtB,6GAvE+B,uCAA4B,OAuE/B;AAC5B,oGAxE6D,8BAAmB,OAwE7D;AAvErB,iCAA2D;AAwEzD,4FAxEO,kBAAW,OAwEP;AACX,qGAzEoB,2BAAoB,OAyEpB;AAvEtB,SAAgB,iBAAiB,CAAC,MAAyB;IACzD,MAAM,WAAW,GAAG,IAAA,+BAAqB,EAAC,MAAM,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,KAAK,EACrB,UAA6B;QAC3B,IAAI,EAAE,SAAS;KAChB,EACiD,EAAE;QACpD,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC;QAChF,MAAM,EAAE,KAAK,EAAE,GAAG,gEAAa,mBAAmB,GAAC,CAAC;QACpD,MAAM,OAAO,GAAG,WAAW,CAAC,YAAa,EAAE,CAAC;QAE5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,KAAK,CAAC;gBACnB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI;aACL,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC5B,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;oBAC5C,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,sBAAsB,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CACT,sCAAsC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAChE,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;gBACzB,QAAQ,EAAE,KAAK,IAAI,EAAE;oBACnB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;oBAC7C,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,CAAC;gBACD,GAAG,EAAE,OAAO;gBACZ,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;gBACrE,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS;gBAC3E,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ;oBACrC,CAAC,CAAC,2GAA2G,IAAI,GAAG,CAAC,IAAI;oBACzH,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,yGAAyG,UAAU,EAAE,CAAC,CAAC;YACnK,CAAC;YACD,MAAM,KAAK,CAAC,CAAC,wBAAwB;QACvC,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,GAAG,WAAW;QACd,SAAS;KACK,CAAC;AACnB,CAAC;AAmBD,sBAAsB;AACtB,kDAAwB"}

package/dist/service/oauth2.d.ts

@@ -1,5 +1,6 @@
-import { OAuth2ProviderConfig } from "./types";
+import { OAuth2ProviderConfig, DirectProviderConfig, ProviderInfo } from "./types";
 import { StorageAdapter, OAuth2Client } from "@dainprotocol/oauth2-token-manager";
+import { DirectAuthSetupManager } from "./direct-auth-setup";
 interface StateData {
     agentId: string;
     provider: string;
@@ -14,12 +15,50 @@ export declare class OAuth2Handler {
      * @returns The OAuth2Client instance
      */
     getClient(): OAuth2Client;
+    /**
+     * Get the DirectAuthSetupManager for direct provider setup flows
+     * @returns The DirectAuthSetupManager instance
+     */
+    getSetupManager(): DirectAuthSetupManager;
     constructor(privateKey: string, baseUrl: string, tokenStore?: StorageAdapter);
+    /**
+     * Register an OAuth2 provider
+     * @param name Provider name (e.g., 'google', 'slack')
+     * @param config OAuth2 configuration
+     */
     registerProvider(name: string, config: OAuth2ProviderConfig): void;
+    /**
+     * Register a direct configuration provider (non-OAuth2)
+     * Used for services that require user-provided config without external OAuth flow
+     * Examples: Telegram bot (chat ID), SMS (phone number)
+     *
+     * @param name Provider name (e.g., 'telegram', 'sms')
+     * @param config Direct provider configuration
+     */
+    registerDirectProvider(name: string, config: DirectProviderConfig): void;
     generateAuthUrl(provider: string, agentId: string): Promise<string>;
     handleCallback(code: string, state: string): Promise<void>;
     hasValidTokens(provider: string, agentId: string): Promise<boolean>;
     getAccounts(provider: string, agentId: string): Promise<any[]>;
+    /**
+     * Get unified authentication providers (OAuth2 + Direct)
+     * Returns provider info with type discrimination and connection status
+     *
+     * @param agentId Agent/user ID
+     * @returns Array of provider information with auth methods
+     */
+    getAuthenticationProviders(agentId: string): Promise<ProviderInfo[]>;
+    /**
+     * Get auto-generated contexts for direct providers
+     * Automatically creates ServiceContext objects that expose setup values to AI
+     *
+     * @returns Array of ServiceContext objects
+     */
+    getDirectProviderContexts(): import("./types").ServiceContext<any>[];
+    /**
+     * Get OAuth2 providers (legacy method for backward compatibility)
+     * @deprecated Use getAuthenticationProviders() instead for full provider support
+     */
     getProviders(agentId: string): Promise<Array<{
         name: string;
         config: Omit<OAuth2ProviderConfig, 'clientSecret' | 'onSuccess'>;

package/dist/service/oauth2.js

@@ -14,15 +14,38 @@ class OAuth2Handler {
     getClient() {
         return this.manager.client;
     }
+    /**
+     * Get the DirectAuthSetupManager for direct provider setup flows
+     * @returns The DirectAuthSetupManager instance
+     */
+    getSetupManager() {
+        return this.manager.setupManager;
+    }
     constructor(privateKey, baseUrl, tokenStore) {
         this.privateKey = privateKey;
         // Use provided storage or default to in-memory storage
         const storage = tokenStore || new oauth2_token_manager_1.InMemoryStorageAdapter();
         this.manager = new oauth2Manager_1.OAuth2Manager(baseUrl, storage);
     }
+    /**
+     * Register an OAuth2 provider
+     * @param name Provider name (e.g., 'google', 'slack')
+     * @param config OAuth2 configuration
+     */
     registerProvider(name, config) {
         this.manager.registerProvider(name, config);
     }
+    /**
+     * Register a direct configuration provider (non-OAuth2)
+     * Used for services that require user-provided config without external OAuth flow
+     * Examples: Telegram bot (chat ID), SMS (phone number)
+     *
+     * @param name Provider name (e.g., 'telegram', 'sms')
+     * @param config Direct provider configuration
+     */
+    registerDirectProvider(name, config) {
+        this.manager.registerDirectProvider(name, config);
+    }
     async generateAuthUrl(provider, agentId) {
         return this.manager.generateAuthUrl(provider, agentId);
     }
@@ -35,6 +58,29 @@ class OAuth2Handler {
     async getAccounts(provider, agentId) {
         return this.manager.getAccounts(provider, agentId);
     }
+    /**
+     * Get unified authentication providers (OAuth2 + Direct)
+     * Returns provider info with type discrimination and connection status
+     *
+     * @param agentId Agent/user ID
+     * @returns Array of provider information with auth methods
+     */
+    async getAuthenticationProviders(agentId) {
+        return this.manager.getAuthenticationProviders(agentId);
+    }
+    /**
+     * Get auto-generated contexts for direct providers
+     * Automatically creates ServiceContext objects that expose setup values to AI
+     *
+     * @returns Array of ServiceContext objects
+     */
+    getDirectProviderContexts() {
+        return this.manager.getDirectProviderContexts();
+    }
+    /**
+     * Get OAuth2 providers (legacy method for backward compatibility)
+     * @deprecated Use getAuthenticationProviders() instead for full provider support
+     */
     async getProviders(agentId) {
         const allProviders = this.manager.getProviders();
         const providers = await Promise.all(Object.entries(allProviders).map(async ([name, config]) => ({

package/dist/service/oauth2.js.map

@@ -1 +1 @@
-{"version":3,"file":"oauth2.js","sourceRoot":"","sources":["../../src/service/oauth2.ts"],"names":[],"mappings":";;;AACA,mDAAgD;AAChD,+CAAoD;AACpD,6EAA0G;AAS1G,MAAa,aAAa;IAChB,OAAO,CAAgB;IACd,UAAU,CAAS;IAEpC;;;OAGG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,YAAY,UAAkB,EAAE,OAAe,EAAE,UAA2B;QAC1E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,uDAAuD;QACvD,MAAM,OAAO,GAAG,UAAU,IAAI,IAAI,6CAAsB,EAAE,CAAC;QAE3D,IAAI,CAAC,OAAO,GAAG,IAAI,6BAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,MAA4B;QACzD,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,OAAe;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,KAAa;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,OAAe;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,OAAe;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAKhC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1D,IAAI;YACJ,MAAM,EAAE;gBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,aAAa,EAAE,MAAM,CAAC,aAAa;aACpC;YACD,SAAS,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC;SAC5D,CAAC,CAAC,CACJ,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,WAAW,CAAC,IAAe;QAC/B,OAAO,MAAM,IAAA,uBAAQ,EAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa;QAC7B,OAAO,MAAM,IAAA,yBAAU,EAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAChE,CAAC;CACF;AAxED,sCAwEC"}
+{"version":3,"file":"oauth2.js","sourceRoot":"","sources":["../../src/service/oauth2.ts"],"names":[],"mappings":"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"}

package/dist/service/oauth2Manager.d.ts

@@ -1,17 +1,27 @@
 import { OAuth2Client, StorageAdapter, StoredToken } from '@dainprotocol/oauth2-token-manager';
-import { OAuth2ProviderConfig, OAuth2Tokens } from './types';
+import { OAuth2ProviderConfig, OAuth2Tokens, DirectProviderConfig, ProviderInfo, ServiceContext } from './types';
+import { DirectAuthSetupManager } from './direct-auth-setup';
 /**
  * OAuth2Manager - A clean integration with @dainprotocol/oauth2-token-manager
+ * Supports both OAuth2 and direct configuration providers
  */
 export declare class OAuth2Manager {
     readonly client: OAuth2Client;
+    readonly setupManager: DirectAuthSetupManager;
+    readonly storage: StorageAdapter;
     private baseUrl;
     private providerConfigs;
+    private directProviders;
     constructor(baseUrl: string, storage?: StorageAdapter);
     /**
-     * Register a provider with the OAuth2 client
+     * Register an OAuth2 provider
      */
     registerProvider(name: string, config: OAuth2ProviderConfig): void;
+    /**
+     * Register a direct configuration provider (non-OAuth2)
+     * Users provide config directly (e.g., Telegram chat ID) without external OAuth flow
+     */
+    registerDirectProvider(name: string, config: DirectProviderConfig): void;
     /**
      * Generate authorization URL
      */
@@ -34,11 +44,13 @@ export declare class OAuth2Manager {
      */
     deleteTokens(provider: string, agentId: string): Promise<void>;
     /**
-     * Get all configured providers
+     * Get all configured OAuth2 providers (legacy - returns only OAuth2, not direct providers)
+     * @deprecated Use getAuthenticationProviders() for full provider list
      */
     getProviders(): Record<string, OAuth2ProviderConfig>;
     /**
-     * Get a specific provider config
+     * Get a specific OAuth2 provider config (legacy - only returns OAuth2 providers)
+     * @deprecated Use getAuthenticationProviders() for full provider info
      */
     getProvider(name: string): OAuth2ProviderConfig | undefined;
     /**
@@ -47,4 +59,19 @@ export declare class OAuth2Manager {
      * @returns Array of stored tokens for the user and provider
      */
     getAccounts(provider: string, agentId: string): Promise<StoredToken[]>;
+    /**
+     * Get all authentication providers (OAuth2 + Direct) with connection status
+     * Returns unified provider information with type discrimination
+     *
+     * @param agentId Agent/user ID
+     * @returns Array of provider info with auth methods
+     */
+    getAuthenticationProviders(agentId: string): Promise<ProviderInfo[]>;
+    /**
+     * Get auto-generated contexts for direct providers
+     * Automatically creates contexts that expose setup values to AI
+     *
+     * @returns Array of ServiceContext objects, one per direct provider
+     */
+    getDirectProviderContexts(): ServiceContext[];
 }