@shin1ohno/sage 0.3.0 → 0.5.5

package/dist/cli/main-entry.js

@@ -0,0 +1,192 @@
+/**
+ * Main Entry Point for sage
+ * Requirements: 14.1, 14.2, 14.3
+ *
+ * Handles server startup based on CLI options.
+ */
+import { getHelpMessage, getVersion } from './parser.js';
+import { createHTTPServerWithConfig } from './http-server-with-config.js';
+import { loadRemoteConfig, DEFAULT_REMOTE_CONFIG_PATH } from './remote-config-loader.js';
+import { createSecretAuthenticator } from './secret-auth.js';
+/**
+ * Start the server based on CLI options
+ * @param options - Parsed CLI options
+ * @returns Server start result
+ */
+export async function startServer(options) {
+    // Handle help
+    if (options.help) {
+        return {
+            mode: 'help',
+            success: true,
+            message: getHelpMessage(),
+        };
+    }
+    // Handle version
+    if (options.version) {
+        return {
+            mode: 'version',
+            success: true,
+            message: getVersion(),
+        };
+    }
+    // Handle token generation
+    if (options.generateToken) {
+        try {
+            const configPath = options.config ?? DEFAULT_REMOTE_CONFIG_PATH;
+            const config = await loadRemoteConfig(configPath);
+            if (config.remote.auth.type === 'jwt') {
+                // JWT mode: generate token using secret
+                const secret = options.authSecret ?? config.remote.auth.secret;
+                if (!secret) {
+                    return {
+                        mode: 'token-gen',
+                        success: false,
+                        error: 'JWT secret not configured. Set auth.secret in remote-config.json or use SAGE_AUTH_SECRET environment variable',
+                    };
+                }
+                const expiresIn = config.remote.auth.expiresIn ?? '24h';
+                const authenticator = createSecretAuthenticator({ secret, expiresIn });
+                const result = await authenticator.authenticate(secret);
+                if (!result.success || !result.token) {
+                    return {
+                        mode: 'token-gen',
+                        success: false,
+                        error: result.error ?? 'Failed to generate token',
+                    };
+                }
+                return {
+                    mode: 'token-gen',
+                    success: true,
+                    token: result.token,
+                    expiresIn: result.expiresIn,
+                    message: `Bearer token generated successfully.
+
+Token: ${result.token}
+Expires in: ${result.expiresIn ?? 86400} seconds
+
+Usage with Claude Code:
+  claude mcp add --transport http sage "http://your-server:${config.remote.port}/mcp" --header "Authorization: Bearer ${result.token}"`,
+                };
+            }
+            else if (config.remote.auth.type === 'oauth2') {
+                // OAuth2 mode: check if static tokens are enabled
+                const oauthConfig = config.remote.auth;
+                const issuer = oauthConfig.issuer || `http://localhost:${config.remote.port}`;
+                if (!oauthConfig.allowStaticTokens || !oauthConfig.staticTokenSecret) {
+                    return {
+                        mode: 'token-gen',
+                        success: false,
+                        error: `Static token generation is not enabled for OAuth2 mode.
+
+To enable it, add the following to your remote-config.json:
+{
+  "remote": {
+    "auth": {
+      "type": "oauth2",
+      ...
+      "allowStaticTokens": true,
+      "staticTokenSecret": "your-secret-key-at-least-32-characters-long"
+    }
+  }
+}
+
+Alternatively, use the OAuth2 flow with SSH port forwarding.`,
+                    };
+                }
+                // Generate static JWT token using the configured secret
+                const authenticator = createSecretAuthenticator({
+                    secret: oauthConfig.staticTokenSecret,
+                    expiresIn: oauthConfig.accessTokenExpiry ?? '1h',
+                });
+                const result = await authenticator.authenticate(oauthConfig.staticTokenSecret);
+                if (!result.success || !result.token) {
+                    return {
+                        mode: 'token-gen',
+                        success: false,
+                        error: result.error ?? 'Failed to generate token',
+                    };
+                }
+                return {
+                    mode: 'token-gen',
+                    success: true,
+                    token: result.token,
+                    expiresIn: result.expiresIn,
+                    message: `Bearer token generated successfully (OAuth2 + Static Token mode).
+
+Token: ${result.token}
+Expires in: ${result.expiresIn ?? 3600} seconds
+
+This token can be used alongside the OAuth2 flow for CLI access.
+
+Usage with Claude Code:
+  claude mcp add --transport http sage "${issuer}/mcp" --header "Authorization: Bearer ${result.token}"`,
+                };
+            }
+            else {
+                // No auth mode
+                return {
+                    mode: 'token-gen',
+                    success: false,
+                    error: 'Authentication is disabled. Set auth.type to "jwt" or "oauth2" in remote-config.json',
+                };
+            }
+        }
+        catch (error) {
+            return {
+                mode: 'token-gen',
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    // Start in HTTP mode if remote flag is set
+    if (options.remote) {
+        try {
+            // createHTTPServerWithConfig already starts the server
+            const server = await createHTTPServerWithConfig({
+                configPath: options.config,
+                port: options.port,
+                host: options.host,
+                authSecret: options.authSecret,
+            });
+            return {
+                mode: 'http',
+                success: true,
+                port: server.getPort(),
+                host: server.getHost(),
+                configPath: options.config,
+                authEnabled: server.isAuthEnabled(),
+                stop: async () => {
+                    await server.stop();
+                },
+            };
+        }
+        catch (error) {
+            return {
+                mode: 'http',
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    // Start in Stdio mode (default)
+    try {
+        // In Stdio mode, we don't actually start the server here
+        // The MCP server will be connected via StdioServerTransport
+        // This is handled in the main index.ts
+        return {
+            mode: 'stdio',
+            success: true,
+            configPath: options.config,
+        };
+    }
+    catch (error) {
+        return {
+            mode: 'stdio',
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+//# sourceMappingURL=main-entry.js.map

package/dist/cli/main-entry.js.map

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

package/dist/cli/mcp-handler.d.ts

@@ -0,0 +1,56 @@
+/**
+ * MCP Handler for HTTP Server
+ * Requirements: 13.1, 13.4, 13.5
+ *
+ * Handles MCP JSON-RPC requests over HTTP, providing access to all sage tools.
+ */
+/**
+ * MCP JSON-RPC Request
+ */
+export interface MCPRequest {
+    jsonrpc: '2.0';
+    id: number | string | null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * MCP JSON-RPC Response
+ */
+export interface MCPResponse {
+    jsonrpc: '2.0';
+    id: number | string | null;
+    result?: unknown;
+    error?: MCPError;
+}
+/**
+ * MCP Error
+ */
+export interface MCPError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * Tool definition
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * MCP Handler interface
+ */
+export interface MCPHandler {
+    handleRequest(request: MCPRequest): Promise<MCPResponse>;
+    listTools(): ToolDefinition[];
+}
+/**
+ * Create an MCP handler
+ */
+export declare function createMCPHandler(): Promise<MCPHandler>;
+//# sourceMappingURL=mcp-handler.d.ts.map

package/dist/cli/mcp-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-handler.d.ts","sourceRoot":"","sources":["../../src/cli/mcp-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AASD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzD,SAAS,IAAI,cAAc,EAAE,CAAC;CAC/B;AAgrFD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC,CAI5D"}