codecraftai-protocol-ssh 1.3.0__py3-none-any.whl

ccai/protocols/ssh/sshconst.py

@@ -0,0 +1,49 @@
+"""
+    .. module:: sshconst
+    :platform: Darwin, Linux, Unix, Windows
+    :synopsis: Module containing ssh constants
+    
+    .. moduleauthor:: Myron Walker <myron.walker@gmail.com>
+    
+"""
+
+__author__ = "Myron Walker"
+__copyright__ = "Copyright 2025, Code Craft AI LLC"
+__credits__ = []
+
+
+import dataclasses
+import os
+import re
+
+from ccai.credentials.sshcredential import SshCredential
+
+DEFAULT_SSH_TIMEOUT = 300
+DEFAULT_SSH_RETRY_INTERVAL = .5
+
+DEFAULT_FAILURE_LABEL = "Failure"
+DEFAULT_SUCCESS_LABEL = "Success"
+
+INTERACTIVE_PROMPT="PROMPT%:%:%"
+INTERACTIVE_PROMPT_BYTES = INTERACTIVE_PROMPT.encode('utf-8')
+
+TEMPLATE_COMMAND_FAILURE = "RUNCMD%s: " + DEFAULT_FAILURE_LABEL + " running CMD=%s" + os.linesep + "STDOUT:" + os.linesep + "%s" + os.linesep + "STDERR:" + os.linesep + "%s"
+TEMPLATE_COMMAND_SUCCESS = "RUNCMD%s: " + DEFAULT_SUCCESS_LABEL + " running CMD=%s" + os.linesep + "STDOUT:" + os.linesep + "%s" + os.linesep + "STDERR:" + os.linesep + "%s"
+
+#                    PERMS          LINKS   OWNER       GROUPS    SIZE   MONTH  DAY  TIME    NAME
+#                  rwxrwxrwx         24      myron      myron     4096   Jul    4   00:37  PCBs
+REGEX_DIRECTORY_ENTRY = re.compile(r"([\S]+)\s+([0-9]+)\s+([\S]+)\s+([\S]+)\s+([0-9]+)\s+([A-Za-z]+\s+[0-9]+\s+(?:[0-9:]+|[0-9]+))\s+(.+)")
+
+
+@dataclasses.dataclass
+class SshJumpParams:
+    """
+        Parameters describing an SSH jump host used for tunneling.
+
+        :param host: Hostname or IP address of the jump server.
+        :param credential: Credential used when connecting to the jump host.
+        :param port: Port number of the SSH service.
+    """
+    host: str
+    credential: SshCredential
+    port: int = 22

ccai/protocols/ssh/sshconstants.py

