@shin1ohno/sage 0.9.3 → 0.11.0

package/dist/tools/oauth/authenticate-google.js

@@ -0,0 +1,180 @@
+/**
+ * authenticate_google Tool Handler
+ * Requirements: FR-1 (authenticate_google MCP Tool)
+ *
+ * Orchestrates the complete Google OAuth flow:
+ * 1. Check for existing tokens
+ * 2. Start callback server
+ * 3. Generate authorization URL
+ * 4. Open browser
+ * 5. Wait for callback
+ * 6. Exchange code for tokens
+ * 7. Store tokens
+ */
+import { z } from 'zod';
+import { OAuthCallbackServer } from '../../oauth/oauth-callback-server.js';
+import { GoogleOAuthHandler } from '../../oauth/google-oauth-handler.js';
+import { openBrowser } from '../../utils/browser-opener.js';
+import { oauthLogger } from '../../utils/logger.js';
+/**
+ * Arguments for authenticate_google tool
+ */
+export const AuthenticateGoogleArgsSchema = z.object({
+    /** Force re-authentication even if tokens exist */
+    force: z.boolean().optional().default(false),
+    /** Timeout in seconds (default: 300 = 5 minutes) */
+    timeout: z.number().optional().default(300),
+});
+/**
+ * Handle authenticate_google tool call
+ *
+ * Orchestrates the complete OAuth flow for Google Calendar authentication.
+ *
+ * @param args - Tool arguments
+ * @param context - OAuth tools context (unused, handler creates its own handler)
+ * @returns Authentication result
+ */
+export async function handleAuthenticateGoogle(args, _context) {
+    // Validate arguments
+    const validatedArgs = AuthenticateGoogleArgsSchema.parse(args);
+    const { force, timeout } = validatedArgs;
+    // Check environment variables
+    const clientId = process.env.GOOGLE_CLIENT_ID;
+    const clientSecret = process.env.GOOGLE_CLIENT_SECRET;
+    if (!clientId || !clientSecret) {
+        return {
+            success: false,
+            message: 'Google OAuth設定が見つかりません。',
+            error: '環境変数 GOOGLE_CLIENT_ID と GOOGLE_CLIENT_SECRET を設定してください。\n' +
+                'Google Cloud Console で OAuth クライアントを作成し、認証情報を取得してください。\n' +
+                'https://console.cloud.google.com/apis/credentials',
+        };
+    }
+    // Create OAuth handler
+    const redirectUri = process.env.GOOGLE_REDIRECT_URI || 'http://127.0.0.1:3000/oauth/callback';
+    const oauthHandler = new GoogleOAuthHandler({
+        clientId,
+        clientSecret,
+        redirectUri,
+    });
+    // Check for existing tokens (unless force is true)
+    if (!force) {
+        try {
+            const existingTokens = await oauthHandler.getTokens();
+            if (existingTokens) {
+                const isValid = await oauthHandler.validateToken(existingTokens);
+                if (isValid) {
+                    return {
+                        success: true,
+                        message: '既に Google Calendar で認証済みです。',
+                        alreadyAuthenticated: true,
+                        expiresAt: new Date(existingTokens.expiresAt).toISOString(),
+                        scopes: existingTokens.scope,
+                    };
+                }
+                // Token expired, try to refresh
+                try {
+                    const refreshedTokens = await oauthHandler.refreshAccessToken(existingTokens.refreshToken);
+                    await oauthHandler.storeTokens(refreshedTokens);
+                    return {
+                        success: true,
+                        message: 'トークンを更新しました。',
+                        alreadyAuthenticated: true,
+                        expiresAt: new Date(refreshedTokens.expiresAt).toISOString(),
+                        scopes: refreshedTokens.scope,
+                    };
+                }
+                catch (refreshError) {
+                    // Refresh failed, need to re-authenticate
+                    oauthLogger.info('Token refresh failed, initiating re-authentication');
+                }
+            }
+        }
+        catch (error) {
+            // No tokens or error reading tokens, proceed with authentication
+            oauthLogger.debug({ error }, 'No existing tokens found');
+        }
+    }
+    // Start callback server
+    const callbackServer = new OAuthCallbackServer({
+        timeout: timeout * 1000, // Convert to milliseconds
+    });
+    let serverInfo;
+    try {
+        serverInfo = await callbackServer.start();
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            success: false,
+            message: 'コールバックサーバーの起動に失敗しました。',
+            error: `${errorMessage}\nポートが使用中の可能性があります。他のアプリケーションを終了してから再試行してください。`,
+        };
+    }
+    try {
+        // Generate authorization URL with the callback server's URL
+        // Update the redirect URI to use the actual callback URL
+        const oauthHandlerWithCallback = new GoogleOAuthHandler({
+            clientId,
+            clientSecret,
+            redirectUri: serverInfo.callbackUrl,
+        });
+        const authorizationUrl = await oauthHandlerWithCallback.getAuthorizationUrl(serverInfo.callbackUrl);
+        oauthLogger.info({ authorizationUrl: authorizationUrl.substring(0, 100) + '...' }, 'Generated authorization URL');
+        // Try to open browser
+        const browserResult = await openBrowser(authorizationUrl);
+        if (!browserResult.success) {
+            oauthLogger.warn({ error: browserResult.error }, 'Failed to open browser automatically');
+            // Return URL for manual opening
+            return {
+                success: false,
+                message: 'ブラウザを自動で開けませんでした。以下のURLを手動でブラウザに貼り付けてください。',
+                authorizationUrl,
+                error: browserResult.error,
+            };
+        }
+        oauthLogger.info('Browser opened, waiting for callback...');
+        // Wait for callback
+        const callbackResult = await callbackServer.waitForCallback();
+        if (!callbackResult.success) {
+            return {
+                success: false,
+                message: '認証がキャンセルされたか、エラーが発生しました。',
+                error: `${callbackResult.error}: ${callbackResult.errorDescription}`,
+            };
+        }
+        if (!callbackResult.code) {
+            return {
+                success: false,
+                message: '認証コードを取得できませんでした。',
+                error: 'Authorization code was not received',
+            };
+        }
+        // Exchange code for tokens
+        oauthLogger.info('Exchanging authorization code for tokens...');
+        const tokens = await oauthHandlerWithCallback.exchangeCodeForTokens(callbackResult.code, serverInfo.callbackUrl);
+        // Store tokens
+        await oauthHandlerWithCallback.storeTokens(tokens);
+        oauthLogger.info('OAuth tokens stored successfully');
+        return {
+            success: true,
+            message: 'Google Calendar の認証が完了しました！',
+            expiresAt: new Date(tokens.expiresAt).toISOString(),
+            scopes: tokens.scope,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        oauthLogger.error({ error }, 'OAuth flow failed');
+        return {
+            success: false,
+            message: '認証フローでエラーが発生しました。',
+            error: errorMessage,
+        };
+    }
+    finally {
+        // Always shutdown the server
+        await callbackServer.shutdown();
+    }
+}
+//# sourceMappingURL=authenticate-google.js.map

