mstro-app 0.1.47

package/dist/server/routes/instances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instances.js","sourceRoot":"","sources":["../../../server/routes/instances.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,gEAAgE;AAEhE;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3D,MAAM,UAAU,oBAAoB,CAAC,gBAAkC;IACrE,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAA;IAEzB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,eAAe,EAAE,CAAA;YACpD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAA;QACzD,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,gBAAgB,CAAC,kBAAkB,EAAE,CAAA;YACtD,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,QAAQ;gBACR,QAAQ,EAAE,WAAW,EAAE;aACxB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAA;QACzD,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,gBAAkC;IACpE,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAA;IAEzB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACrB,UAAU,CAAC,GAAG,EAAE;YACd,gBAAgB,CAAC,UAAU,EAAE,CAAA;YAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC,EAAE,GAAG,CAAC,CAAA;QAEP,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/server/routes/notifications.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+export declare function createNotificationRoutes(workingDir: string): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/server/routes/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../server/routes/notifications.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,8EA4B1D"}

package/dist/server/routes/notifications.js

@@ -0,0 +1,136 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/**
+ * Notification Routes
+ *
+ * Handles notification-related operations including AI-powered summary generation.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { Hono } from 'hono';
+export function createNotificationRoutes(workingDir) {
+    const routes = new Hono();
+    /**
+     * Generate a summary for browser notification using Claude Haiku
+     * POST /summarize
+     * Body: { prompt: string, output: string }
+     * Returns: { summary: string }
+     */
+    routes.post('/summarize', async (c) => {
+        try {
+            const body = await c.req.json();
+            const { prompt, output } = body;
+            if (!prompt || !output) {
+                return c.json({ error: 'Missing required fields: prompt and output' }, 400);
+            }
+            const summary = await generateNotificationSummary(prompt, output, workingDir);
+            return c.json({ summary });
+        }
+        catch (error) {
+            console.error('[Notifications] Error generating summary:', error);
+            // Return a fallback summary on error
+            return c.json({ summary: 'Task completed' });
+        }
+    });
+    return routes;
+}
+/**
+ * Generate a notification summary using Claude Haiku
+ */
+async function generateNotificationSummary(userPrompt, output, workingDir) {
+    return new Promise((resolve) => {
+        // Create temp directory if it doesn't exist
+        const tempDir = join(workingDir, '.mstro', 'tmp');
+        if (!existsSync(tempDir)) {
+            mkdirSync(tempDir, { recursive: true });
+        }
+        // Truncate output if too long (keep first and last parts for context)
+        let truncatedOutput = output;
+        if (output.length > 4000) {
+            const firstPart = output.slice(0, 2000);
+            const lastPart = output.slice(-1500);
+            truncatedOutput = `${firstPart}\n\n... [output truncated] ...\n\n${lastPart}`;
+        }
+        // Build the prompt for summary generation
+        const summaryPrompt = `You are generating a SHORT browser notification summary for a completed task.
+The user ran a task and wants a brief notification to remind them what happened.
+
+USER'S ORIGINAL PROMPT:
+"${userPrompt}"
+
+TASK OUTPUT (may be truncated):
+${truncatedOutput}
+
+Generate a notification summary following these rules:
+1. Maximum 100 characters (this is a browser notification)
+2. Focus on the OUTCOME, not the process
+3. Be specific about what was accomplished
+4. Use past tense (e.g., "Fixed bug in auth.ts", "Added 3 new tests")
+5. If there was an error, mention it briefly
+6. No emojis, no markdown, just plain text
+
+Respond with ONLY the summary text, nothing else.`;
+        // Write prompt to temp file
+        const promptFile = join(tempDir, `notif-summary-${Date.now()}.txt`);
+        writeFileSync(promptFile, summaryPrompt);
+        const systemPrompt = 'You are a notification summary assistant. Respond with only the summary text, no preamble or explanation.';
+        const args = [
+            '--print',
+            '--model', 'haiku',
+            '--system-prompt', systemPrompt,
+            promptFile
+        ];
+        const claude = spawn('claude', args, {
+            cwd: workingDir,
+            stdio: ['ignore', 'pipe', 'pipe']
+        });
+        let stdout = '';
+        let stderr = '';
+        claude.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        claude.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        claude.on('close', (code) => {
+            // Clean up temp file
+            try {
+                unlinkSync(promptFile);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            if (code === 0 && stdout.trim()) {
+                // Truncate if somehow still too long
+                const summary = stdout.trim().slice(0, 150);
+                resolve(summary);
+            }
+            else {
+                console.error('[Notifications] Claude error:', stderr || 'Unknown error');
+                // Fallback to basic summary
+                resolve(createFallbackSummary(userPrompt));
+            }
+        });
+        claude.on('error', (err) => {
+            console.error('[Notifications] Failed to spawn Claude:', err);
+            resolve(createFallbackSummary(userPrompt));
+        });
+        // Timeout after 10 seconds
+        setTimeout(() => {
+            claude.kill();
+            resolve(createFallbackSummary(userPrompt));
+        }, 10000);
+    });
+}
+/**
+ * Create a fallback summary when AI summarization fails
+ */
+function createFallbackSummary(userPrompt) {
+    const truncated = userPrompt.slice(0, 60);
+    if (userPrompt.length > 60) {
+        return `Completed: "${truncated}..."`;
+    }
+    return `Completed: "${truncated}"`;
+}
+//# sourceMappingURL=notifications.js.map

package/dist/server/routes/notifications.js.map

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

package/dist/server/services/analytics.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Initialize PostHog client
+ * Call this once at server startup
+ */
+export declare function initAnalytics(): Promise<void>;
+/**
+ * Shutdown PostHog client gracefully
+ * Call this before process exit
+ */
+export declare function shutdownAnalytics(): Promise<void>;
+/**
+ * Track a custom event
+ */
+export declare function trackEvent(event: string, properties?: Record<string, any>): void;
+/**
+ * Identify a user (call after login)
+ */
+export declare function identifyUser(userId: string, properties?: Record<string, any>): void;
+/**
+ * Set telemetry preference in config file
+ */
+export declare function setTelemetryEnabled(enabled: boolean): void;
+/**
+ * Get current telemetry status
+ */
+export declare function getTelemetryStatus(): {
+    enabled: boolean;
+    reason: string;
+};
+export declare const AnalyticsEvents: {
+    readonly CLI_STARTED: "cli_started";
+    readonly CLI_COMMAND: "cli_command";
+    readonly CLI_LOGIN: "cli_login";
+    readonly CLI_LOGOUT: "cli_logout";
+    readonly CLI_ERROR: "cli_error";
+    readonly SERVER_STARTED: "server_started";
+    readonly SERVER_STOPPED: "server_stopped";
+    readonly PLATFORM_CONNECTED: "platform_connected";
+    readonly PLATFORM_DISCONNECTED: "platform_disconnected";
+    readonly WEB_CLIENT_CONNECTED: "web_client_connected";
+    readonly WEB_CLIENT_DISCONNECTED: "web_client_disconnected";
+    readonly IMPROVISE_SESSION_STARTED: "improvise_session_started";
+    readonly IMPROVISE_PROMPT_RECEIVED: "improvise_prompt_received";
+    readonly IMPROVISE_MOVEMENT_STARTED: "improvise_movement_started";
+    readonly IMPROVISE_MOVEMENT_COMPLETED: "improvise_movement_completed";
+    readonly IMPROVISE_MOVEMENT_ERROR: "improvise_movement_error";
+    readonly IMPROVISE_SESSION_ENDED: "improvise_session_ended";
+    readonly IMPROVISE_ABORTED: "improvise_aborted";
+    readonly TERMINAL_SESSION_CREATED: "terminal_session_created";
+    readonly TERMINAL_SESSION_CLOSED: "terminal_session_closed";
+    readonly BOUNCER_TOOL_ALLOWED: "bouncer_tool_allowed";
+    readonly BOUNCER_TOOL_DENIED: "bouncer_tool_denied";
+    readonly BOUNCER_HAIKU_REVIEW: "bouncer_haiku_review";
+};
+export type AnalyticsEvent = typeof AnalyticsEvents[keyof typeof AnalyticsEvents];
+//# sourceMappingURL=analytics.d.ts.map

package/dist/server/services/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../server/services/analytics.ts"],"names":[],"mappings":"AA6FA;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBnD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD;AAuBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAWhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAgBnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgB1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAsBzE;AAMD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;CAmClB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA"}

package/dist/server/services/analytics.js

@@ -0,0 +1,240 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/**
+ * PostHog Analytics Service for mstro CLI
+ *
+ * Provides analytics tracking for the mstro client.
+ * Uses PostHog Node SDK for server-side event tracking.
+ *
+ * Config is fetched from platform server (not hardcoded) so the
+ * PostHog key isn't exposed in the npm package.
+ *
+ * Telemetry is opt-out by default. Users can disable with:
+ * - Command: mstro telemetry off
+ * - Environment variable: MSTRO_TELEMETRY=0
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { arch, homedir, platform } from 'node:os';
+import { join } from 'node:path';
+import { PostHog } from 'posthog-node';
+import { getClientId } from './client-id.js';
+const MSTRO_DIR = join(homedir(), '.mstro');
+const CONFIG_FILE = join(MSTRO_DIR, 'config.json');
+const PLATFORM_URL = process.env.PLATFORM_URL || 'https://api.mstro.app';
+let client = null;
+let telemetryEnabled = null;
+let analyticsConfig = null;
+/**
+ * Check if telemetry is enabled
+ */
+function isTelemetryEnabled() {
+    if (telemetryEnabled !== null) {
+        return telemetryEnabled;
+    }
+    // Check environment variable first
+    const envValue = process.env.MSTRO_TELEMETRY;
+    if (envValue === '0' || envValue === 'false') {
+        telemetryEnabled = false;
+        return false;
+    }
+    // Check config file
+    if (existsSync(CONFIG_FILE)) {
+        try {
+            const config = JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+            if (config.telemetry === false) {
+                telemetryEnabled = false;
+                return false;
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    telemetryEnabled = true;
+    return true;
+}
+/**
+ * Fetch analytics config from platform server
+ * This keeps the PostHog key out of the npm package
+ */
+async function fetchAnalyticsConfig() {
+    try {
+        const response = await fetch(`${PLATFORM_URL}/api/config/client`, {
+            method: 'GET',
+            headers: { 'Content-Type': 'application/json' },
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        return {
+            posthogKey: data.analytics?.posthogKey || '',
+            posthogHost: data.analytics?.posthogHost || 'https://eu.i.posthog.com',
+        };
+    }
+    catch {
+        // Network error, platform unavailable - silently disable analytics
+        return null;
+    }
+}
+/**
+ * Initialize PostHog client
+ * Call this once at server startup
+ */
+export async function initAnalytics() {
+    if (!isTelemetryEnabled()) {
+        return;
+    }
+    // Fetch config from platform
+    analyticsConfig = await fetchAnalyticsConfig();
+    if (!analyticsConfig?.posthogKey) {
+        // No key configured on platform, analytics disabled
+        return;
+    }
+    client = new PostHog(analyticsConfig.posthogKey, {
+        host: analyticsConfig.posthogHost,
+        // Flush events every 10 seconds or 20 events
+        flushAt: 20,
+        flushInterval: 10000,
+    });
+}
+/**
+ * Shutdown PostHog client gracefully
+ * Call this before process exit
+ */
+export async function shutdownAnalytics() {
+    if (client) {
+        await client.shutdown();
+        client = null;
+    }
+}
+/**
+ * Get the distinct ID for this client
+ * Uses the persistent client ID from ~/.mstro/client-id
+ */
+function getDistinctId() {
+    return getClientId();
+}
+/**
+ * Get common properties included with all events
+ */
+function getCommonProperties() {
+    return {
+        os: platform(),
+        arch: arch(),
+        node_version: process.version,
+        mstro_version: process.env.npm_package_version || 'unknown',
+        source: 'client',
+    };
+}
+/**
+ * Track a custom event
+ */
+export function trackEvent(event, properties) {
+    if (!client || !isTelemetryEnabled())
+        return;
+    client.capture({
+        distinctId: getDistinctId(),
+        event,
+        properties: {
+            ...getCommonProperties(),
+            ...properties,
+        },
+    });
+}
+/**
+ * Identify a user (call after login)
+ */
+export function identifyUser(userId, properties) {
+    if (!client || !isTelemetryEnabled())
+        return;
+    // Link the client ID to the user ID
+    client.alias({
+        distinctId: userId,
+        alias: getDistinctId(),
+    });
+    client.identify({
+        distinctId: userId,
+        properties: {
+            ...getCommonProperties(),
+            ...properties,
+        },
+    });
+}
+/**
+ * Set telemetry preference in config file
+ */
+export function setTelemetryEnabled(enabled) {
+    let config = {};
+    if (existsSync(CONFIG_FILE)) {
+        try {
+            config = JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+        }
+        catch {
+            // Start fresh if parse fails
+        }
+    }
+    config.telemetry = enabled;
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+    // Update cached value
+    telemetryEnabled = enabled;
+}
+/**
+ * Get current telemetry status
+ */
+export function getTelemetryStatus() {
+    const envValue = process.env.MSTRO_TELEMETRY;
+    if (envValue === '0' || envValue === 'false') {
+        return { enabled: false, reason: 'Disabled via MSTRO_TELEMETRY environment variable' };
+    }
+    if (existsSync(CONFIG_FILE)) {
+        try {
+            const config = JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+            if (config.telemetry === false) {
+                return { enabled: false, reason: 'Disabled via ~/.mstro/config.json' };
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    if (!analyticsConfig?.posthogKey) {
+        return { enabled: false, reason: 'Analytics not configured on platform' };
+    }
+    return { enabled: true, reason: 'Enabled (opt-out with MSTRO_TELEMETRY=0)' };
+}
+// ===========================================
+// Event Constants - Use these for consistency
+// ===========================================
+export const AnalyticsEvents = {
+    // CLI events
+    CLI_STARTED: 'cli_started',
+    CLI_COMMAND: 'cli_command',
+    CLI_LOGIN: 'cli_login',
+    CLI_LOGOUT: 'cli_logout',
+    CLI_ERROR: 'cli_error',
+    // Server events
+    SERVER_STARTED: 'server_started',
+    SERVER_STOPPED: 'server_stopped',
+    // Connection events
+    PLATFORM_CONNECTED: 'platform_connected',
+    PLATFORM_DISCONNECTED: 'platform_disconnected',
+    WEB_CLIENT_CONNECTED: 'web_client_connected',
+    WEB_CLIENT_DISCONNECTED: 'web_client_disconnected',
+    // Improvise events
+    IMPROVISE_SESSION_STARTED: 'improvise_session_started',
+    IMPROVISE_PROMPT_RECEIVED: 'improvise_prompt_received',
+    IMPROVISE_MOVEMENT_STARTED: 'improvise_movement_started',
+    IMPROVISE_MOVEMENT_COMPLETED: 'improvise_movement_completed',
+    IMPROVISE_MOVEMENT_ERROR: 'improvise_movement_error',
+    IMPROVISE_SESSION_ENDED: 'improvise_session_ended',
+    IMPROVISE_ABORTED: 'improvise_aborted',
+    // Terminal events
+    TERMINAL_SESSION_CREATED: 'terminal_session_created',
+    TERMINAL_SESSION_CLOSED: 'terminal_session_closed',
+    // MCP/Bouncer events
+    BOUNCER_TOOL_ALLOWED: 'bouncer_tool_allowed',
+    BOUNCER_TOOL_DENIED: 'bouncer_tool_denied',
+    BOUNCER_HAIKU_REVIEW: 'bouncer_haiku_review',
+};
+//# sourceMappingURL=analytics.js.map

package/dist/server/services/analytics.js.map

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

package/dist/server/services/auth.d.ts

@@ -0,0 +1,26 @@
+export declare class AuthService {
+    private localToken;
+    constructor();
+    /**
+     * Load existing session token from disk, or create one if missing.
+     * This ensures all mstro instances on the same machine share the same token.
+     */
+    private loadOrCreateToken;
+    /**
+     * Write session token to ~/.mstro/session-token
+     */
+    private writeToken;
+    /**
+     * Validate the local session token (used for localhost API/WS auth)
+     */
+    validateLocalToken(token: string): boolean;
+    /**
+     * Get the local session token (for passing to child processes)
+     */
+    getLocalToken(): string;
+    /**
+     * Read the local session token from disk (static utility for clients)
+     */
+    static readLocalToken(): string | null;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/server/services/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../server/services/auth.ts"],"names":[],"mappings":"AAkBA,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAQ;;IAM1B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM,GAAG,IAAI;CAWvC"}

package/dist/server/services/auth.js

@@ -0,0 +1,71 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/**
+ * Authentication Service
+ *
+ * Manages local session token for localhost API/WebSocket auth.
+ * All mstro instances on a machine share a single token from ~/.mstro/session-token.
+ * The token is created once (by `mstro login` or first server start) and reused.
+ */
+import { randomBytes } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const SESSION_TOKEN_PATH = join(homedir(), '.mstro', 'session-token');
+export class AuthService {
+    localToken;
+    constructor() {
+        this.localToken = this.loadOrCreateToken();
+    }
+    /**
+     * Load existing session token from disk, or create one if missing.
+     * This ensures all mstro instances on the same machine share the same token.
+     */
+    loadOrCreateToken() {
+        const existing = AuthService.readLocalToken();
+        if (existing) {
+            return existing;
+        }
+        const token = randomBytes(32).toString('hex');
+        this.writeToken(token);
+        return token;
+    }
+    /**
+     * Write session token to ~/.mstro/session-token
+     */
+    writeToken(token) {
+        const dir = join(homedir(), '.mstro');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true, mode: 0o700 });
+        }
+        writeFileSync(SESSION_TOKEN_PATH, token, { mode: 0o600 });
+    }
+    /**
+     * Validate the local session token (used for localhost API/WS auth)
+     */
+    validateLocalToken(token) {
+        return token === this.localToken;
+    }
+    /**
+     * Get the local session token (for passing to child processes)
+     */
+    getLocalToken() {
+        return this.localToken;
+    }
+    /**
+     * Read the local session token from disk (static utility for clients)
+     */
+    static readLocalToken() {
+        try {
+            if (existsSync(SESSION_TOKEN_PATH)) {
+                const token = readFileSync(SESSION_TOKEN_PATH, 'utf-8').trim();
+                if (token.length > 0) {
+                    return token;
+                }
+            }
+        }
+        catch { }
+        return null;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/server/services/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../server/services/auth.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,gEAAgE;AAEhE;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAA;AAErE,MAAM,OAAO,WAAW;IACd,UAAU,CAAQ;IAE1B;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;IAC5C,CAAC;IAED;;;OAGG;IACK,iBAAiB;QACvB,MAAM,QAAQ,GAAG,WAAW,CAAC,cAAc,EAAE,CAAA;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC7C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QACtB,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,KAAa;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAA;QACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAClD,CAAC;QACD,aAAa,CAAC,kBAAkB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC3D,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,KAAa;QAC9B,OAAO,KAAK,KAAK,IAAI,CAAC,UAAU,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc;QACnB,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACnC,MAAM,KAAK,GAAG,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;gBAC9D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,OAAO,KAAK,CAAA;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/server/services/client-id.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get the persistent client ID, creating one if it doesn't exist.
+ * This ID is unique to this machine's ~/.mstro directory.
+ */
+export declare function getClientId(): string;
+/**
+ * Get the client ID file path (for debugging/display)
+ */
+export declare function getClientIdPath(): string;
+//# sourceMappingURL=client-id.d.ts.map

package/dist/server/services/client-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-id.d.ts","sourceRoot":"","sources":["../../../server/services/client-id.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAsBpC;AAUD;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/server/services/client-id.js

@@ -0,0 +1,61 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/**
+ * Client ID Service
+ *
+ * Generates and persists a unique client identifier that survives server restarts.
+ * This ID is used to distinguish between different user home directories on different machines.
+ *
+ * Storage: ~/.mstro/client-id
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const MSTRO_DIR = join(homedir(), '.mstro');
+const CLIENT_ID_FILE = join(MSTRO_DIR, 'client-id');
+/**
+ * Generate a new UUID v4
+ */
+function generateUUID() {
+    return crypto.randomUUID();
+}
+/**
+ * Get the persistent client ID, creating one if it doesn't exist.
+ * This ID is unique to this machine's ~/.mstro directory.
+ */
+export function getClientId() {
+    // Ensure ~/.mstro directory exists
+    if (!existsSync(MSTRO_DIR)) {
+        mkdirSync(MSTRO_DIR, { recursive: true, mode: 0o700 });
+    }
+    // Try to read existing client ID
+    if (existsSync(CLIENT_ID_FILE)) {
+        try {
+            const id = readFileSync(CLIENT_ID_FILE, 'utf-8').trim();
+            if (id && isValidUUID(id)) {
+                return id;
+            }
+        }
+        catch {
+            // File exists but couldn't be read, generate new one
+        }
+    }
+    // Generate and persist a new client ID
+    const newId = generateUUID();
+    writeFileSync(CLIENT_ID_FILE, newId, 'utf-8');
+    return newId;
+}
+/**
+ * Validate UUID format
+ */
+function isValidUUID(id) {
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(id);
+}
+/**
+ * Get the client ID file path (for debugging/display)
+ */
+export function getClientIdPath() {
+    return CLIENT_ID_FILE;
+}
+//# sourceMappingURL=client-id.js.map

package/dist/server/services/client-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-id.js","sourceRoot":"","sources":["../../../server/services/client-id.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,gEAAgE;AAEhE;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAA;AAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;AAEnD;;GAEG;AACH,SAAS,YAAY;IACnB,OAAO,MAAM,CAAC,UAAU,EAAE,CAAA;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,mCAAmC;IACnC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACxD,CAAC;IAED,iCAAiC;IACjC,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;YACvD,IAAI,EAAE,IAAI,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAA;IAC5B,aAAa,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IAC7C,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,EAAU;IAC7B,MAAM,SAAS,GAAG,wEAAwE,CAAA;IAC1F,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,CAAA;AACvB,CAAC"}