@jacques-ai/server 0.0.7-alpha.1

package/dist/watchers/handoff-watcher.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Handoff Watcher Tests
+ *
+ * Tests the HandoffWatcher using actual file system directories.
+ * Creates temporary directories for testing that will exist.
+ */
+export {};
+//# sourceMappingURL=handoff-watcher.test.d.ts.map

package/dist/watchers/handoff-watcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-watcher.test.d.ts","sourceRoot":"","sources":["../../src/watchers/handoff-watcher.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/watchers/handoff-watcher.test.js

@@ -0,0 +1,142 @@
+/**
+ * Handoff Watcher Tests
+ *
+ * Tests the HandoffWatcher using actual file system directories.
+ * Creates temporary directories for testing that will exist.
+ */
+import { HandoffWatcher } from './handoff-watcher.js';
+import { createLogger } from '../logging/logger-factory.js';
+import { mkdtempSync, rmdirSync, writeFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+describe('HandoffWatcher', () => {
+    let watcher;
+    let broadcastedMessages;
+    let mockBroadcast;
+    let tempDirs = [];
+    // Helper to create a temporary directory that actually exists
+    function createTempDir() {
+        const dir = mkdtempSync(join(tmpdir(), 'jacques-test-'));
+        tempDirs.push(dir);
+        return dir;
+    }
+    beforeEach(() => {
+        broadcastedMessages = [];
+        mockBroadcast = (msg) => broadcastedMessages.push(msg);
+        watcher = new HandoffWatcher({
+            handoffFilename: '.jacques-handoff.md',
+            broadcast: mockBroadcast,
+            logger: createLogger({ silent: true }),
+        });
+        tempDirs = [];
+    });
+    afterEach(() => {
+        watcher.stopAll();
+        // Clean up temp directories
+        for (const dir of tempDirs) {
+            try {
+                rmdirSync(dir, { recursive: true });
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+    });
+    describe('startWatching', () => {
+        it('should track watched sessions by sessionId', () => {
+            const dir1 = createTempDir();
+            const dir2 = createTempDir();
+            // Start watching two sessions in different projects
+            watcher.startWatching('session-1', dir1);
+            watcher.startWatching('session-2', dir2);
+            expect(watcher.getWatcherCount()).toBe(2);
+            expect(watcher.isWatching('session-1')).toBe(true);
+            expect(watcher.isWatching('session-2')).toBe(true);
+        });
+        it('should not create duplicate watchers for the same session', () => {
+            const dir = createTempDir();
+            watcher.startWatching('session-1', dir);
+            watcher.startWatching('session-1', dir);
+            expect(watcher.getWatcherCount()).toBe(1);
+        });
+        it('should handle empty projectDir gracefully', () => {
+            watcher.startWatching('session-1', '');
+            expect(watcher.getWatcherCount()).toBe(0);
+            expect(watcher.isWatching('session-1')).toBe(false);
+        });
+        it('should broadcast handoff_ready if file already exists', () => {
+            const dir = createTempDir();
+            const handoffPath = join(dir, '.jacques-handoff.md');
+            writeFileSync(handoffPath, '# Test Handoff');
+            watcher.startWatching('session-1', dir);
+            // Should immediately broadcast since file exists
+            expect(broadcastedMessages.length).toBe(1);
+            const msg = broadcastedMessages[0];
+            expect(msg.type).toBe('handoff_ready');
+            expect(msg.session_id).toBe('session-1');
+            expect(msg.path).toBe(handoffPath);
+            unlinkSync(handoffPath);
+        });
+    });
+    describe('stopWatching', () => {
+        it('should stop watching a specific session', () => {
+            const dir1 = createTempDir();
+            const dir2 = createTempDir();
+            watcher.startWatching('session-1', dir1);
+            watcher.startWatching('session-2', dir2);
+            expect(watcher.getWatcherCount()).toBe(2);
+            watcher.stopWatching('session-1');
+            expect(watcher.getWatcherCount()).toBe(1);
+            expect(watcher.isWatching('session-1')).toBe(false);
+            expect(watcher.isWatching('session-2')).toBe(true);
+        });
+        it('should handle stopping a non-existent session', () => {
+            watcher.stopWatching('non-existent');
+            expect(watcher.getWatcherCount()).toBe(0);
+        });
+    });
+    describe('stopAll', () => {
+        it('should stop all watchers', () => {
+            const dir1 = createTempDir();
+            const dir2 = createTempDir();
+            const dir3 = createTempDir();
+            watcher.startWatching('session-1', dir1);
+            watcher.startWatching('session-2', dir2);
+            watcher.startWatching('session-3', dir3);
+            expect(watcher.getWatcherCount()).toBe(3);
+            watcher.stopAll();
+            expect(watcher.getWatcherCount()).toBe(0);
+        });
+    });
+    describe('getWatchedSessionIds', () => {
+        it('should return all watched session IDs', () => {
+            const dir1 = createTempDir();
+            const dir2 = createTempDir();
+            watcher.startWatching('session-a', dir1);
+            watcher.startWatching('session-b', dir2);
+            const ids = watcher.getWatchedSessionIds();
+            expect(ids).toContain('session-a');
+            expect(ids).toContain('session-b');
+            expect(ids.length).toBe(2);
+        });
+    });
+    describe('bug fix: multiple sessions in same project', () => {
+        it('should allow multiple sessions in the same project directory', () => {
+            // This was the bug: using projectDir as key caused collision
+            // when two sessions were in the same project
+            const projectDir = createTempDir();
+            watcher.startWatching('session-1', projectDir);
+            watcher.startWatching('session-2', projectDir);
+            // Both sessions should be tracked independently
+            expect(watcher.isWatching('session-1')).toBe(true);
+            expect(watcher.isWatching('session-2')).toBe(true);
+            expect(watcher.getWatcherCount()).toBe(2);
+            // Stopping one should not affect the other
+            watcher.stopWatching('session-1');
+            expect(watcher.isWatching('session-1')).toBe(false);
+            expect(watcher.isWatching('session-2')).toBe(true);
+            expect(watcher.getWatcherCount()).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=handoff-watcher.test.js.map

package/dist/watchers/handoff-watcher.test.js.map

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

package/dist/websocket.d.ts

@@ -0,0 +1,107 @@
+/**
+ * WebSocket Server
+ *
+ * Broadcasts session updates to connected dashboard clients.
+ * Listens on port 4242 by default.
+ */
+import { WebSocket } from 'ws';
+import type { Session, ServerMessage, ClientMessage, ApiLogMessage, CatalogUpdatedMessage } from './types.js';
+import type { ClaudeOperation } from '@jacques-ai/core';
+import type { Logger } from './logging/logger-factory.js';
+/**
+ * WebSocket Server configuration
+ */
+export interface WebSocketServerConfig {
+    port: number;
+    onClientMessage?: (ws: WebSocket, message: ClientMessage) => void;
+    /** Suppress console output */
+    silent?: boolean;
+    /** Optional logger for dependency injection */
+    logger?: Logger;
+}
+/**
+ * State provider interface
+ */
+export interface StateProvider {
+    getAllSessions: () => Session[];
+    getFocusedSessionId: () => string | null;
+    getFocusedSession: () => Session | null;
+    isScanning?: () => boolean;
+}
+/**
+ * WebSocket Server for dashboard clients
+ */
+export declare class JacquesWebSocketServer {
+    private wss;
+    private clients;
+    private port;
+    private onClientMessage?;
+    private stateProvider;
+    private logger;
+    private heartbeatInterval;
+    private aliveClients;
+    constructor(config: WebSocketServerConfig);
+    private get log();
+    private get error();
+    /**
+     * Set the state provider for initial state
+     */
+    setStateProvider(provider: StateProvider): void;
+    /**
+     * Start the WebSocket server
+     */
+    start(): Promise<void>;
+    /**
+     * Handle new client connection
+     */
+    private handleConnection;
+    /**
+     * Send message to a specific client
+     */
+    private sendToClient;
+    /**
+     * Broadcast message to all connected clients
+     */
+    broadcast(message: ServerMessage): void;
+    /**
+     * Broadcast session update
+     */
+    broadcastSessionUpdate(session: Session): void;
+    /**
+     * Broadcast session removed
+     */
+    broadcastSessionRemoved(sessionId: string): void;
+    /**
+     * Broadcast focus change
+     */
+    broadcastFocusChange(sessionId: string | null, session: Session | null): void;
+    /**
+     * Broadcast Claude operation (e.g., LLM handoff)
+     */
+    broadcastClaudeOperation(operation: ClaudeOperation): void;
+    /**
+     * Broadcast catalog update notification
+     */
+    broadcastCatalogUpdate(projectPath: string, action: CatalogUpdatedMessage['action'], itemId?: string): void;
+    /**
+     * Broadcast API log
+     */
+    broadcastApiLog(log: Omit<ApiLogMessage, 'type'>): void;
+    /**
+     * Start ping/pong heartbeat to detect dead connections
+     */
+    private startHeartbeat;
+    /**
+     * Get number of connected clients
+     */
+    getClientCount(): number;
+    /**
+     * Stop the WebSocket server
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if server is running
+     */
+    isRunning(): boolean;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,SAAS,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,aAAa,EAMb,aAAa,EACb,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAG1D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAClE,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,OAAO,EAAE,CAAC;IAChC,mBAAmB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACzC,iBAAiB,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,eAAe,CAAC,CAAkD;IAC1E,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,YAAY,CAA4B;gBAEpC,MAAM,EAAE,qBAAqB;IAQzC,OAAO,KAAK,GAAG,GAAgD;IAC/D,OAAO,KAAK,KAAK,GAAkD;IAEnE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI/C;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4CxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAgBvC;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQ9C;;OAEG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQhD;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAS7E;;OAEG;IACH,wBAAwB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IA2B1D;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAU3G;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,IAAI;IAQvD;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BrB;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB"}

package/dist/websocket.js

@@ -0,0 +1,268 @@
+/**
+ * WebSocket Server
+ *
+ * Broadcasts session updates to connected dashboard clients.
+ * Listens on port 4242 by default.
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+import { createLogger } from './logging/logger-factory.js';
+/**
+ * WebSocket Server for dashboard clients
+ */
+export class JacquesWebSocketServer {
+    wss = null;
+    clients = new Set();
+    port;
+    onClientMessage;
+    stateProvider = null;
+    logger;
+    heartbeatInterval = null;
+    aliveClients = new WeakSet();
+    constructor(config) {
+        this.port = config.port;
+        this.onClientMessage = config.onClientMessage;
+        // Support both old silent flag and new logger injection
+        this.logger = config.logger ?? createLogger({ silent: config.silent });
+    }
+    // Convenience accessors for logging (messages already include [WebSocket] prefix)
+    get log() { return this.logger.log.bind(this.logger); }
+    get error() { return this.logger.error.bind(this.logger); }
+    /**
+     * Set the state provider for initial state
+     */
+    setStateProvider(provider) {
+        this.stateProvider = provider;
+    }
+    /**
+     * Start the WebSocket server
+     */
+    start() {
+        return new Promise((resolve, reject) => {
+            try {
+                this.wss = new WebSocketServer({ port: this.port });
+                this.wss.on('connection', (ws) => {
+                    this.handleConnection(ws);
+                });
+                this.wss.on('error', (err) => {
+                    this.error(`[WebSocket] Server error: ${err.message}`);
+                    reject(err);
+                });
+                this.wss.on('listening', () => {
+                    this.log(`[WebSocket] Listening on port: ${this.port}`);
+                    this.startHeartbeat();
+                    resolve();
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    /**
+     * Handle new client connection
+     */
+    handleConnection(ws) {
+        this.log('[WebSocket] Client connected');
+        this.clients.add(ws);
+        this.aliveClients.add(ws);
+        ws.on('pong', () => {
+            this.aliveClients.add(ws);
+        });
+        // Send initial state
+        if (this.stateProvider) {
+            const initialState = {
+                type: 'initial_state',
+                sessions: this.stateProvider.getAllSessions(),
+                focused_session_id: this.stateProvider.getFocusedSessionId(),
+                scanning: this.stateProvider.isScanning?.() ?? false,
+            };
+            this.sendToClient(ws, initialState);
+        }
+        ws.on('message', (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                this.log(`[WebSocket] Received message: ${message.type}`);
+                if (this.onClientMessage) {
+                    this.onClientMessage(ws, message);
+                }
+            }
+            catch (err) {
+                this.error(`[WebSocket] Invalid message from client: ${err}`);
+            }
+        });
+        ws.on('close', () => {
+            this.log('[WebSocket] Client disconnected');
+            this.clients.delete(ws);
+        });
+        ws.on('error', (err) => {
+            this.error(`[WebSocket] Client error: ${err.message}`);
+            this.clients.delete(ws);
+        });
+    }
+    /**
+     * Send message to a specific client
+     */
+    sendToClient(ws, message) {
+        if (ws.readyState === WebSocket.OPEN) {
+            ws.send(JSON.stringify(message));
+        }
+    }
+    /**
+     * Broadcast message to all connected clients
+     */
+    broadcast(message) {
+        const data = JSON.stringify(message);
+        let sentCount = 0;
+        for (const client of this.clients) {
+            if (client.readyState === WebSocket.OPEN) {
+                client.send(data);
+                sentCount++;
+            }
+        }
+        if (sentCount > 0) {
+            this.log(`[WebSocket] Broadcast ${message.type} to ${sentCount} client(s)`);
+        }
+    }
+    /**
+     * Broadcast session update
+     */
+    broadcastSessionUpdate(session) {
+        const message = {
+            type: 'session_update',
+            session,
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Broadcast session removed
+     */
+    broadcastSessionRemoved(sessionId) {
+        const message = {
+            type: 'session_removed',
+            session_id: sessionId,
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Broadcast focus change
+     */
+    broadcastFocusChange(sessionId, session) {
+        const message = {
+            type: 'focus_changed',
+            session_id: sessionId,
+            session,
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Broadcast Claude operation (e.g., LLM handoff)
+     */
+    broadcastClaudeOperation(operation) {
+        const message = {
+            type: 'claude_operation',
+            operation: {
+                id: operation.id,
+                timestamp: operation.timestamp,
+                operation: operation.operation,
+                phase: operation.phase,
+                inputTokens: operation.inputTokens,
+                outputTokens: operation.outputTokens,
+                totalTokens: operation.totalTokens,
+                cacheReadTokens: operation.cacheReadTokens,
+                durationMs: operation.durationMs,
+                success: operation.success,
+                errorMessage: operation.errorMessage,
+                userPromptChars: operation.userPromptChars,
+                systemPromptChars: operation.systemPromptChars,
+                userPromptTokensEst: operation.userPromptTokensEst,
+                systemPromptTokensEst: operation.systemPromptTokensEst,
+                outputLength: operation.outputLength,
+                userPromptPreview: operation.userPromptPreview,
+                systemPromptPreview: operation.systemPromptPreview,
+            },
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Broadcast catalog update notification
+     */
+    broadcastCatalogUpdate(projectPath, action, itemId) {
+        const message = {
+            type: 'catalog_updated',
+            projectPath,
+            action,
+            itemId,
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Broadcast API log
+     */
+    broadcastApiLog(log) {
+        const message = {
+            type: 'api_log',
+            ...log,
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Start ping/pong heartbeat to detect dead connections
+     */
+    startHeartbeat() {
+        this.heartbeatInterval = setInterval(() => {
+            for (const client of this.clients) {
+                if (!this.aliveClients.has(client)) {
+                    this.log('[WebSocket] Terminating stale client');
+                    this.clients.delete(client);
+                    client.terminate();
+                    continue;
+                }
+                this.aliveClients.delete(client);
+                client.ping();
+            }
+        }, 30_000);
+    }
+    /**
+     * Get number of connected clients
+     */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /**
+     * Stop the WebSocket server
+     */
+    stop() {
+        return new Promise((resolve) => {
+            if (!this.wss) {
+                resolve();
+                return;
+            }
+            if (this.heartbeatInterval) {
+                clearInterval(this.heartbeatInterval);
+                this.heartbeatInterval = null;
+            }
+            // Close all client connections
+            for (const client of this.clients) {
+                try {
+                    client.close(1000, 'Server shutting down');
+                }
+                catch (err) {
+                    // Ignore errors during shutdown
+                }
+            }
+            this.clients.clear();
+            this.wss.close(() => {
+                this.log('[WebSocket] Server closed');
+                this.wss = null;
+                resolve();
+            });
+        });
+    }
+    /**
+     * Check if server is running
+     */
+    isRunning() {
+        return this.wss !== null;
+    }
+}
+//# sourceMappingURL=websocket.js.map

package/dist/websocket.js.map

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

package/dist/window-manager/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Window Manager Module
+ *
+ * Exports a factory function to create the appropriate window manager
+ * for the current platform.
+ */
+export type { WindowGeometry, Display, TileLayout, PositionResult, TileResult, WindowManager, TileSession, } from './types.js';
+export { calculateTileGeometry, suggestLayout, getLayoutCapacity, validateLayout, } from './layouts.js';
+export { getGridSpec, calculateSlotGeometry, calculateAllSlots, planSmartTileTransition, findFreeSpace, computeOverlapArea, } from './smart-layouts.js';
+export type { GridSpec, GridSlot, WindowReposition, SmartTileTransition, ExistingSlot, } from './smart-layouts.js';
+export { TileStateManager, validateTileStateWithBounds, validateTileStateBySessions, } from './tile-state.js';
+export type { TiledWindowSlot, TileState, } from './tile-state.js';
+import type { WindowManager } from './types.js';
+/**
+ * Create a window manager for the current platform
+ *
+ * @throws Error if the platform is not supported
+ */
+export declare function createWindowManager(): WindowManager;
+/**
+ * Check if window management is supported on the current platform
+ */
+export declare function isWindowManagementSupported(): boolean;
+/**
+ * Get platform-specific notes/warnings about window management
+ */
+export declare function getPlatformNotes(): string | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/window-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/window-manager/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,eAAe,EACf,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAWnD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAkBhD"}

package/dist/window-manager/index.js

@@ -0,0 +1,56 @@
+/**
+ * Window Manager Module
+ *
+ * Exports a factory function to create the appropriate window manager
+ * for the current platform.
+ */
+export { calculateTileGeometry, suggestLayout, getLayoutCapacity, validateLayout, } from './layouts.js';
+export { getGridSpec, calculateSlotGeometry, calculateAllSlots, planSmartTileTransition, findFreeSpace, computeOverlapArea, } from './smart-layouts.js';
+export { TileStateManager, validateTileStateWithBounds, validateTileStateBySessions, } from './tile-state.js';
+import { MacOSWindowManager } from './macos-manager.js';
+import { WindowsWindowManager } from './windows-manager.js';
+import { LinuxWindowManager } from './linux-manager.js';
+/**
+ * Create a window manager for the current platform
+ *
+ * @throws Error if the platform is not supported
+ */
+export function createWindowManager() {
+    switch (process.platform) {
+        case 'darwin':
+            return new MacOSWindowManager();
+        case 'win32':
+            return new WindowsWindowManager();
+        case 'linux':
+            return new LinuxWindowManager();
+        default:
+            throw new Error(`Unsupported platform: ${process.platform}`);
+    }
+}
+/**
+ * Check if window management is supported on the current platform
+ */
+export function isWindowManagementSupported() {
+    return ['darwin', 'win32', 'linux'].includes(process.platform);
+}
+/**
+ * Get platform-specific notes/warnings about window management
+ */
+export function getPlatformNotes() {
+    switch (process.platform) {
+        case 'darwin':
+            return null; // Full support
+        case 'win32':
+            return null; // Full support
+        case 'linux':
+            // Check for Wayland
+            if (process.env.XDG_SESSION_TYPE === 'wayland' ||
+                process.env.WAYLAND_DISPLAY !== undefined) {
+                return 'Window positioning is not supported on Wayland. Use your compositor\'s built-in tiling.';
+            }
+            return 'Requires wmctrl for X11. Install with: sudo apt install wmctrl';
+        default:
+            return `Platform ${process.platform} is not supported`;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/window-manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/window-manager/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAClC,KAAK,OAAO;YACV,OAAO,IAAI,oBAAoB,EAAE,CAAC;QACpC,KAAK,OAAO;YACV,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAClC;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,CAAC,eAAe;QAC9B,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,CAAC,eAAe;QAC9B,KAAK,OAAO;YACV,oBAAoB;YACpB,IACE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,SAAS;gBAC1C,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,SAAS,EACzC,CAAC;gBACD,OAAO,yFAAyF,CAAC;YACnG,CAAC;YACD,OAAO,gEAAgE,CAAC;QAC1E;YACE,OAAO,YAAY,OAAO,CAAC,QAAQ,mBAAmB,CAAC;IAC3D,CAAC;AACH,CAAC"}