@@ -0,0 +1,185 @@
+"""
+SSH Protocol Constants
+"""
+
+# SSH Message Numbers
+SSH_MSG_DISCONNECT = 1
+SSH_MSG_IGNORE = 2
+SSH_MSG_UNIMPLEMENTED = 3
+SSH_MSG_DEBUG = 4
+SSH_MSG_SERVICE_REQUEST = 5
+SSH_MSG_SERVICE_ACCEPT = 6
+
+# Key Exchange
+SSH_MSG_KEXINIT = 20
+SSH_MSG_NEWKEYS = 21
+
+# Diffie-Hellman Key Exchange
+SSH_MSG_KEXDH_INIT = 30
+SSH_MSG_KEXDH_REPLY = 31
+
+# User Authentication
+SSH_MSG_USERAUTH_REQUEST = 50
+SSH_MSG_USERAUTH_FAILURE = 51
+SSH_MSG_USERAUTH_SUCCESS = 52
+SSH_MSG_USERAUTH_BANNER = 53
+
+# Connection Protocol
+SSH_MSG_GLOBAL_REQUEST = 80
+SSH_MSG_REQUEST_SUCCESS = 81
+SSH_MSG_REQUEST_FAILURE = 82
+SSH_MSG_CHANNEL_OPEN = 90
+SSH_MSG_CHANNEL_OPEN_CONFIRMATION = 91
+SSH_MSG_CHANNEL_OPEN_FAILURE = 92
+SSH_MSG_CHANNEL_WINDOW_ADJUST = 93
+SSH_MSG_CHANNEL_DATA = 94
+SSH_MSG_CHANNEL_EXTENDED_DATA = 95
+SSH_MSG_CHANNEL_EOF = 96
+SSH_MSG_CHANNEL_CLOSE = 97
+SSH_MSG_CHANNEL_REQUEST = 98
+SSH_MSG_CHANNEL_SUCCESS = 99
+SSH_MSG_CHANNEL_FAILURE = 100
+
+# Extended Data Type Codes (RFC 4254 Section 5.2)
+SSH_EXTENDED_DATA_STDERR = 1
+
+# Channel Open Failure Reason Codes (RFC 4254 Section 5.1)
+SSH_OPEN_ADMINISTRATIVELY_PROHIBITED = 1
+SSH_OPEN_CONNECT_FAILED = 2
+SSH_OPEN_UNKNOWN_CHANNEL_TYPE = 3
+SSH_OPEN_RESOURCE_SHORTAGE = 4
+
+SSH_OPEN_FAILURE_REASON_NAMES = {
+    SSH_OPEN_ADMINISTRATIVELY_PROHIBITED: "SSH_OPEN_ADMINISTRATIVELY_PROHIBITED",
+    SSH_OPEN_CONNECT_FAILED: "SSH_OPEN_CONNECT_FAILED",
+    SSH_OPEN_UNKNOWN_CHANNEL_TYPE: "SSH_OPEN_UNKNOWN_CHANNEL_TYPE",
+    SSH_OPEN_RESOURCE_SHORTAGE: "SSH_OPEN_RESOURCE_SHORTAGE",
+}
+
+# Disconnect Reason Codes
+SSH_DISCONNECT_HOST_NOT_ALLOWED_TO_CONNECT = 1
+SSH_DISCONNECT_PROTOCOL_ERROR = 2
+SSH_DISCONNECT_KEY_EXCHANGE_FAILED = 3
+SSH_DISCONNECT_RESERVED = 4
+SSH_DISCONNECT_MAC_ERROR = 5
+SSH_DISCONNECT_COMPRESSION_ERROR = 6
+SSH_DISCONNECT_SERVICE_NOT_AVAILABLE = 7
+SSH_DISCONNECT_PROTOCOL_VERSION_NOT_SUPPORTED = 8
+SSH_DISCONNECT_HOST_KEY_NOT_VERIFIABLE = 9
+SSH_DISCONNECT_CONNECTION_LOST = 10
+SSH_DISCONNECT_BY_APPLICATION = 11
+SSH_DISCONNECT_TOO_MANY_CONNECTIONS = 12
+SSH_DISCONNECT_AUTH_CANCELLED_BY_USER = 13
+SSH_DISCONNECT_NO_MORE_AUTH_METHODS_AVAILABLE = 14
+SSH_DISCONNECT_ILLEGAL_USER_NAME = 15
+
+# Default Port
+SSH_PORT = 22
+
+# Versions
+MSG_STR_VERSION = "SSH-2.0-AutoMojoSSH_0.1"
+
+# Terminal Modes (RFC 4254 Section 8)
+TTY_OP_END = 0
+VINTR = 1
+VQUIT = 2
+VERASE = 3
+VKILL = 4
+VEOF = 5
+VEOL = 6
+VEOL2 = 7
+VSTART = 8
+VSTOP = 9
+VSUSP = 10
+VDSUSP = 11
+VREPRINT = 12
+VWERASE = 13
+VLNEXT = 14
+VFLUSH = 15
+VSWTCH = 16
+VSTATUS = 17
+VDISCARD = 18
+IGNPAR = 30
+PARMRK = 31
+INPCK = 32
+ISTRIP = 33
+INLCR = 34
+IGNCR = 35
+ICRNL = 36
+IUCLC = 37
+IXON = 38
+IXANY = 39
+IXOFF = 40
+IMAXBEL = 41
+ISIG = 50
+ICANON = 51
+XCASE = 52
+ECHO = 53
+ECHOE = 54
+ECHOK = 55
+ECHONL = 56
+NOFLSH = 57
+TOSTOP = 58
+IEXTEN = 59
+ECHOCTL = 60
+ECHOKE = 61
+PENDIN = 62
+OPOST = 70
+OLCUC = 71
+ONLCR = 72
+OCRNL = 73
+ONOCR = 74
+ONLRET = 75
+CS7 = 90
+CS8 = 91
+PARENB = 92
+PARODD = 93
+TTY_OP_ISPEED = 128
+TTY_OP_OSPEED = 129
+
+# SFTP Protocol (Version 3)
+SSH_FXP_INIT = 1
+SSH_FXP_VERSION = 2
+SSH_FXP_OPEN = 3
+SSH_FXP_CLOSE = 4
+SSH_FXP_READ = 5
+SSH_FXP_WRITE = 6
+SSH_FXP_LSTAT = 7
+SSH_FXP_FSTAT = 8
+SSH_FXP_SETSTAT = 9
+SSH_FXP_FSETSTAT = 10
+SSH_FXP_OPENDIR = 11
+SSH_FXP_READDIR = 12
+SSH_FXP_REMOVE = 13
+SSH_FXP_MKDIR = 14
+SSH_FXP_RMDIR = 15
+SSH_FXP_REALPATH = 16
+SSH_FXP_STAT = 17
+SSH_FXP_RENAME = 18
+SSH_FXP_READLINK = 19
+SSH_FXP_SYMLINK = 20
+SSH_FXP_STATUS = 101
+SSH_FXP_HANDLE = 102
+SSH_FXP_DATA = 103
+SSH_FXP_NAME = 104
+SSH_FXP_ATTRS = 105
+SSH_FXP_EXTENDED = 200
+SSH_FXP_EXTENDED_REPLY = 201
+
+# SFTP Attributes
+SSH_FILEXFER_ATTR_SIZE = 0x00000001
+SSH_FILEXFER_ATTR_UIDGID = 0x00000002
+SSH_FILEXFER_ATTR_PERMISSIONS = 0x00000004
+SSH_FILEXFER_ATTR_ACMODTIME = 0x00000008
+SSH_FILEXFER_ATTR_EXTENDED = 0x80000000
+
+# SFTP Status Codes
+SSH_FX_OK = 0
+SSH_FX_EOF = 1
+SSH_FX_NO_SUCH_FILE = 2
+SSH_FX_PERMISSION_DENIED = 3
+SSH_FX_FAILURE = 4
+SSH_FX_BAD_MESSAGE = 5
+SSH_FX_NO_CONNECTION = 6
+SSH_FX_CONNECTION_LOST = 7
+SSH_FX_OP_UNSUPPORTED = 8