@dainprotocol/service-sdk 2.0.53 → 2.0.54

package/dist/service/oauth2Manager.js

@@ -2,17 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OAuth2Manager = void 0;
 const oauth2_token_manager_1 = require("@dainprotocol/oauth2-token-manager");
+const direct_auth_setup_1 = require("./direct-auth-setup");
 /**
  * OAuth2Manager - A clean integration with @dainprotocol/oauth2-token-manager
+ * Supports both OAuth2 and direct configuration providers
  */
 class OAuth2Manager {
     client;
+    setupManager;
+    storage;
     baseUrl;
     providerConfigs = {};
+    directProviders = new Map();
     constructor(baseUrl, storage) {
         this.baseUrl = baseUrl;
+        this.storage = storage || new oauth2_token_manager_1.InMemoryStorageAdapter();
         this.client = new oauth2_token_manager_1.OAuth2Client({
-            storage: storage || new oauth2_token_manager_1.InMemoryStorageAdapter(),
+            storage: this.storage,
             // Ensure auto-refresh is enabled with appropriate settings
             autoRefresh: {
                 enabled: true,
@@ -22,13 +28,14 @@ class OAuth2Manager {
                 }
             }
         });
+        this.setupManager = new direct_auth_setup_1.DirectAuthSetupManager(this.storage);
     }
     /**
-     * Register a provider with the OAuth2 client
+     * Register an OAuth2 provider
      */
     registerProvider(name, config) {
-        // Store the original config for reference
-        this.providerConfigs[name] = config;
+        // Store with type discriminator
+        this.providerConfigs[name] = { ...config, type: 'oauth2' };
         // Convert to OAuth2Config format expected by the library
         const oauth2Config = {
             clientId: config.clientId,
@@ -56,6 +63,16 @@ class OAuth2Manager {
         };
         this.client.registerProvider(name, oauth2Config);
     }
+    /**
+     * Register a direct configuration provider (non-OAuth2)
+     * Users provide config directly (e.g., Telegram chat ID) without external OAuth flow
+     */
+    registerDirectProvider(name, config) {
+        // Store with type discriminator - no OAuth2Client registration needed
+        this.providerConfigs[name] = { ...config, type: 'direct' };
+        // Track separately for automatic context generation
+        this.directProviders.set(name, config);
+    }
     /**
      * Generate authorization URL
      */
@@ -121,16 +138,30 @@ class OAuth2Manager {
         await this.client.deleteToken(provider, `${agentId}@dain.local`);
     }
     /**
-     * Get all configured providers
+     * Get all configured OAuth2 providers (legacy - returns only OAuth2, not direct providers)
+     * @deprecated Use getAuthenticationProviders() for full provider list
      */
     getProviders() {
-        return { ...this.providerConfigs };
+        const oauth2Only = {};
+        for (const [name, config] of Object.entries(this.providerConfigs)) {
+            if (config.type === 'oauth2') {
+                const { type, ...oauth2Config } = config;
+                oauth2Only[name] = oauth2Config;
+            }
+        }
+        return oauth2Only;
     }
     /**
-     * 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) {
-        return this.providerConfigs[name];
+        const config = this.providerConfigs[name];
+        if (config && config.type === 'oauth2') {
+            const { type, ...oauth2Config } = config;
+            return oauth2Config;
+        }
+        return undefined;
     }
     /**
      * Get all accounts (tokens) for a user and provider with auto-refresh
@@ -153,6 +184,86 @@ class OAuth2Manager {
             return [];
         }
     }
+    /**
+     * 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
+     */
+    async getAuthenticationProviders(agentId) {
+        const results = [];
+        for (const [name, config] of Object.entries(this.providerConfigs)) {
+            const connected = await this.hasValidTokens(name, agentId);
+            const baseInfo = {
+                name,
+                type: config.type,
+                connected,
+                reason: config.reason,
+                requiredTools: config.requiredTools,
+                scopes: config.scopes,
+                logoUrl: config.logoUrl,
+            };
+            if (config.type === 'oauth2') {
+                // OAuth2 provider - generate auth URL if not connected
+                results.push({
+                    ...baseInfo,
+                    authMethod: connected ? null : {
+                        type: 'oauth2',
+                        authUrl: await this.generateAuthUrl(name, agentId)
+                    }
+                });
+            }
+            else if (config.type === 'direct') {
+                // Direct provider - return onboarding tool if not connected
+                results.push({
+                    ...baseInfo,
+                    authMethod: connected ? null : {
+                        type: 'direct',
+                        onboardingTool: config.onboardingTool
+                    }
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * 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() {
+        const contexts = [];
+        for (const [providerName, config] of this.directProviders) {
+            contexts.push({
+                id: `${providerName}-config`,
+                name: `${config.reason || providerName} Configuration`,
+                description: `Auto-generated context for ${providerName} setup values. Access via {{config.${providerName}}}`,
+                getContextData: async (agentInfo, extraData) => {
+                    try {
+                        const oauth2Client = extraData?.oauth2Client;
+                        if (!oauth2Client) {
+                            return {};
+                        }
+                        // Query token storage for this provider's metadata
+                        const tokens = await oauth2Client.getTokensByUserId(agentInfo.id);
+                        const providerToken = tokens?.find((t) => t.provider === providerName);
+                        if (!providerToken?.metadata) {
+                            return {};
+                        }
+                        // Return metadata as context (e.g., { chatId: "123456" } for Telegram)
+                        return providerToken.metadata;
+                    }
+                    catch (error) {
+                        console.error(`[OAuth2Manager] Failed to get context for ${providerName}:`, error);
+                        return {};
+                    }
+                }
+            });
+        }
+        return contexts;
+    }
 }
 exports.OAuth2Manager = OAuth2Manager;
 //# sourceMappingURL=oauth2Manager.js.map

package/dist/service/oauth2Manager.js.map

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

package/dist/service/server.js

@@ -310,8 +310,15 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
     }
     // Setup default ping route
     app.get("/ping", (c) => c.json({ message: "pong", platform: "DAIN", service_version: metadata.version, dain_sdk_version: package_json_1.default.version }));
-    // Metadata endpoint
-    app.get("/metadata", (c) => c.json(metadata));
+    // Metadata endpoint - includes computed supportsUserActions from tools
+    app.get("/metadata", (c) => {
+        // Compute service-level capability: does ANY tool support user actions (HITL)?
+        const supportsUserActions = tools.some((tool) => tool.supportsUserActions === true);
+        return c.json({
+            ...metadata,
+            supportsUserActions,
+        });
+    });
     // Tools list endpoint
     app.get("/tools", (c) => {
         const toolInfo = tools.map((tool) => {
@@ -328,6 +335,7 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
                 outputSchema,
                 interface: tool.interface,
                 suggestConfirmation: tool.suggestConfirmation,
+                supportsUserActions: tool.supportsUserActions,
             };
         });
         console.log(`[Service SDK Server] Returning ${toolInfo.length} tools`);
@@ -346,7 +354,10 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
         }
         // Process plugins for the request
         const processedPluginData = await processPluginsForRequest(body, agentInfo);
-        const contextInfo = contexts.map((context) => ({
+        // Merge manual contexts with auto-generated direct provider contexts
+        const autoContexts = app.oauth2?.getDirectProviderContexts?.() || [];
+        const allContexts = [...contexts, ...autoContexts];
+        const contextInfo = allContexts.map((context) => ({
             id: context.id,
             name: context.name,
             description: context.description,
@@ -357,7 +368,10 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
     });
     // Primary endpoint for getting a context's data with plugin support
     app.post("/contexts/:contextId", async (c) => {
-        const context = contexts.find((context) => context.id === c.req.param("contextId"));
+        // Merge manual contexts with auto-generated direct provider contexts
+        const autoContexts = app.oauth2?.getDirectProviderContexts?.() || [];
+        const allContexts = [...contexts, ...autoContexts];
+        const context = allContexts.find((context) => context.id === c.req.param("contextId"));
         if (context) {
             const agentInfo = await getAgentInfo(c);
             // Get plugin data from request body
@@ -407,8 +421,11 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
         const processedPluginData = await processPluginsForRequest(body, agentInfo);
         // Get oauth2 client if available
         const oauth2Client = app.oauth2 ? app.oauth2.getClient() : undefined;
+        // Merge manual contexts with auto-generated direct provider contexts
+        const autoContexts = app.oauth2?.getDirectProviderContexts?.() || [];
+        const allContexts = [...contexts, ...autoContexts];
         // Get all contexts with plugins and oauth2Client
-        const contextsFull = await Promise.all(contexts.map(async (context) => ({
+        const contextsFull = await Promise.all(allContexts.map(async (context) => ({
             id: context.id,
             name: context.name,
             description: context.description,
@@ -483,7 +500,8 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
                 return null;
             const widgetData = await widget.getWidget(agentInfo, {
                 plugins: processedPluginData.plugins,
-                oauth2Client: oauth2Client
+                oauth2Client: oauth2Client,
+                app: app // Pass app for access to setupManager via app.oauth2.getSetupManager()
             });
             return {
                 id: widget.id,
@@ -544,7 +562,8 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
         const oauth2Client = app.oauth2 ? app.oauth2.getClient() : undefined;
         const widgetData = await widget.getWidget(agentInfo, {
             plugins: processedPluginData.plugins,
-            oauth2Client: oauth2Client
+            oauth2Client: oauth2Client,
+            app: app // Pass app for access to setupManager via app.oauth2.getSetupManager()
         });
         // Create the response
         const response = {
@@ -809,6 +828,7 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
                 outputSchema,
                 interface: tool.interface,
                 suggestConfirmation: tool.suggestConfirmation,
+                supportsUserActions: tool.supportsUserActions,
             };
         });
         console.log(`[getAllToolsAsJsonSchema GET] Returning ${toolInfo.length} tools`);
@@ -869,6 +889,7 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
                 outputSchema,
                 interface: tool.interface,
                 suggestConfirmation: tool.suggestConfirmation,
+                supportsUserActions: tool.supportsUserActions,
             };
         });
         const response = {
@@ -1049,26 +1070,36 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
     if (config.routes) {
         config.routes(app);
     }
-    if (config.oauth2?.providers) {
+    // Initialize OAuth2/DirectAuth if either providers or directProviders are configured
+    if (config.oauth2?.providers || config.oauth2?.directProviders) {
         if (!config.oauth2?.baseUrl) {
-            throw new Error("config.oauth2.baseUrl is required for OAuth2");
+            throw new Error("config.oauth2.baseUrl is required for OAuth2/DirectAuth");
         }
         const oauth2Handler = new oauth2_1.OAuth2Handler(bs58_1.default.encode(privateKey), config.oauth2.baseUrl, config.oauth2.tokenStore);
         // Auto-generate service slug from metadata title
         const serviceSlug = (0, core_1.toSlug)(metadata.title);
         // Register providers and auto-create OAuth tools
         const autoOAuth2Tools = [];
-        Object.entries(config.oauth2.providers).forEach(([providerName, providerConfig]) => {
-            oauth2Handler.registerProvider(providerName, providerConfig);
-            // Auto-create OAuth tool for this provider
-            debugLog(`[OAuth Auto-Registration] Creating OAuth tool: oauth2-${serviceSlug}-${providerName}`);
-            const oauthTool = (0, core_1.createOAuth2Tool)(providerName, serviceSlug, {
-                logoUrl: providerConfig.logoUrl,
-                reason: providerConfig.reason,
-                requiredTools: providerConfig.requiredTools
+        if (config.oauth2.providers) {
+            Object.entries(config.oauth2.providers).forEach(([providerName, providerConfig]) => {
+                oauth2Handler.registerProvider(providerName, providerConfig);
+                // Auto-create OAuth tool for this provider
+                debugLog(`[OAuth Auto-Registration] Creating OAuth tool: oauth2-${serviceSlug}-${providerName}`);
+                const oauthTool = (0, core_1.createOAuth2Tool)(providerName, serviceSlug, {
+                    logoUrl: providerConfig.logoUrl,
+                    reason: providerConfig.reason,
+                    requiredTools: providerConfig.requiredTools
+                });
+                autoOAuth2Tools.push(oauthTool);
             });
-            autoOAuth2Tools.push(oauthTool);
-        });
+        }
+        // Register direct providers (non-OAuth2)
+        if (config.oauth2.directProviders) {
+            Object.entries(config.oauth2.directProviders).forEach(([providerName, providerConfig]) => {
+                oauth2Handler.registerDirectProvider(providerName, providerConfig);
+                debugLog(`[Direct Provider Auto-Registration] Registered direct provider: ${providerName} with onboarding tool: ${providerConfig.onboardingTool}`);
+            });
+        }
         // Inject auto-created OAuth tools into the tools array
         if (autoOAuth2Tools.length > 0) {
             debugLog(`[OAuth Auto-Registration] Injecting ${autoOAuth2Tools.length} OAuth tool(s) into tools array`);
@@ -1150,6 +1181,15 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
         })));
         return c.json(providersWithStatus);
     });
+    // Get all authentication providers (OAuth2 + Direct) with unified info
+    app.get("/oauth2/authentication-providers", async (c) => {
+        if (!app.oauth2) {
+            return c.json([]);
+        }
+        const agentInfo = await getAgentInfo(c);
+        const providers = await app.oauth2.getAuthenticationProviders(agentInfo.id);
+        return c.json(providers);
+    });
     // Get auth URL for specific provider
     app.get("/oauth2/connect/:provider", async (c) => {
         debugLog("[OAuth2 Connect] Route hit - START");
@@ -1189,6 +1229,40 @@ function setupHttpServer(config, tools, services, toolboxes, metadata, privateKe
             });
         }
     });
+    // Direct auth setup status polling endpoint (RFC 8628 Device Authorization Grant pattern)
+    // Used when user completes authorization on external device/app (e.g., Telegram bot)
+    app.get("/oauth2/direct-setup-status/:provider", async (c) => {
+        if (!app.oauth2) {
+            throw new http_exception_1.HTTPException(404, { message: "OAuth2 not configured" });
+        }
+        const provider = c.req.param("provider");
+        const agentInfo = await getAgentInfo(c);
+        const setupManager = app.oauth2.getSetupManager();
+        // Check if setup is already complete
+        const isComplete = await setupManager.isSetupComplete(agentInfo.id, provider);
+        if (isComplete) {
+            const config = await setupManager.getProviderConfig(agentInfo.id, provider);
+            return c.json({
+                status: 'complete',
+                config: config ? { configuredAt: config.configuredAt } : undefined
+            });
+        }
+        // Check if there's a pending setup
+        const pendingSetup = await setupManager.getPendingSetup(agentInfo.id, provider);
+        if (pendingSetup) {
+            const expiresIn = Math.max(0, Math.floor((pendingSetup.expiresAt - Date.now()) / 1000));
+            return c.json({
+                status: 'authorization_pending',
+                expires_in: expiresIn,
+                interval: 5 // Poll every 5 seconds
+            });
+        }
+        // No setup in progress
+        return c.json({
+            status: 'not_found',
+            error: 'No setup in progress for this provider'
+        });
+    });
     // Get all human actions for a process
     app.get("/processes/:processId/human-actions", async (c) => {
         const processId = c.req.param("processId");