Skip to content

fix: change SDK default WebSocket URL to production endpoint #3103

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sebuh-infsol wants to merge 1 commit into
base: dev
Choose a base branch
from
+3 −3
Open

fix: change SDK default WebSocket URL to production endpoint #3103

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion cloud/docs/api-reference/websocket/app-connection.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ wss://api.mentra.glass/app-ws
wss://devapi.mentra.glass/app-ws
```

```bash Local
```bash Local Development
ws://localhost:8002/app-ws
```
</CodeGroup>
Expand Down
2 changes: 1 addition & 1 deletion cloud/packages/sdk/src/app/session/index.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -256,7 +256,7 @@ export class AppSession {
constructor(private config: AppSessionConfig) {
// Set defaults and merge with provided config
this.config = {
mentraOSWebsocketUrl: `ws://localhost:8002/app-ws`, // Use localhost as default
mentraOSWebsocketUrl: `wss://api.mentra.glass/app-ws`, // Production WebSocket URL
autoReconnect: true, // Enable auto-reconnection by default for better reliability
maxReconnectAttempts: 3, // Default to 3 reconnection attempts for better resilience
reconnectDelay: 1000, // Start with 1 second delay (uses exponential backoff)
Expand Down
2 changes: 1 addition & 1 deletion docs/app-devs/reference/app-session.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -285,7 +285,7 @@ interface AppSessionConfig {
/** Your API key for authentication. */
apiKey: string;

/** The WebSocket URL provided by MentraOS Cloud. Defaults to 'ws://localhost:8002/app-ws'. */
/** The WebSocket URL provided by MentraOS Cloud. Defaults to 'wss://api.mentra.glass/app-ws.

@cubic-dev-ai cubic-dev-ai Bot Jun 7, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: JSDoc comment for mentraOSWebsocketUrl is missing closing quote and */, breaking the TypeScript interface example syntax

Prompt for AI agents 
Check if this issue is valid — if so, understand the root cause and fix it. At docs/app-devs/reference/app-session.mdx, line 288:

<comment>JSDoc comment for `mentraOSWebsocketUrl` is missing closing quote and `*/`, breaking the TypeScript interface example syntax</comment>

<file context>
@@ -285,7 +285,7 @@ interface AppSessionConfig {
   apiKey: string;
 
-  /** The WebSocket URL provided by MentraOS Cloud. Defaults to 'ws://localhost:8002/app-ws'. */
+  /** The WebSocket URL provided by MentraOS Cloud. Defaults to 'wss://api.mentra.glass/app-ws.
   mentraOSWebsocketUrl?: string;
 
</file context>
Suggested change
/** The WebSocket URL provided by MentraOS Cloud. Defaults to 'wss://api.mentra.glass/app-ws.
+ /** The WebSocket URL provided by MentraOS Cloud. Defaults to 'wss://api.mentra.glass/app-ws'. */

mentraOSWebsocketUrl?: string;

/** Whether the session should automatically attempt to reconnect if the connection drops. Defaults to `false`. */
Expand Down