@yawlabs/ssh-mcp 0.14.1 → 0.15.1

package/dist/diagnose.d.ts

@@ -0,0 +1,33 @@
+export interface DiagnosticResult {
+    status: "ok" | "warning" | "error";
+    message: string;
+}
+export interface DiagnosticReport {
+    overall: "ok" | "warning" | "error";
+    checks: Array<{
+        name: string;
+    } & DiagnosticResult>;
+    suggestions: string[];
+}
+export declare const SSH_NON_KEY_FILES: ReadonlySet<string>;
+export declare function isValidHostname(host: string): boolean;
+export declare function runArgs(cmd: string, args: string[]): {
+    stdout: string;
+    ok: boolean;
+};
+export declare function checkSshAgent(): DiagnosticResult;
+export declare function checkSshKeys(): DiagnosticResult;
+export declare function checkKnownHosts(host: string): DiagnosticResult;
+export type SshProbeOutcome = "ok" | "permission-denied" | "connection-refused" | "timed-out" | "host-key-mismatch" | "dns-failure" | "unknown";
+export interface SshProbeResult {
+    outcome: SshProbeOutcome;
+    /** Combined stdout+stderr from ssh, for the fall-through "unknown" message. */
+    output: string;
+    /** Wall time of the ssh invocation. Only `testConnection` surfaces this. */
+    elapsedMs: number;
+}
+export declare function classifySshProbe(ok: boolean, output: string): SshProbeOutcome;
+export declare function probeSshConnection(host: string, port: number): SshProbeResult;
+export declare function checkConnectivity(host: string, port?: number): DiagnosticResult;
+export declare function checkSshConfig(host: string): DiagnosticResult;
+export declare function diagnose(host: string, port?: number): DiagnosticReport;

package/dist/env.d.ts

@@ -0,0 +1,87 @@
+export interface KeyInfo {
+    name: string;
+    path: string;
+    type: string;
+    fingerprint?: string;
+    loadedInAgent: boolean;
+}
+export interface AgentResult {
+    running: boolean;
+    reachable: boolean;
+    socket?: string;
+    keys: string[];
+    started: boolean;
+    env?: {
+        SSH_AUTH_SOCK?: string;
+        SSH_AGENT_PID?: string;
+    };
+    message: string;
+}
+export declare function killStartedAgent(): void;
+export declare function ensureAgent(): AgentResult;
+/**
+ * Outcome of a ~/.ssh scan. An empty `keys` array on its own is ambiguous -- it is what
+ * "there is no ~/.ssh", "~/.ssh could not be read" and "~/.ssh holds no private keys" all
+ * produce -- and only the last of those is remediated by generating a key. `status` is the
+ * discriminator that tells them apart:
+ *
+ *   "ok"          the directory was read; `keys` is what it holds (possibly nothing)
+ *   "no-dir"      ~/.ssh does not exist (a fresh machine -- ssh-keygen will create it)
+ *   "unreadable"  readdir threw: permission denied, or a non-directory at that path.
+ *                 `reason` carries the underlying errno message.
+ *
+ * `keys` is always present and always empty for the two non-"ok" statuses, so a caller that
+ * only wants the keys can read it without narrowing first.
+ */
+export type SshKeyListing = {
+    status: "ok";
+    dir: string;
+    keys: KeyInfo[];
+} | {
+    status: "no-dir";
+    dir: string;
+    keys: KeyInfo[];
+} | {
+    status: "unreadable";
+    dir: string;
+    keys: KeyInfo[];
+    reason: string;
+};
+/**
+ * Thin wrapper kept for every caller that only needs the keys: it discards the reason a
+ * scan came back empty. Prefer listSshKeysDetailed when an empty result has to be
+ * explained to a human or an agent -- see the type above for why.
+ */
+export declare function listSshKeys(): KeyInfo[];
+export declare function listSshKeysDetailed(): SshKeyListing;
+export declare function loadKey(keyPath: string): {
+    status: "ok" | "error";
+    message: string;
+};
+export interface ConfigLookupResult {
+    hostname: string;
+    user: string;
+    port: string;
+    identityFile: string[];
+    proxyJump?: string;
+    proxyCommand?: string;
+    all: Record<string, string>;
+    raw: string;
+}
+export declare function configLookup(host: string): ConfigLookupResult | {
+    error: string;
+};
+export declare function fixKnownHosts(host: string, port?: number): {
+    status: "ok" | "error";
+    message: string;
+    actions: string[];
+};
+export declare function checkGitSsh(host?: string, user?: string): {
+    status: "ok" | "error";
+    message: string;
+    authenticatedAs?: string;
+};
+export declare function testConnection(host: string, port?: number): {
+    status: "ok" | "warning" | "error";
+    message: string;
+};

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};