ssh-mcp-pro 1.0.0

package/dist/errors.js

@@ -0,0 +1,84 @@
+import { ErrorCode, SSHMCPError } from "./types.js";
+/**
+ * Creates an authentication error
+ */
+export function createAuthError(message, hint) {
+    return new SSHMCPError(ErrorCode.EAUTH, message, hint, "SSH authentication failed. Please check your credentials or SSH key.", true, "Use ssh_open_session with different auth method (password, key, or agent)");
+}
+/**
+ * Creates a connection error
+ */
+export function createConnectionError(message, hint) {
+    return new SSHMCPError(ErrorCode.ECONN, message, hint, "Unable to connect to the SSH server. The server may be down or unreachable.", true, "Check network connectivity and verify host/port are correct");
+}
+/**
+ * Creates a timeout error
+ */
+export function createTimeoutError(message, hint) {
+    return new SSHMCPError(ErrorCode.ETIMEOUT, message, hint, "The operation timed out. The server may be slow or unresponsive.", true, "Try increasing timeout or check server load");
+}
+/**
+ * Creates a sudo error
+ */
+export function createSudoError(message, hint) {
+    return new SSHMCPError(ErrorCode.ENOSUDO, message, hint, "Root/sudo privileges are required but not available.", true, "Configure a restricted NOPASSWD sudoers profile for approved commands");
+}
+/**
+ * Creates a package manager error
+ */
+export function createPackageManagerError(message, hint) {
+    return new SSHMCPError(ErrorCode.EPMGR, message, hint, "Package manager operation failed. Check if the package name is correct.", true, "Verify package name and try ensure_package with correct packageName");
+}
+/**
+ * Creates a filesystem error
+ */
+export function createFilesystemError(message, hint) {
+    return new SSHMCPError(ErrorCode.EFS, message, hint, "File system operation failed. Check path and permissions.", true, "Verify the path exists and you have proper permissions");
+}
+/**
+ * Creates a patch error
+ */
+export function createPatchError(message, hint) {
+    return new SSHMCPError(ErrorCode.EPATCH, message, hint, "Failed to apply text patch. The file content may have changed.", true, "Re-read the file with fs_read and try again with updated content");
+}
+/**
+ * Creates a bad request error
+ */
+export function createBadRequestError(message, hint) {
+    return new SSHMCPError(ErrorCode.EBADREQ, message, hint, "Invalid request parameters.", false, "Check the parameter format and values");
+}
+/**
+ * Creates a policy denial error
+ */
+export function createPolicyError(message, hint) {
+    return new SSHMCPError(ErrorCode.EPOLICY, message, hint, "The operation was denied by the configured safety policy.", false, "Review the policy or run the request in explain mode before changing guardrails");
+}
+/**
+ * Creates a host key verification error
+ */
+export function createHostKeyError(message, hint) {
+    return new SSHMCPError(ErrorCode.EHOSTKEY, message, hint, "SSH host key verification failed.", true, "Verify known_hosts or expectedHostKeySha256 before reconnecting");
+}
+/**
+ * Creates a configured limit error
+ */
+export function createLimitError(message, hint) {
+    return new SSHMCPError(ErrorCode.ELIMIT, message, hint, "The operation exceeded a configured safety limit.", false, "Use a smaller request, transfer the file, or raise the configured limit intentionally");
+}
+/**
+ * Creates an unsupported platform/capability error
+ */
+export function createUnsupportedError(message, hint) {
+    return new SSHMCPError(ErrorCode.EUNSUPPORTED, message, hint, "The requested operation is not supported for this host or transport.", false, "Use a supported tool for this platform or check the capability resource");
+}
+/**
+ * Wraps an unknown error into an SSH MCP error
+ */
+export function wrapError(error, code, hint) {
+    if (error instanceof SSHMCPError) {
+        return error;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return new SSHMCPError(code, message, hint, "An unexpected error occurred.", true, "Try the operation again or check server status");
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/fs-tools.d.ts

@@ -0,0 +1,26 @@
+import type { MetricsCollector } from "./metrics.js";
+import type { PolicyEngine } from "./policy.js";
+import type { SessionManager } from "./session.js";
+import type { ServerConfig } from "./config.js";
+import type { DirListResult, FileStatInfo } from "./types.js";
+export interface FsService {
+    readFile(sessionId: string, path: string, encoding?: string, maxBytes?: number): Promise<string>;
+    writeFile(sessionId: string, path: string, data: string, mode?: number): Promise<boolean>;
+    statFile(sessionId: string, path: string): Promise<FileStatInfo>;
+    listDirectory(sessionId: string, path: string, page?: number, limit?: number): Promise<DirListResult>;
+    makeDirectories(sessionId: string, path: string): Promise<boolean>;
+    removeRecursive(sessionId: string, path: string): Promise<boolean>;
+    renameFile(sessionId: string, from: string, to: string): Promise<boolean>;
+    pathExists(sessionId: string, path: string): Promise<boolean>;
+    getFileSize(sessionId: string, path: string): Promise<number>;
+    isDirectory(sessionId: string, path: string): Promise<boolean>;
+    isFile(sessionId: string, path: string): Promise<boolean>;
+}
+export interface FsServiceDeps {
+    sessionManager: Pick<SessionManager, "getSession" | "getOSInfo">;
+    metrics: Pick<MetricsCollector, "recordFileRead" | "recordFileWrite" | "recordFileDelete">;
+    config: Pick<ServerConfig, "maxFileSize" | "maxFileWriteBytes">;
+    policy: Pick<PolicyEngine, "assertAllowed">;
+}
+export declare function createFsService({ sessionManager, metrics, config, policy, }: FsServiceDeps): FsService;
+//# sourceMappingURL=fs-tools.d.ts.map

package/dist/fs-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-tools.d.ts","sourceRoot":"","sources":["../src/fs-tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAY,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGxE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACjE,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,WAAW,CAAC,CAAC;IACjE,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC,CAAC;IAC3F,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,mBAAmB,CAAC,CAAC;IAChE,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;CAC7C;AAqLD,wBAAgB,eAAe,CAAC,EAC9B,cAAc,EACd,OAAO,EACP,MAAM,EACN,MAAM,GACP,EAAE,aAAa,GAAG,SAAS,CAmiB3B"}