ssh-mcp-pro 1.0.0

package/dist/session.d.ts

@@ -0,0 +1,116 @@
+import { NodeSSH } from "node-ssh";
+import type { SFTPWrapper } from "ssh2";
+import { ConnectionParams, SessionInfo, SessionResult, OSInfo } from "./types.js";
+import type { ServerConfig } from "./config.js";
+import type { PolicyEngine } from "./policy.js";
+/**
+ * SSH session with connection and optional SFTP client.
+ * Some targets expose command execution but do not provide the SFTP subsystem.
+ */
+export interface SSHSession {
+    ssh: NodeSSH;
+    sftp?: SFTPWrapper;
+    info: SessionInfo;
+    connectionParams?: ConnectionParams;
+    osInfo?: OSInfo;
+}
+export type SessionCloseListener = (sessionId: string) => void | Promise<void>;
+/**
+ * Session manager with LRU cache and TTL
+ */
+export declare class SessionManager {
+    private readonly security;
+    private readonly policy?;
+    private readonly sessions;
+    private readonly maxSessions;
+    private readonly defaultTtlMs;
+    private cleanupInterval;
+    private readonly acceptedHostKeys;
+    private readonly closeListeners;
+    constructor(maxSessions?: number, defaultTtlMs?: number, cleanupIntervalMs?: number, security?: ServerConfig["security"], policy?: Pick<PolicyEngine, "assertAllowed"> | undefined);
+    /**
+     * Destroys the session manager, cleaning up all sessions and intervals
+     */
+    destroy(): Promise<void>;
+    onSessionClose(listener: SessionCloseListener): () => void;
+    /**
+     * Gets cached OS info for a session (detects and caches if needed)
+     */
+    getOSInfo(sessionId: string): Promise<OSInfo>;
+    /**
+     * Opens a new SSH session with authentication
+     */
+    openSession(params: ConnectionParams): Promise<SessionResult>;
+    /**
+     * Closes an SSH session
+     */
+    closeSession(sessionId: string): Promise<boolean>;
+    /**
+     * Gets an active session by ID
+     */
+    getSession(sessionId: string): SSHSession | undefined;
+    /**
+     * Builds authentication configuration based on the auth strategy
+     */
+    private buildAuthConfig;
+    /**
+     * Builds key-based authentication
+     */
+    private buildKeyAuth;
+    /**
+     * Builds SSH agent authentication
+     */
+    private buildAgentAuth;
+    /**
+     * Builds automatic authentication (tries password, then key, then agent)
+     */
+    private buildAutoAuth;
+    /**
+     * Loads private key from file path
+     */
+    private loadPrivateKeyFromPath;
+    /**
+     * Auto-discovers private keys in standard locations
+     */
+    private discoverPrivateKeys;
+    /**
+     * Generates a unique session ID
+     */
+    private generateSessionId;
+    private notifySessionClose;
+    private resolveHostKeyPolicy;
+    private verifyAcceptNewHostKey;
+    private verifyKnownHostKey;
+    private parseKnownHostLine;
+    private knownHostPatternMatches;
+    private hashedKnownHostPatternMatches;
+    /**
+     * Evicts the oldest (least recently used) session
+     */
+    private evictOldestSession;
+    /**
+     * Cleans up expired sessions
+     */
+    private cleanupExpiredSessions;
+    /**
+     * Gets information about all active sessions
+     */
+    getActiveSessions(): SessionInfo[];
+    /**
+     * Closes all active sessions
+     */
+    closeAllSessions(): Promise<void>;
+    /**
+     * Attempts to reconnect a session
+     */
+    reconnectSession(sessionId: string): Promise<SessionResult | null>;
+    /**
+     * Checks if a session is alive by executing a simple command
+     */
+    isSessionAlive(sessionId: string): Promise<boolean>;
+    /**
+     * Gets session with auto-reconnect if disconnected
+     */
+    getSessionWithReconnect(sessionId: string): Promise<SSHSession | undefined>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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