ssh-agent-workspace 1.0.0

package/dist/tools/backup.d.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { SessionManager } from '../core/SessionManager.js';
+import { SSHManager } from '../core/SSHManager.js';
+export declare const backupSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    paths: z.ZodArray<z.ZodString, "many">;
+    local_dest: z.ZodString;
+    exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    remove_remote_archive: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    session_id: string;
+    paths: string[];
+    local_dest: string;
+    exclude: string[];
+    remove_remote_archive: boolean;
+}, {
+    session_id: string;
+    paths: string[];
+    local_dest: string;
+    exclude?: string[] | undefined;
+    remove_remote_archive?: boolean | undefined;
+}>;
+export declare const backupTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            session_id: {
+                type: string;
+                description: string;
+            };
+            paths: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            local_dest: {
+                type: string;
+                description: string;
+            };
+            exclude: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+                default: never[];
+            };
+            remove_remote_archive: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleBackup(args: unknown, sessionManager: SessionManager, sshManager: SSHManager): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/tools/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/tools/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;EAMvB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBtB,CAAC;AAMF,wBAAsB,YAAY,CAChC,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,UAAU;;;;;;;;;;;;GA6HvB"}

package/dist/tools/backup.js

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+import fs from 'fs';
+import path from 'path';
+import { isReadOnlyMode } from '../utils/security.js';
+import { logger } from '../utils/logger.js';
+export const backupSchema = z.object({
+    session_id: z.string().min(1),
+    paths: z.array(z.string().min(1)).min(1).max(100).describe('Absolute remote paths (files or directories) to include in the backup archive'),
+    local_dest: z.string().min(1).describe('Absolute local path where the backup archive will be saved (must end with .tar.gz)'),
+    exclude: z.array(z.string()).max(20).default([]).describe('Glob patterns to exclude (e.g. "*.log", "node_modules")'),
+    remove_remote_archive: z.boolean().default(true).describe('Delete the temporary archive from the remote host after download'),
+});
+export const backupTool = {
+    name: 'backup',
+    description: 'Create a compressed tar.gz backup of remote paths and download it locally. Steps: validate paths -> create remote archive -> download -> cleanup.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            session_id: { type: 'string', description: 'Session ID returned by connect' },
+            paths: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Absolute remote paths (files/directories) to backup',
+            },
+            local_dest: { type: 'string', description: 'Absolute local path to save the .tar.gz archive' },
+            exclude: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Glob patterns to exclude (e.g. "*.log", "node_modules")',
+                default: [],
+            },
+            remove_remote_archive: { type: 'boolean', description: 'Delete remote temp archive after download (default: true)', default: true },
+        },
+        required: ['session_id', 'paths', 'local_dest'],
+    },
+};
+function q(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+export async function handleBackup(args, sessionManager, sshManager) {
+    const parsed = backupSchema.safeParse(args);
+    if (!parsed.success) {
+        return { content: [{ type: 'text', text: `Invalid arguments: ${parsed.error.message}` }], isError: true };
+    }
+    const { session_id, paths, local_dest, exclude, remove_remote_archive } = parsed.data;
+    const session = sessionManager.get(session_id);
+    if (!session) {
+        return { content: [{ type: 'text', text: `Error: Session '${session_id}' not found` }], isError: true };
+    }
+    if (!sshManager.isAlive(session.ssh)) {
+        return { content: [{ type: 'text', text: `Error: SSH connection dead for session '${session_id}'` }], isError: true };
+    }
+    if (isReadOnlyMode(session.host)) {
+        return { content: [{ type: 'text', text: `Error: Host '${session.host}' is in read-only mode. Backup is disabled.` }], isError: true };
+    }
+    if (!local_dest.endsWith('.tar.gz')) {
+        return {
+            content: [{ type: 'text', text: 'Error: local_dest must end with .tar.gz' }],
+            isError: true,
+        };
+    }
+    for (const p of paths) {
+        if (p.startsWith('-') || p.includes(';') || p.includes('&&') || p.includes('|')) {
+            return {
+                content: [{ type: 'text', text: `Error: Invalid characters in path: ${p}` }],
+                isError: true,
+            };
+        }
+    }
+    const resolvedLocal = path.resolve(local_dest);
+    const localDir = path.dirname(resolvedLocal);
+    if (!fs.existsSync(localDir)) {
+        fs.mkdirSync(localDir, { recursive: true });
+    }
+    if (fs.existsSync(resolvedLocal)) {
+        return {
+            content: [{ type: 'text', text: `Error: Local file already exists: ${resolvedLocal}` }],
+            isError: true,
+        };
+    }
+    const verifyScript = paths.map((p) => `test -e ${q(p)} || echo "MISSING:${p}"`).join('; ');
+    const verifyResult = await sshManager.exec(session.ssh, verifyScript, 10000);
+    if (verifyResult.stdout.includes('MISSING:')) {
+        const missing = verifyResult.stdout
+            .split('\n')
+            .filter((l) => l.startsWith('MISSING:'))
+            .map((l) => l.replace('MISSING:', ''))
+            .join(', ');
+        return {
+            content: [{ type: 'text', text: `Error: Remote paths not found: ${missing}` }],
+            isError: true,
+        };
+    }
+    const timestamp = Date.now();
+    const archiveName = `mcp_backup_${timestamp}.tar.gz`;
+    const remoteArchive = `/tmp/${archiveName}`;
+    const excludeArgs = exclude.map((e) => `--exclude=${q(e)}`).join(' ');
+    const pathArgs = paths.map((p) => q(p)).join(' ');
+    const tarCmd = `tar czf ${q(remoteArchive)} ${excludeArgs} ${pathArgs} 2>&1`;
+    const tarResult = await sshManager.exec(session.ssh, tarCmd, 120000);
+    if (tarResult.code !== 0) {
+        const error = tarResult.stderr || tarResult.stdout || 'unknown error';
+        logger.error({ sessionId: session_id, paths, error }, 'Tar backup failed');
+        return {
+            content: [{ type: 'text', text: `Error: Failed to create remote archive: ${error}` }],
+            isError: true,
+        };
+    }
+    const statResult = await sshManager.exec(session.ssh, `stat -c%s ${q(remoteArchive)} 2>/dev/null || wc -c < ${q(remoteArchive)}`, 5000);
+    let archiveSize = parseInt(statResult.stdout.trim(), 10);
+    if (isNaN(archiveSize))
+        archiveSize = 0;
+    try {
+        await sshManager.sftpDownload(session.ssh, remoteArchive, resolvedLocal);
+    }
+    catch (err) {
+        logger.error({ sessionId: session_id, remoteArchive, localDest: resolvedLocal, error: err.message }, 'Backup download failed');
+        try {
+            await sshManager.exec(session.ssh, `rm -f ${q(remoteArchive)}`, 5000);
+        }
+        catch { }
+        return {
+            content: [{ type: 'text', text: `Error: Download failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+    const localSize = fs.statSync(resolvedLocal).size;
+    if (remove_remote_archive) {
+        try {
+            await sshManager.exec(session.ssh, `rm -f ${q(remoteArchive)}`, 5000);
+        }
+        catch {
+            logger.warn({ sessionId: session_id, remoteArchive }, 'Failed to clean up remote archive');
+        }
+    }
+    logger.info({ sessionId: session_id, paths, archiveSize, localSize, localDest: resolvedLocal }, 'Backup complete');
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    session_id,
+                    local_path: resolvedLocal,
+                    remote_archive_removed: remove_remote_archive,
+                    archive_size_bytes: localSize,
+                    paths_backed_up: paths,
+                    excluded_patterns: exclude,
+                    timestamp: new Date().toISOString(),
+                }, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=backup.js.map

package/dist/tools/backup.js.map

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

package/dist/tools/connect.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { SessionManager } from '../core/SessionManager.js';
+import { SSHManager } from '../core/SSHManager.js';
+import { TmuxManager } from '../core/TmuxManager.js';
+export declare const connectSchema: z.ZodObject<{
+    host: z.ZodString;
+    proxy_jump: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    host: string;
+    proxy_jump?: string | undefined;
+}, {
+    host: string;
+    proxy_jump?: string | undefined;
+}>;
+export declare const connectTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            host: {
+                type: string;
+                description: string;
+            };
+            proxy_jump: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleConnect(args: unknown, sessionManager: SessionManager, sshManager: SSHManager, tmuxManager: TmuxManager): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/tools/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/tools/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAQjE,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;CAkBvB,CAAC;AAEF,wBAAsB,aAAa,CACjC,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW;;;;;;;;;;;;GA+NzB"}

package/dist/tools/connect.js

@@ -0,0 +1,235 @@
+import { z } from 'zod';
+import { MCP_PROMPT } from '../core/TmuxManager.js';
+import { listHostAliases, getHostConfig } from '../utils/sshConfig.js';
+import { buildSshConfig } from '../utils/ssh.js';
+import { sanitizeTmuxSessionName } from '../utils/validation.js';
+import { isHostAllowed } from '../utils/security.js';
+import { logger } from '../utils/logger.js';
+import { v4 as uuidv4 } from 'uuid';
+export const connectSchema = z.object({
+    host: z.string().min(1).describe('SSH host alias from ~/.ssh/config'),
+    proxy_jump: z.string().min(1).optional().describe('SSH host alias of the bastion/jump host to tunnel through'),
+});
+export const connectTool = {
+    name: 'connect',
+    description: 'Connect to a remote host via SSH and establish a persistent tmux-backed interactive shell session. Supports bash and zsh only. Use proxy_jump to tunnel through a bastion host.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            host: {
+                type: 'string',
+                description: 'SSH host alias from ~/.ssh/config',
+            },
+            proxy_jump: {
+                type: 'string',
+                description: 'Optional SSH host alias of a bastion/jump host. Overrides ProxyJump from ~/.ssh/config.',
+            },
+        },
+        required: ['host'],
+    },
+};
+export async function handleConnect(args, sessionManager, sshManager, tmuxManager) {
+    const parsed = connectSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Invalid arguments: ${parsed.error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const { host } = parsed.data;
+    // Security: check host allowlist
+    if (!isHostAllowed(host)) {
+        logger.warn({ host }, 'Host rejected by allowlist');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: Host '${host}' is not in the allowed hosts list`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Validate host exists in SSH config
+    const aliases = listHostAliases();
+    if (!aliases.includes(host)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: Host alias '${host}' not found in SSH config.\nAvailable aliases: ${aliases.join(', ') || '(none)'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const hostConfig = getHostConfig(host);
+    if (!hostConfig) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: Failed to resolve SSH configuration for '${host}'`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const proxyJumpAlias = parsed.data.proxy_jump || hostConfig.proxyJump;
+    const sshConfig = buildSshConfig(hostConfig);
+    if (!sshConfig) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: Failed to read SSH private key for '${host}'`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    let ssh;
+    try {
+        if (proxyJumpAlias) {
+            if (!isHostAllowed(proxyJumpAlias)) {
+                return {
+                    content: [{ type: 'text', text: `Error: Proxy host '${proxyJumpAlias}' is not in the allowed hosts list` }],
+                    isError: true,
+                };
+            }
+            const proxyConfig = getHostConfig(proxyJumpAlias);
+            if (!proxyConfig) {
+                return {
+                    content: [{ type: 'text', text: `Error: Failed to resolve SSH config for proxy '${proxyJumpAlias}'` }],
+                    isError: true,
+                };
+            }
+            const proxySshConfig = buildSshConfig(proxyConfig);
+            if (!proxySshConfig) {
+                return {
+                    content: [{ type: 'text', text: `Error: Failed to read SSH key for proxy '${proxyJumpAlias}'` }],
+                    isError: true,
+                };
+            }
+            ssh = await sshManager.connectWithProxy(proxySshConfig, sshConfig);
+            logger.info({ host, proxy: proxyJumpAlias }, 'Connected via bastion');
+        }
+        else {
+            ssh = await sshManager.connect(sshConfig);
+        }
+    }
+    catch (err) {
+        logger.error({ host, proxyJump: proxyJumpAlias, error: err.message }, 'SSH connection failed');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: SSH connection failed: ${err.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Check tmux is installed
+    const tmuxInstalled = await tmuxManager.isInstalled(ssh);
+    if (!tmuxInstalled) {
+        sshManager.disconnect(ssh);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: tmux is not installed on host '${host}'. Please install tmux first.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const tmuxSessionName = `mcp_${sanitizeTmuxSessionName(host)}_${uuidv4().replace(/-/g, '').slice(0, 12)}`;
+    try {
+        await tmuxManager.createOrAttachSession(ssh, tmuxSessionName);
+    }
+    catch (err) {
+        sshManager.disconnect(ssh);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: Failed to create tmux session: ${err.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Detect shell
+    let shell = null;
+    try {
+        shell = await tmuxManager.detectShell(ssh, tmuxSessionName);
+    }
+    catch (err) {
+        logger.warn({ host, error: err.message }, 'Shell detection failed, continuing anyway');
+    }
+    const supportedShells = ['bash', 'zsh'];
+    if (shell && !supportedShells.includes(shell)) {
+        try {
+            await tmuxManager.killSession(ssh, tmuxSessionName);
+        }
+        catch { }
+        sshManager.disconnect(ssh);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: Unsupported shell '${shell}' on host '${host}'. Only bash and zsh are supported in V1.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Inject deterministic prompt with retry + verification
+    let promptInjected = false;
+    for (let attempt = 0; attempt < 5; attempt++) {
+        try {
+            await new Promise((r) => setTimeout(r, 300));
+            await tmuxManager.injectPrompt(ssh, tmuxSessionName);
+            await new Promise((r) => setTimeout(r, 300));
+            const output = await tmuxManager.capturePane(ssh, tmuxSessionName, 10);
+            if (output.includes(MCP_PROMPT)) {
+                promptInjected = true;
+                break;
+            }
+        }
+        catch {
+            logger.warn({ host, attempt }, 'Prompt injection retry');
+        }
+    }
+    if (!promptInjected) {
+        logger.warn({ host }, 'Failed to inject deterministic prompt after retries, continuing');
+    }
+    // Apply tmux options for AI-friendly behavior
+    try {
+        await tmuxManager.applyOptions(ssh, tmuxSessionName);
+    }
+    catch (err) {
+        logger.warn({ host, tmuxSessionName, error: err.message }, 'Failed to apply tmux options, continuing anyway');
+    }
+    const session = sessionManager.create(host, ssh, tmuxSessionName, shell || undefined);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    session_id: session.id,
+                    host: session.host,
+                    tmux_session: session.tmuxSession,
+                    shell: shell || 'unknown',
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=connect.js.map

package/dist/tools/connect.js.map

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

package/dist/tools/connection_status.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { SessionManager } from '../core/SessionManager.js';
+import { SSHManager } from '../core/SSHManager.js';
+import { TmuxManager } from '../core/TmuxManager.js';
+export declare const connectionStatusSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    session_id: string;
+}, {
+    session_id: string;
+}>;
+export declare const connectionStatusTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            session_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleConnectionStatus(args: unknown, sessionManager: SessionManager, sshManager: SSHManager, tmuxManager: TmuxManager): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=connection_status.d.ts.map

package/dist/tools/connection_status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection_status.d.ts","sourceRoot":"","sources":["../../src/tools/connection_status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;CAchC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW;;;;;;;;;;;;GAmDzB"}

package/dist/tools/connection_status.js

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import { logger } from '../utils/logger.js';
+export const connectionStatusSchema = z.object({
+    session_id: z.string().min(1),
+});
+export const connectionStatusTool = {
+    name: 'connection_status',
+    description: 'Check the health of an active session: SSH connection liveness and tmux session existence.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            session_id: {
+                type: 'string',
+                description: 'Session ID returned by connect',
+            },
+        },
+        required: ['session_id'],
+    },
+};
+export async function handleConnectionStatus(args, sessionManager, sshManager, tmuxManager) {
+    const parsed = connectionStatusSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [{ type: 'text', text: `Invalid arguments: ${parsed.error.message}` }],
+            isError: true,
+        };
+    }
+    const { session_id } = parsed.data;
+    const session = sessionManager.get(session_id);
+    if (!session) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({
+                        session_id,
+                        exists: false,
+                        ssh_alive: false,
+                        tmux_exists: false,
+                    }, null, 2) }],
+        };
+    }
+    let sshAlive = sshManager.isAlive(session.ssh);
+    let tmuxExists = false;
+    if (sshAlive) {
+        try {
+            tmuxExists = await tmuxManager.hasSession(session.ssh, session.tmuxSession);
+        }
+        catch (err) {
+            logger.warn({ sessionId: session_id, error: err.message }, 'tmux hasSession check failed');
+        }
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    session_id,
+                    host: session.host,
+                    exists: true,
+                    ssh_alive: sshAlive,
+                    tmux_exists: tmuxExists,
+                    tmux_session: session.tmuxSession,
+                    shell: session.shell || 'unknown',
+                    connected_at: new Date(session.connectedAt).toISOString(),
+                    last_activity: new Date(session.lastActivity).toISOString(),
+                }, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=connection_status.js.map

package/dist/tools/connection_status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection_status.js","sourceRoot":"","sources":["../../src/tools/connection_status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,4FAA4F;IAC9F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAa,EACb,cAA8B,EAC9B,UAAsB,EACtB,WAAwB;IAExB,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACxF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACnC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACtD,UAAU;wBACV,MAAM,EAAE,KAAK;wBACb,SAAS,EAAE,KAAK;wBAChB,WAAW,EAAE,KAAK;qBACnB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACf,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,EAAE,8BAA8B,CAAC,CAAC;QACxG,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,UAAU;oBACV,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,MAAM,EAAE,IAAI;oBACZ,SAAS,EAAE,QAAQ;oBACnB,WAAW,EAAE,UAAU;oBACvB,YAAY,EAAE,OAAO,CAAC,WAAW;oBACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;oBACjC,YAAY,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE;oBACzD,aAAa,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE;iBAC5D,EAAE,IAAI,EAAE,CAAC,CAAC;aACZ,CAAC;KACH,CAAC;AACJ,CAAC"}