ssh-agent-workspace 1.0.0

package/dist/tools/sftp_download.js

@@ -0,0 +1,90 @@
+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 sftpDownloadSchema = z.object({
+    session_id: z.string().min(1),
+    remote_path: z.string().min(1).describe('Absolute path to the file on the remote host'),
+    local_path: z.string().min(1).describe('Absolute destination path on the local machine'),
+});
+export const sftpDownloadTool = {
+    name: 'sftp_download',
+    description: 'Download a file from a remote host via SFTP. Requires an active session.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            session_id: {
+                type: 'string',
+                description: 'Session ID returned by connect',
+            },
+            remote_path: {
+                type: 'string',
+                description: 'Absolute path to the file on the remote host',
+            },
+            local_path: {
+                type: 'string',
+                description: 'Absolute destination path on the local machine',
+            },
+        },
+        required: ['session_id', 'remote_path', 'local_path'],
+    },
+};
+export async function handleSftpDownload(args, sessionManager, sshManager) {
+    const parsed = sftpDownloadSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [{ type: 'text', text: `Invalid arguments: ${parsed.error.message}` }],
+            isError: true,
+        };
+    }
+    const { session_id, remote_path, local_path } = parsed.data;
+    const session = sessionManager.get(session_id);
+    if (!session) {
+        return {
+            content: [{ type: 'text', text: `Error: Session '${session_id}' not found or has been disconnected` }],
+            isError: true,
+        };
+    }
+    if (isReadOnlyMode(session.host)) {
+        return {
+            content: [{ type: 'text', text: `Error: Host '${session.host}' is in read-only mode. SFTP download is disabled.` }],
+            isError: true,
+        };
+    }
+    if (!sshManager.isAlive(session.ssh)) {
+        return {
+            content: [{ type: 'text', text: `Error: SSH connection for session '${session_id}' is dead. Reconnect with connect or reconnect_to_tmux.` }],
+            isError: true,
+        };
+    }
+    // Resolve and validate local destination directory
+    const resolvedLocal = path.resolve(local_path);
+    const localDir = path.dirname(resolvedLocal);
+    if (!fs.existsSync(localDir)) {
+        fs.mkdirSync(localDir, { recursive: true });
+    }
+    try {
+        await sshManager.sftpDownload(session.ssh, remote_path, resolvedLocal);
+        const size = fs.statSync(resolvedLocal).size;
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'downloaded',
+                        remote_path,
+                        local_path: resolvedLocal,
+                        size_bytes: size,
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        logger.error({ sessionId: session_id, error: err.message }, 'SFTP download failed');
+        return {
+            content: [{ type: 'text', text: `Error: SFTP download failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=sftp_download.js.map

package/dist/tools/sftp_download.js.map

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

package/dist/tools/sftp_list.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sftp_list.d.ts","sourceRoot":"","sources":["../../src/tools/sftp_list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAkB,MAAM,uBAAuB,CAAC;AAInE,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;CAmBxB,CAAC;AAUF,wBAAsB,cAAc,CAClC,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,UAAU;;;;;;;;;;;;GAgEvB"}

package/dist/tools/sftp_list.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { isReadOnlyMode } from '../utils/security.js';
+import { logger } from '../utils/logger.js';
+export const sftpListSchema = z.object({
+    session_id: z.string().min(1),
+    path: z.string().default('/').describe('Absolute directory path on the remote host'),
+});
+export const sftpListTool = {
+    name: 'sftp_list',
+    description: 'List files and directories on a remote host via SFTP. Requires an active session.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            session_id: {
+                type: 'string',
+                description: 'Session ID returned by connect',
+            },
+            path: {
+                type: 'string',
+                description: 'Absolute directory path on the remote host (default: /)',
+                default: '/',
+            },
+        },
+        required: ['session_id'],
+    },
+};
+function formatEntry(entry) {
+    const type = entry.attrs.isDirectory ? 'd' : entry.attrs.isSymbolicLink ? 'l' : '-';
+    const modeStr = entry.attrs.mode.toString(8).slice(-3);
+    const size = entry.attrs.isDirectory ? '-' : entry.attrs.size.toString();
+    const mtime = new Date(entry.attrs.mtime * 1000).toISOString().replace('T', ' ').slice(0, 19);
+    return `${type}${modeStr} ${size.padStart(10)} ${mtime} ${entry.filename}`;
+}
+export async function handleSftpList(args, sessionManager, sshManager) {
+    if (isReadOnlyMode()) {
+        // sftp_list is read-only, allow even in readonly mode
+    }
+    const parsed = sftpListSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [{ type: 'text', text: `Invalid arguments: ${parsed.error.message}` }],
+            isError: true,
+        };
+    }
+    const { session_id, path: remotePath } = parsed.data;
+    const session = sessionManager.get(session_id);
+    if (!session) {
+        return {
+            content: [{ type: 'text', text: `Error: Session '${session_id}' not found or has been disconnected` }],
+            isError: true,
+        };
+    }
+    if (!sshManager.isAlive(session.ssh)) {
+        return {
+            content: [{ type: 'text', text: `Error: SSH connection for session '${session_id}' is dead. Reconnect with connect or reconnect_to_tmux.` }],
+            isError: true,
+        };
+    }
+    try {
+        const entries = await sshManager.sftpList(session.ssh, remotePath);
+        // Sort: directories first, then by name
+        entries.sort((a, b) => {
+            if (a.attrs.isDirectory !== b.attrs.isDirectory) {
+                return a.attrs.isDirectory ? -1 : 1;
+            }
+            return a.filename.localeCompare(b.filename);
+        });
+        const lines = entries.map(formatEntry);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        path: remotePath,
+                        entries: entries.map((e) => ({
+                            name: e.filename,
+                            type: e.attrs.isDirectory ? 'directory' : e.attrs.isSymbolicLink ? 'symlink' : 'file',
+                            size: e.attrs.size,
+                            mtime: new Date(e.attrs.mtime * 1000).toISOString(),
+                        })),
+                        display: lines.join('\n'),
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        logger.error({ sessionId: session_id, error: err.message }, 'SFTP list failed');
+        return {
+            content: [{ type: 'text', text: `Error: SFTP list failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=sftp_list.js.map

package/dist/tools/sftp_list.js.map

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

package/dist/tools/sftp_upload.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sftp_upload.d.ts","sourceRoot":"","sources":["../../src/tools/sftp_upload.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,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAsB1B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,UAAU;;;;;;;;;;;;GAsEvB"}

package/dist/tools/sftp_upload.js

@@ -0,0 +1,98 @@
+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 sftpUploadSchema = z.object({
+    session_id: z.string().min(1),
+    local_path: z.string().min(1).describe('Absolute path to the local file to upload'),
+    remote_path: z.string().min(1).describe('Absolute destination path on the remote host'),
+});
+export const sftpUploadTool = {
+    name: 'sftp_upload',
+    description: 'Upload a local file to a remote host via SFTP. Requires an active session.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            session_id: {
+                type: 'string',
+                description: 'Session ID returned by connect',
+            },
+            local_path: {
+                type: 'string',
+                description: 'Absolute local file path to upload',
+            },
+            remote_path: {
+                type: 'string',
+                description: 'Absolute destination path on the remote host',
+            },
+        },
+        required: ['session_id', 'local_path', 'remote_path'],
+    },
+};
+export async function handleSftpUpload(args, sessionManager, sshManager) {
+    const parsed = sftpUploadSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [{ type: 'text', text: `Invalid arguments: ${parsed.error.message}` }],
+            isError: true,
+        };
+    }
+    const { session_id, local_path, remote_path } = parsed.data;
+    const session = sessionManager.get(session_id);
+    if (!session) {
+        return {
+            content: [{ type: 'text', text: `Error: Session '${session_id}' not found or has been disconnected` }],
+            isError: true,
+        };
+    }
+    if (isReadOnlyMode(session.host)) {
+        return {
+            content: [{ type: 'text', text: `Error: Host '${session.host}' is in read-only mode. SFTP upload is disabled.` }],
+            isError: true,
+        };
+    }
+    if (!sshManager.isAlive(session.ssh)) {
+        return {
+            content: [{ type: 'text', text: `Error: SSH connection for session '${session_id}' is dead. Reconnect with connect or reconnect_to_tmux.` }],
+            isError: true,
+        };
+    }
+    // Security: resolve and validate local path
+    const resolvedLocal = path.resolve(local_path);
+    if (!fs.existsSync(resolvedLocal)) {
+        return {
+            content: [{ type: 'text', text: `Error: Local file not found: ${resolvedLocal}` }],
+            isError: true,
+        };
+    }
+    if (!fs.statSync(resolvedLocal).isFile()) {
+        return {
+            content: [{ type: 'text', text: `Error: Local path is not a file: ${resolvedLocal}` }],
+            isError: true,
+        };
+    }
+    try {
+        await sshManager.sftpUpload(session.ssh, resolvedLocal, remote_path);
+        const size = fs.statSync(resolvedLocal).size;
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'uploaded',
+                        local_path: resolvedLocal,
+                        remote_path,
+                        size_bytes: size,
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        logger.error({ sessionId: session_id, error: err.message }, 'SFTP upload failed');
+        return {
+            content: [{ type: 'text', text: `Error: SFTP upload failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=sftp_upload.js.map

package/dist/tools/sftp_upload.js.map

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

package/dist/tools/ssh_tunnel.d.ts

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+import { SessionManager } from '../core/SessionManager.js';
+import { SSHManager } from '../core/SSHManager.js';
+export declare const tunnelOpenSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    type: z.ZodEnum<["local", "socks5"]>;
+    local_port: z.ZodNumber;
+    remote_host: z.ZodString;
+    remote_port: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "local" | "socks5";
+    session_id: string;
+    local_port: number;
+    remote_host: string;
+    remote_port: number;
+}, {
+    type: "local" | "socks5";
+    session_id: string;
+    local_port: number;
+    remote_host: string;
+    remote_port: number;
+}>;
+export declare const tunnelCloseSchema: z.ZodObject<{
+    tunnel_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    tunnel_id: string;
+}, {
+    tunnel_id: string;
+}>;
+export declare const tunnelListSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const tunnelOpenTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            session_id: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            local_port: {
+                type: string;
+                description: string;
+            };
+            remote_host: {
+                type: string;
+                description: string;
+            };
+            remote_port: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const tunnelCloseTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            tunnel_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const tunnelListTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+};
+export declare function handleTunnelOpen(args: unknown, sessionManager: SessionManager, sshManager: SSHManager): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare function handleTunnelClose(args: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare function handleTunnelList(): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=ssh_tunnel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ssh_tunnel.d.ts","sourceRoot":"","sources":["../../src/tools/ssh_tunnel.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;AAqBnD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAM3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAEH,eAAO,MAAM,gBAAgB,gDAAe,CAAC;AAE7C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B1B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAU3B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;CAI1B,CAAC;AAuBF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,UAAU;;;;;;;;;;;;GAkGvB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;GAUpD;AAED,wBAAsB,gBAAgB;;;;;GAcrC"}