package/dist/tools/oauth/authenticate-google.js.map

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

package/dist/tools/oauth/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OAuth Tools Module
+ * Requirements: FR-1 (authenticate_google MCP Tool)
+ *
+ * Exports OAuth-related MCP tool handlers and context.
+ */
+import { GoogleOAuthHandler } from '../../oauth/google-oauth-handler.js';
+/**
+ * OAuth Tools Context
+ *
+ * Provides access to OAuth-related services for tool handlers.
+ */
+export interface OAuthToolsContext {
+    /**
+     * Get GoogleOAuthHandler instance
+     * Returns null if Google OAuth is not configured
+     */
+    getGoogleOAuthHandler: () => GoogleOAuthHandler | null;
+    /**
+     * Create a new GoogleOAuthHandler with the current config
+     */
+    createGoogleOAuthHandler: () => GoogleOAuthHandler | null;
+}
+export { handleAuthenticateGoogle } from './authenticate-google.js';
+export type { AuthenticateGoogleArgs, AuthenticateGoogleResult } from './authenticate-google.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/oauth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/oauth/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,qBAAqB,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAC;IAEvD;;OAEG;IACH,wBAAwB,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAC;CAC3D;AAGD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,YAAY,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/tools/oauth/index.js

@@ -0,0 +1,9 @@
+/**
+ * OAuth Tools Module
+ * Requirements: FR-1 (authenticate_google MCP Tool)
+ *
+ * Exports OAuth-related MCP tool handlers and context.
+ */
+// Export handler
+export { handleAuthenticateGoogle } from './authenticate-google.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/oauth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/oauth/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,iBAAiB;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/tools/setup/handlers.d.ts

