Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { describe, it, expect, vi, beforeEach } from 'vitest';
import { createServer } from 'node:http';
import { once } from 'node:events';
import { Server } from 'socket.io';
import { io as connect } from 'socket.io-client';
const createShellSession = vi.fn(() => 'sess-1');
const resizeSession = vi.fn(() => true);
vi.mock('../services/shell.js', () => ({
createShellSession,
resizeSession,
submitToSession: vi.fn(),
attachSession: vi.fn(),
detachSocketSessions: vi.fn()
}));
vi.mock('../services/providers.js', () => ({ getProviderById: vi.fn() }));
const { registerShellHandlers } = await import('./shell.js');
const setup = () => {
const handlers = {};
const socket = { on: (event, fn) => { handlers[event] = fn; }, emit: vi.fn() };
registerShellHandlers(socket, {});
return { handlers, socket };
};
describe('shell:start payload validation', () => {
beforeEach(() => createShellSession.mockClear());
it('rejects a non-string cwd on shell:error without creating a session', async () => {
const { handlers, socket } = setup();
await handlers['shell:start']({ cwd: { not: 'a string' } });
expect(createShellSession).not.toHaveBeenCalled();
expect(socket.emit).toHaveBeenCalledWith('shell:error', expect.objectContaining({ code: 'VALIDATION_ERROR' }));
});
it('still starts a session for an absent payload', async () => {
const { handlers, socket } = setup();
await handlers['shell:start'](undefined);
expect(createShellSession).toHaveBeenCalledTimes(1);
expect(socket.emit).toHaveBeenCalledWith('shell:started', { sessionId: 'sess-1' });
});
it('starts the default shell across Socket.IO when the client emits undefined options', async () => {
const http = createServer();
const server = new Server(http);
server.on('connection', registerShellHandlers);
let client;
try {
http.listen(0, '127.0.0.1');
await once(http, 'listening');
client = connect(`http://127.0.0.1:${http.address().port}`, {
transports: ['websocket'], reconnection: false
});
await once(client, 'connect');
const started = once(client, 'shell:started', { signal: AbortSignal.timeout(2000) });
// This is the Shell page's empty-options emit: the wire turns undefined into null.
client.emit('shell:start', undefined);
expect(await started).toEqual([{ sessionId: 'sess-1' }]);
expect(createShellSession).toHaveBeenCalledTimes(1);
} finally {
client?.disconnect();
await new Promise(resolve => server.close(resolve));
}
});
});
describe('shell:resize handler', () => {
beforeEach(() => resizeSession.mockClear());
it('resizes session when resizeSession succeeds', () => {
resizeSession.mockReturnValueOnce(true);
const { handlers, socket } = setup();
handlers['shell:resize']({ sessionId: 'sess-1', cols: 100, rows: 30 });
expect(resizeSession).toHaveBeenCalledWith('sess-1', 100, 30);
expect(socket.emit).not.toHaveBeenCalledWith('shell:error', expect.anything());
});
it('emits shell:error when resizeSession returns false', () => {
resizeSession.mockReturnValueOnce(false);
const { handlers, socket } = setup();
handlers['shell:resize']({ sessionId: 'sess-1', cols: 100, rows: 30 });
expect(resizeSession).toHaveBeenCalledWith('sess-1', 100, 30);
expect(socket.emit).toHaveBeenCalledWith('shell:error', {
sessionId: 'sess-1',
error: 'Session not found or resize failed'
});
});
});