@@ -9,6 +9,7 @@
  */
 import { SetupWizard } from '../../setup/wizard.js';
 import type { UserConfig } from '../../types/index.js';
+import type { ConfigReloadService } from '../../config/config-reload-service.js';
 /**
  * Wizard session type (from SetupWizard)
  */
@@ -22,6 +23,7 @@ export interface SetupContext {
     getWizardSession: () => WizardSession | null;
     setWizardSession: (session: WizardSession | null) => void;
     initializeServices: (config: UserConfig) => void;
+    getConfigReloadService?: () => ConfigReloadService | null;
 }
 /**
  * check_setup_status handler

package/dist/tools/setup/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/setup/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,aAAa,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,UAAU,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC,gBAAgB,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;IAC7C,gBAAgB,EAAE,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1D,kBAAkB,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,YAAY;;;;;GAsC7D;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;;;;;GAyBlC;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE;;;;;GAoDxD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE;;;;;GA2C3B"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/setup/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAGjF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,aAAa,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,UAAU,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC,gBAAgB,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;IAC7C,gBAAgB,EAAE,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1D,kBAAkB,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACjD,sBAAsB,CAAC,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;CAC3D;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,YAAY;;;;;GA0D7D;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;;;;;GAyBlC;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE;;;;;GAoDxD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE;;;;;GA2C3B"}

package/dist/tools/setup/handlers.js

@@ -36,6 +36,18 @@ export async function handleCheckSetupStatus(ctx) {
             nextAction: 'start_setup_wizard',
         });
     }
+    // Build hot reload status if service is available
+    let hotReload;
+    if (ctx.getConfigReloadService) {
+        const configReloadService = ctx.getConfigReloadService();
+        if (configReloadService) {
+            hotReload = {
+                enabled: configReloadService.isAutoReloadEnabled(),
+                watching: configReloadService.isAutoReloadEnabled(), // Watching when auto-reload is enabled
+                lastReload: configReloadService.getLastReloadResult(),
+            };
+        }
+    }
     return createToolResponse({
         setupComplete: true,
         configExists: true,
@@ -47,7 +59,9 @@ export async function handleCheckSetupStatus(ctx) {
             'find_available_slots',
             'sync_to_notion',
             'update_config',
+            'reload_config',
         ],
+        ...(hotReload && { hotReload }),
     });
 }
 /**

package/dist/tools/setup/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../src/tools/setup/handlers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../src/tools/setup/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAmB1E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAiB;IAC5D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IAEhC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,kBAAkB,CAAC;YACxB,aAAa,EAAE,KAAK;YACpB,YAAY,EAAE,KAAK;YACnB,OAAO,EACL,wDAAwD;YAC1D,UAAU,EAAE,oBAAoB;SACjC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,kBAAkB,CAAC;YACxB,aAAa,EAAE,KAAK;YACpB,YAAY,EAAE,IAAI;YAClB,OAAO,EACL,2CAA2C;YAC7C,UAAU,EAAE,oBAAoB;SACjC,CAAC,CAAC;IACL,CAAC;IAED,kDAAkD;IAClD,IAAI,SAIS,CAAC;IAEd,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;QAC/B,MAAM,mBAAmB,GAAG,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACzD,IAAI,mBAAmB,EAAE,CAAC;YACxB,SAAS,GAAG;gBACV,OAAO,EAAE,mBAAmB,CAAC,mBAAmB,EAAE;gBAClD,QAAQ,EAAE,mBAAmB,CAAC,mBAAmB,EAAE,EAAE,uCAAuC;gBAC5F,UAAU,EAAE,mBAAmB,CAAC,mBAAmB,EAAE;aACtD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,kBAAkB,CAAC;QACxB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI;QAC3B,OAAO,EAAE,mCAAmC;QAC5C,cAAc,EAAE;YACd,eAAe;YACf,cAAc;YACd,sBAAsB;YACtB,gBAAgB;YAChB,eAAe;YACf,eAAe;SAChB;QACD,GAAG,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;KAChC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAiB,EACjB,IAAiC;IAEjC,MAAM,EAAE,IAAI,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACtD,GAAG,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAEpC,MAAM,QAAQ,GAAG,WAAW,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAE/D,OAAO,kBAAkB,CAAC;QACxB,SAAS,EAAE,aAAa,CAAC,SAAS;QAClC,WAAW,EAAE,aAAa,CAAC,WAAW;QACtC,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAClB,CAAC,aAAa,CAAC,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,GAAG,CAC7D;QACD,QAAQ,EAAE;YACR,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B;QACD,OAAO,EAAE,8BAA8B;KACxC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAAiB,EACjB,IAAuD;IAEvD,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,MAAM,aAAa,GAAG,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAE7C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,kBAAkB,CAAC;YACxB,KAAK,EAAE,IAAI;YACX,OAAO,EACL,kDAAkD;SACrD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,cAAc,CAAC,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,kBAAkB,CAAC;YACxB,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,MAAM,CAAC,KAAK;YACrB,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,kBAAkB,CAAC;YACxB,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,aAAa,CAAC,SAAS;YAClC,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,OAAO,EACL,4CAA4C;YAC9C,UAAU,EAAE,aAAa;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAEnE,OAAO,kBAAkB,CAAC;QACxB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,aAAa,CAAC,WAAW;QACtC,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAClB,CAAC,aAAa,CAAC,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,GAAG,CAC7D;QACD,QAAQ,EAAE;YACR,EAAE,EAAE,YAAY,CAAC,EAAE;YACnB,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,YAAY,EAAE,YAAY,CAAC,YAAY;YACvC,QAAQ,EAAE,YAAY,CAAC,QAAQ;SAChC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAiB,EACjB,IAA0B;IAE1B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEzB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,kBAAkB,CAAC;YACxB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,mBAAmB;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,aAAa,GAAG,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAE7C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,kBAAkB,CAAC;YACxB,KAAK,EAAE,IAAI;YACX,OAAO,EACL,kDAAkD;SACrD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzB,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC3B,GAAG,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAElC,OAAO,kBAAkB,CAAC;YACxB,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,YAAY,CAAC,aAAa,EAAE;YACxC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI;YAC7B,OAAO,EAAE,aAAa,SAAS,CAAC,IAAI,CAAC,IAAI,4BAA4B;YACrE,cAAc,EAAE;gBACd,eAAe;gBACf,cAAc;gBACd,sBAAsB;gBACtB,gBAAgB;aACjB;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,oBAAoB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/types/hot-reload.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Hot Reload type definitions
+ */
+import type { UserConfig } from './config.js';
+/**
+ * Result of a configuration reload operation
+ */
+export interface ReloadResult {
+    /** Whether the reload was successful */
+    success: boolean;
+    /** List of config sections that were changed */
+    changedSections: string[];
+    /** List of services that were re-initialized */
+    reinitializedServices: string[];
+    /** Error message if reload failed */
+    error?: string;
+    /** ISO 8601 timestamp of the reload */
+    timestamp: string;
+    /** Duration of the reload operation in milliseconds */
+    durationMs: number;
+}
+/**
+ * State of the config file watcher
+ */
+export interface WatcherState {
+    /** Whether the watcher is currently active */
+    isWatching: boolean;
+    /** List of file paths being watched */
+    watchedPaths: string[];
+    /** ISO 8601 timestamp of last detected change */
+    lastChangeDetected?: string;
+    /** Number of errors encountered during watching */
+    errorCount: number;
+}
+/**
+ * Hot reload status for MCP tool responses
+ */
+export interface ReloadStatus {
+    /** Whether auto-reload is enabled */
+    autoReloadEnabled: boolean;
+    /** Current state of the file watcher */
+    watcherState: WatcherState;
+    /** Result of the last reload operation */
+    lastReloadResult: ReloadResult | null;
+    /** Summary of current config */
+    currentConfig: {
+        lastUpdated: string;
+        sections: string[];
+    };
+}
+/**
+ * Interface for services that can be reloaded without restart
+ */
+export interface ReloadableService {
+    /** Unique name identifying this service */
+    readonly name: string;
+    /** Config sections this service depends on */
+    readonly dependsOnSections: readonly string[];
+    /**
+     * Re-initialize the service with new configuration
+     * @param config The new configuration to use
+     */
+    reinitialize(config: UserConfig): Promise<void>;
+    /**
+     * Gracefully shutdown the service before re-initialization
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Options for ConfigWatcher
+ */
+export interface ConfigWatcherOptions {
+    /** Debounce delay in milliseconds (default: 500) */
+    debounceMs?: number;
+    /** Config file paths to watch (defaults to user and remote config paths) */
+    configPaths?: string[];
+}
+/**
+ * Options for ConfigReloadService
+ */
+export interface ConfigReloadServiceOptions {
+    /** ConfigWatcher instance to use */
+    watcher?: ConfigWatcher;
+    /** Whether to enable automatic reload on file changes (default: true) */
+    enableAutoReload?: boolean;
+    /** Callback invoked after each reload attempt */
+    onReload?: (result: ReloadResult) => void;
+}
+/**
+ * Hot reload configuration from environment variables
+ */
+export interface HotReloadConfig {
+    /** Whether hot reload is disabled */
+    disabled: boolean;
+    /** Debounce delay in milliseconds */
+    debounceMs: number;
+}
+/**
+ * Result of config diff operation
+ */
+export interface ConfigDiff {
+    /** Top-level sections that have changed */
+    changedSections: string[];
+    /** Keys that were added */
+    addedKeys: Record<string, unknown>;
+    /** Keys that were removed */
+    removedKeys: string[];
+    /** Keys that were modified with old and new values */
+    modifiedKeys: Record<string, {
+        old: unknown;
+        new: unknown;
+    }>;
+}
+/**
+ * ConfigWatcher event types
+ */
+export interface ConfigWatcherEvents {
+    change: (path: string) => void;
+    error: (error: Error) => void;
+}
+/**
+ * Abstract interface for ConfigWatcher (for type reference in options)
+ */
+export interface ConfigWatcher {
+    start(): Promise<void>;
+    stop(): void;
+    isWatching(): boolean;
+    on<K extends keyof ConfigWatcherEvents>(event: K, listener: ConfigWatcherEvents[K]): this;
+    off<K extends keyof ConfigWatcherEvents>(event: K, listener: ConfigWatcherEvents[K]): this;
+}
+//# sourceMappingURL=hot-reload.d.ts.map

package/dist/types/hot-reload.d.ts.map

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

package/dist/types/hot-reload.js

@@ -0,0 +1,5 @@
+/**
+ * Hot Reload type definitions
+ */
+export {};
+//# sourceMappingURL=hot-reload.js.map

package/dist/types/hot-reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot-reload.js","sourceRoot":"","sources":["../../src/types/hot-reload.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/browser-opener.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Browser Opener Utility
+ * Requirements: FR-3 (Browser Opening)
+ *
+ * Cross-platform utility to open URLs in the default browser.
+ */
+/**
+ * Result of browser open operation
+ */
+export interface BrowserOpenResult {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Open URL in default browser
+ *
+ * Uses platform-appropriate command:
+ * - macOS: open
+ * - Linux: xdg-open
+ * - Windows: start
+ *
+ * @param url - URL to open
+ * @returns Result indicating success or failure
+ */
+export declare function openBrowser(url: string): Promise<BrowserOpenResult>;
+/**
+ * Get the command that would be used to open a URL
+ *
+ * Useful for testing and debugging.
+ *
+ * @param url - URL to open
+ * @returns Command string
+ */
+export declare function getBrowserCommand(url: string): string;
+//# sourceMappingURL=browser-opener.d.ts.map

package/dist/utils/browser-opener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-opener.d.ts","sourceRoot":"","sources":["../../src/utils/browser-opener.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8BzE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYrD"}

package/dist/utils/browser-opener.js

@@ -0,0 +1,71 @@
+/**
+ * Browser Opener Utility
+ * Requirements: FR-3 (Browser Opening)
+ *
+ * Cross-platform utility to open URLs in the default browser.
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Open URL in default browser
+ *
+ * Uses platform-appropriate command:
+ * - macOS: open
+ * - Linux: xdg-open
+ * - Windows: start
+ *
+ * @param url - URL to open
+ * @returns Result indicating success or failure
+ */
+export async function openBrowser(url) {
+    const platform = process.platform;
+    let command;
+    switch (platform) {
+        case 'darwin':
+            // macOS
+            command = `open "${url}"`;
+            break;
+        case 'win32':
+            // Windows - use start with empty title
+            command = `start "" "${url}"`;
+            break;
+        case 'linux':
+        default:
+            // Linux and other Unix-like systems
+            command = `xdg-open "${url}"`;
+            break;
+    }
+    try {
+        await execAsync(command);
+        return { success: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            success: false,
+            error: `Failed to open browser: ${errorMessage}`,
+        };
+    }
+}
+/**
+ * Get the command that would be used to open a URL
+ *
+ * Useful for testing and debugging.
+ *
+ * @param url - URL to open
+ * @returns Command string
+ */
+export function getBrowserCommand(url) {
+    const platform = process.platform;
+    switch (platform) {
+        case 'darwin':
+            return `open "${url}"`;
+        case 'win32':
+            return `start "" "${url}"`;
+        case 'linux':
+        default:
+            return `xdg-open "${url}"`;
+    }
+}
+//# sourceMappingURL=browser-opener.js.map

package/dist/utils/browser-opener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-opener.js","sourceRoot":"","sources":["../../src/utils/browser-opener.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAUlC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,IAAI,OAAe,CAAC;IAEpB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,QAAQ;YACR,OAAO,GAAG,SAAS,GAAG,GAAG,CAAC;YAC1B,MAAM;QACR,KAAK,OAAO;YACV,uCAAuC;YACvC,OAAO,GAAG,aAAa,GAAG,GAAG,CAAC;YAC9B,MAAM;QACR,KAAK,OAAO,CAAC;QACb;YACE,oCAAoC;YACpC,OAAO,GAAG,aAAa,GAAG,GAAG,CAAC;YAC9B,MAAM;IACV,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC9E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,2BAA2B,YAAY,EAAE;SACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,SAAS,GAAG,GAAG,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,aAAa,GAAG,GAAG,CAAC;QAC7B,KAAK,OAAO,CAAC;QACb;YACE,OAAO,aAAa,GAAG,GAAG,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/version.js

@@ -7,7 +7,7 @@
 import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 // Fallback version - keep in sync with package.json
-const FALLBACK_VERSION = '0.9.2';
+const FALLBACK_VERSION = '0.11.0';
 function getVersion() {
     // Try to find package.json from current working directory
     const pkgPath = join(process.cwd(), 'package.json');

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,oDAAoD;AACpD,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,SAAS,UAAU;IACjB,0DAA0D;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACnC,OAAO,GAAG,CAAC,OAAO,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,oDAAoD;AACpD,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAElC,SAAS,UAAU;IACjB,0DAA0D;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACnC,OAAO,GAAG,CAAC,OAAO,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shin1ohno/sage",
-  "version": "0.9.3",
+  "version": "0.11.0",
   "description": "AI Task Management Assistant MCP Server for Claude Desktop and Claude Code",
   "main": "dist/index.js",
   "bin": {