ssh-mcp-pro 1.0.0

package/dist/tools/registry.js

@@ -0,0 +1,163 @@
+import { filterToolsForProfile, isToolAllowedForProfile, } from "../connector-profile.js";
+import { logger } from "../logging.js";
+const TOOL_ALIASES = {
+    "ssh.openSession": "ssh_open_session",
+    "ssh.closeSession": "ssh_close_session",
+    "proc.exec": "proc_exec",
+    "proc.sudo": "proc_sudo",
+    "fs.read": "fs_read",
+    "fs.write": "fs_write",
+    "fs.stat": "fs_stat",
+    "fs.list": "fs_list",
+    "fs.mkdirp": "fs_mkdirp",
+    "fs.rmrf": "fs_rmrf",
+    "fs.rename": "fs_rename",
+    "ensure.package": "ensure_package",
+    "ensure.service": "ensure_service",
+    "ensure.linesInFile": "ensure_lines_in_file",
+    "patch.apply": "patch_apply",
+    "os.detect": "os_detect",
+    "ssh.listSessions": "ssh_list_sessions",
+    "ssh.ping": "ssh_ping",
+    "ssh.listConfiguredHosts": "ssh_list_configured_hosts",
+    "ssh.resolveHost": "ssh_resolve_host",
+    "connector.status": "connector_status",
+    "ssh.hostsList": "ssh_hosts_list",
+    "ssh.policyExplain": "ssh_policy_explain",
+    "ssh.hostInspect": "ssh_host_inspect",
+    "ssh.mutationPlan": "ssh_mutation_plan",
+};
+function optionalString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function toToolErrorResponse(payload, fallbackCode = "ETOOL") {
+    const response = {
+        error: true,
+        code: optionalString(payload.code) ?? fallbackCode,
+        message: optionalString(payload.message) ?? "Tool call failed.",
+    };
+    const hint = optionalString(payload.hint);
+    if (hint !== undefined) {
+        response.hint = hint;
+    }
+    if (typeof payload.recoverable === "boolean") {
+        response.recoverable = payload.recoverable;
+    }
+    const suggestedAction = optionalString(payload.suggestedAction);
+    if (suggestedAction !== undefined) {
+        response.suggestedAction = suggestedAction;
+    }
+    return response;
+}
+function errorResult(payload, fallbackCode) {
+    const structuredContent = toToolErrorResponse(payload, fallbackCode);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(structuredContent, null, 2),
+            },
+        ],
+        structuredContent,
+        isError: true,
+    };
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isToolCallResult(value) {
+    return isRecord(value) && "content" in value && Array.isArray(value.content);
+}
+function normalizeToolCallResult(result) {
+    if (!isRecord(result.structuredContent)) {
+        return errorResult({
+            code: "ESTRUCTUREDCONTENT",
+            message: "Tool handlers returning CallToolResult must include structuredContent.",
+        });
+    }
+    if (result.content.length === 0) {
+        return errorResult({
+            code: "ETOOLCONTENT",
+            message: "Tool handlers returning CallToolResult must include at least one content item.",
+        });
+    }
+    return result;
+}
+function normalizeDataResult(data) {
+    if (!isRecord(data)) {
+        return errorResult({
+            code: "ESTRUCTUREDCONTENT",
+            message: "Tool handlers must return a structured JSON object or CallToolResult.",
+        });
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        structuredContent: data,
+    };
+}
+export class ToolRegistry {
+    toolProfile;
+    providers = new Map();
+    constructor(toolProfile = "full") {
+        this.toolProfile = toolProfile;
+    }
+    register(provider) {
+        if (this.providers.has(provider.namespace)) {
+            throw new Error(`ToolRegistry: namespace "${provider.namespace}" is already registered`);
+        }
+        this.providers.set(provider.namespace, provider);
+        logger.debug("ToolRegistry: registered provider", {
+            namespace: provider.namespace,
+        });
+        return this;
+    }
+    getAllTools() {
+        const tools = [];
+        for (const provider of this.providers.values()) {
+            tools.push(...provider.getTools().map((tool) => ({
+                ...tool,
+                title: tool.title ?? tool.annotations?.title,
+            })));
+        }
+        return filterToolsForProfile(tools, this.toolProfile);
+    }
+    async dispatch(rawToolName, args) {
+        const toolName = TOOL_ALIASES[rawToolName] ?? rawToolName;
+        if (!isToolAllowedForProfile(toolName, this.toolProfile)) {
+            return errorResult({
+                code: "ETOOLPROFILE",
+                message: `Tool ${toolName} is not exposed by the ${this.toolProfile} connector profile`,
+            });
+        }
+        for (const provider of this.providers.values()) {
+            const result = provider.handleTool(toolName, args);
+            if (result === undefined) {
+                continue;
+            }
+            try {
+                const data = await result;
+                if (isToolCallResult(data)) {
+                    return normalizeToolCallResult(data);
+                }
+                return normalizeDataResult(data);
+            }
+            catch (error) {
+                logger.error("Tool handler error", {
+                    toolName,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                if (error &&
+                    typeof error === "object" &&
+                    "toJSON" in error &&
+                    typeof error.toJSON === "function") {
+                    const structuredError = error.toJSON();
+                    return errorResult(structuredError);
+                }
+                const message = error instanceof Error ? error.message : String(error);
+                return errorResult({ message });
+            }
+        }
+        return errorResult({ code: "ETOOLNOTFOUND", message: `Unknown tool: ${toolName}` }, "ETOOLNOTFOUND");
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/results.d.ts

@@ -0,0 +1,4 @@
+import type { ToolCallResult } from "./types.js";
+export type StructuredContent = Record<string, unknown>;
+export declare function toolResult(structuredContent: StructuredContent, text?: string): ToolCallResult;
+//# sourceMappingURL=results.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/tools/results.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,wBAAgB,UAAU,CACxB,iBAAiB,EAAE,iBAAiB,EACpC,IAAI,SAA6C,GAChD,cAAc,CAGhB"}

package/dist/tools/results.js

@@ -0,0 +1,5 @@
+export function toolResult(structuredContent, text = JSON.stringify(structuredContent, null, 2)) {
+    const content = [{ type: "text", text }];
+    return { content, structuredContent };
+}
+//# sourceMappingURL=results.js.map

package/dist/tools/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/tools/results.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,UAAU,CACxB,iBAAoC,EACpC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjD,MAAM,OAAO,GAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AACxC,CAAC"}

package/dist/tools/session.provider.d.ts

@@ -0,0 +1,23 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { MetricsCollector } from "../metrics.js";
+import type { SessionManager } from "../session.js";
+import type { ToolProvider } from "./types.js";
+export interface SessionToolProviderDeps {
+    sessionManager: SessionManager;
+    metrics: MetricsCollector;
+}
+export declare class SessionToolProvider implements ToolProvider {
+    private readonly deps;
+    readonly namespace = "session";
+    constructor(deps: SessionToolProviderDeps);
+    getTools(): Tool[];
+    handleTool(toolName: string, args: unknown): Promise<unknown> | undefined;
+    private openSession;
+    private closeSession;
+    private listSessions;
+    private ping;
+    private listConfiguredHosts;
+    private resolveHost;
+    private normalizeConnectionParams;
+}
+//# sourceMappingURL=session.provider.d.ts.map

package/dist/tools/session.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.provider.d.ts","sourceRoot":"","sources":["../../src/tools/session.provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAYpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,qBAAa,mBAAoB,YAAW,YAAY;IAG1C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,SAAS,aAAa;gBAEF,IAAI,EAAE,uBAAuB;IAE1D,QAAQ,IAAI,IAAI,EAAE;IA0KlB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS;YAmB3D,WAAW;YAaX,YAAY;YAUZ,YAAY;YAkBZ,IAAI;YA8BJ,mBAAmB;YAMnB,WAAW;IAOzB,OAAO,CAAC,yBAAyB;CAyClC"}

package/dist/tools/session.provider.js

@@ -0,0 +1,299 @@
+import { logger } from "../logging.js";
+import { getConfiguredHosts, resolveSSHHost } from "../ssh-config.js";
+import { ConnectionParamsSchema, HostAliasSchema, SessionIdSchema } from "../types.js";
+import { annotate } from "./metadata.js";
+import { CONFIGURED_HOSTS_OUTPUT_SCHEMA, RESOLVED_HOST_OUTPUT_SCHEMA, SESSION_CLOSE_OUTPUT_SCHEMA, SESSION_LIST_OUTPUT_SCHEMA, SESSION_OPEN_OUTPUT_SCHEMA, SESSION_PING_OUTPUT_SCHEMA, } from "./output-schemas.js";
+export class SessionToolProvider {
+    deps;
+    namespace = "session";
+    constructor(deps) {
+        this.deps = deps;
+    }
+    getTools() {
+        return [
+            {
+                name: "ssh_open_session",
+                description: "Opens a new SSH session with authentication",
+                annotations: annotate({
+                    title: "Open SSH Session",
+                    readOnly: false,
+                    destructive: false,
+                    idempotent: false,
+                }),
+                outputSchema: SESSION_OPEN_OUTPUT_SCHEMA,
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        host: { type: "string", description: "SSH server hostname or IP" },
+                        username: { type: "string", description: "SSH username" },
+                        port: { type: "number", description: "SSH port (default: 22)" },
+                        auth: {
+                            type: "string",
+                            enum: ["auto", "password", "key", "agent"],
+                            description: "Authentication method (default: auto)",
+                        },
+                        password: {
+                            type: "string",
+                            description: "Password for authentication",
+                        },
+                        privateKey: {
+                            type: "string",
+                            description: "Inline private key content",
+                        },
+                        privateKeyPath: {
+                            type: "string",
+                            description: "Path to private key file",
+                        },
+                        passphrase: {
+                            type: "string",
+                            description: "Passphrase for encrypted private key",
+                        },
+                        useAgent: {
+                            type: "boolean",
+                            description: "Use SSH agent for authentication",
+                        },
+                        readyTimeoutMs: {
+                            type: "number",
+                            description: "Connection timeout in milliseconds (default: 20000)",
+                        },
+                        ttlMs: {
+                            type: "number",
+                            description: "Session TTL in milliseconds (default: 900000)",
+                        },
+                        strictHostKeyChecking: {
+                            type: "boolean",
+                            description: "Deprecated alias. Prefer hostKeyPolicy.",
+                        },
+                        hostKeyPolicy: {
+                            type: "string",
+                            enum: ["strict", "accept-new", "insecure"],
+                            description: "SSH host key verification policy (default: strict)",
+                        },
+                        knownHostsPath: {
+                            type: "string",
+                            description: "Path to known_hosts file",
+                        },
+                        expectedHostKeySha256: {
+                            type: "string",
+                            description: "Pinned SHA-256 host key fingerprint, with or without SHA256: prefix",
+                        },
+                        policyMode: {
+                            type: "string",
+                            enum: ["enforce", "explain"],
+                            description: "Use explain to return the planned connection without opening SSH",
+                        },
+                    },
+                    required: ["host", "username"],
+                },
+            },
+            {
+                name: "ssh_close_session",
+                description: "Closes an SSH session",
+                annotations: annotate({
+                    title: "Close SSH Session",
+                    readOnly: false,
+                    destructive: false,
+                    idempotent: true,
+                }),
+                outputSchema: SESSION_CLOSE_OUTPUT_SCHEMA,
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        sessionId: { type: "string", description: "Session ID to close" },
+                    },
+                    required: ["sessionId"],
+                },
+            },
+            {
+                name: "ssh_list_sessions",
+                description: "Lists all active SSH sessions with their details",
+                annotations: annotate({
+                    title: "List SSH Sessions",
+                    readOnly: true,
+                    idempotent: true,
+                }),
+                outputSchema: SESSION_LIST_OUTPUT_SCHEMA,
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: "ssh_ping",
+                description: "Checks if an SSH session is still alive and responsive",
+                annotations: annotate({
+                    title: "Ping SSH Session",
+                    readOnly: true,
+                    idempotent: true,
+                }),
+                outputSchema: SESSION_PING_OUTPUT_SCHEMA,
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        sessionId: {
+                            type: "string",
+                            description: "SSH session ID to check",
+                        },
+                    },
+                    required: ["sessionId"],
+                },
+            },
+            {
+                name: "ssh_list_configured_hosts",
+                description: "Lists all hosts configured in ~/.ssh/config",
+                annotations: annotate({
+                    title: "List Configured Hosts",
+                    readOnly: true,
+                    idempotent: true,
+                    openWorld: false,
+                }),
+                outputSchema: CONFIGURED_HOSTS_OUTPUT_SCHEMA,
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: "ssh_resolve_host",
+                description: "Resolves a host alias from ~/.ssh/config to connection parameters",
+                annotations: annotate({
+                    title: "Resolve SSH Host",
+                    readOnly: true,
+                    idempotent: true,
+                    openWorld: false,
+                }),
+                outputSchema: RESOLVED_HOST_OUTPUT_SCHEMA,
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        hostAlias: {
+                            type: "string",
+                            description: "Host alias from SSH config",
+                        },
+                    },
+                    required: ["hostAlias"],
+                },
+            },
+        ];
+    }
+    handleTool(toolName, args) {
+        switch (toolName) {
+            case "ssh_open_session":
+                return this.openSession(args);
+            case "ssh_close_session":
+                return this.closeSession(args);
+            case "ssh_list_sessions":
+                return this.listSessions();
+            case "ssh_ping":
+                return this.ping(args);
+            case "ssh_list_configured_hosts":
+                return this.listConfiguredHosts();
+            case "ssh_resolve_host":
+                return this.resolveHost(args);
+            default:
+                return undefined;
+        }
+    }
+    async openSession(args) {
+        const params = ConnectionParamsSchema.parse(args);
+        const result = await this.deps.sessionManager.openSession(this.normalizeConnectionParams(params));
+        this.deps.metrics.recordSessionCreated();
+        logger.info("SSH session opened", {
+            sessionId: result.sessionId,
+            host: params.host,
+        });
+        return result;
+    }
+    async closeSession(args) {
+        const { sessionId } = SessionIdSchema.parse(args);
+        const result = await this.deps.sessionManager.closeSession(sessionId);
+        if (result) {
+            this.deps.metrics.recordSessionClosed();
+        }
+        logger.info("SSH session closed", { sessionId });
+        return { closed: result };
+    }
+    async listSessions() {
+        const sessions = this.deps.sessionManager.getActiveSessions();
+        logger.info("Sessions listed", { count: sessions.length });
+        return {
+            count: sessions.length,
+            sessions: sessions.map((session) => ({
+                sessionId: session.sessionId,
+                host: session.host,
+                username: session.username,
+                port: session.port,
+                createdAt: new Date(session.createdAt).toISOString(),
+                expiresAt: new Date(session.expiresAt).toISOString(),
+                lastUsed: new Date(session.lastUsed).toISOString(),
+                remainingMs: Math.max(0, session.expiresAt - Date.now()),
+            })),
+        };
+    }
+    async ping(args) {
+        const { sessionId } = SessionIdSchema.parse(args);
+        const session = this.deps.sessionManager.getSession(sessionId);
+        if (!session) {
+            return { alive: false, error: "Session not found or expired" };
+        }
+        try {
+            const startTime = Date.now();
+            const pingResult = await session.ssh.execCommand("echo pong");
+            const latencyMs = Date.now() - startTime;
+            const result = {
+                alive: (pingResult.code ?? 0) === 0,
+                latencyMs,
+                sessionId,
+                host: session.info.host,
+                remainingMs: Math.max(0, session.info.expiresAt - Date.now()),
+            };
+            logger.info("Session ping", {
+                sessionId,
+                alive: result.alive,
+                latencyMs,
+            });
+            return result;
+        }
+        catch {
+            return { alive: false, error: "Connection test failed" };
+        }
+    }
+    async listConfiguredHosts() {
+        const hosts = await getConfiguredHosts();
+        logger.info("Configured hosts listed", { count: hosts.length });
+        return { count: hosts.length, hosts };
+    }
+    async resolveHost(args) {
+        const { hostAlias } = HostAliasSchema.parse(args);
+        const resolved = await resolveSSHHost(hostAlias);
+        logger.info("Host resolved", { hostAlias, resolved: resolved.host });
+        return resolved;
+    }
+    normalizeConnectionParams(params) {
+        return {
+            host: params.host,
+            username: params.username,
+            auth: params.auth,
+            readyTimeoutMs: params.readyTimeoutMs,
+            ttlMs: params.ttlMs,
+            policyMode: params.policyMode,
+            ...(params.port !== undefined ? { port: params.port } : {}),
+            ...(params.strictHostKeyChecking !== undefined
+                ? { strictHostKeyChecking: params.strictHostKeyChecking }
+                : {}),
+            ...(params.hostKeyPolicy ? { hostKeyPolicy: params.hostKeyPolicy } : {}),
+            ...(params.password ? { password: params.password } : {}),
+            ...(params.privateKey ? { privateKey: params.privateKey } : {}),
+            ...(params.privateKeyPath ? { privateKeyPath: params.privateKeyPath } : {}),
+            ...(params.passphrase ? { passphrase: params.passphrase } : {}),
+            ...(params.useAgent !== undefined ? { useAgent: params.useAgent } : {}),
+            ...(params.knownHostsPath ? { knownHostsPath: params.knownHostsPath } : {}),
+            ...(params.expectedHostKeySha256
+                ? { expectedHostKeySha256: params.expectedHostKeySha256 }
+                : {}),
+        };
+    }
+}
+//# sourceMappingURL=session.provider.js.map

package/dist/tools/session.provider.js.map

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

package/dist/tools/system.provider.d.ts

@@ -0,0 +1,18 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { MetricsCollector } from "../metrics.js";
+import type { SessionManager } from "../session.js";
+import type { ToolProvider } from "./types.js";
+export interface SystemToolProviderDeps {
+    sessionManager: SessionManager;
+    metrics: MetricsCollector;
+}
+export declare class SystemToolProvider implements ToolProvider {
+    private readonly deps;
+    readonly namespace = "system";
+    constructor(deps: SystemToolProviderDeps);
+    getTools(): Tool[];
+    handleTool(toolName: string, args: unknown): Promise<unknown> | undefined;
+    private detect;
+    private getMetrics;
+}
+//# sourceMappingURL=system.provider.d.ts.map

package/dist/tools/system.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.provider.d.ts","sourceRoot":"","sources":["../../src/tools/system.provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,qBAAa,kBAAmB,YAAW,YAAY;IAGzC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,SAAS,YAAY;gBAED,IAAI,EAAE,sBAAsB;IAEzD,QAAQ,IAAI,IAAI,EAAE;IA6ClB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS;YAW3D,MAAM;YAON,UAAU;CASzB"}

package/dist/tools/system.provider.js

@@ -0,0 +1,81 @@
+import { logger } from "../logging.js";
+import { MetricsFormatSchema, SessionIdSchema } from "../types.js";
+import { annotate } from "./metadata.js";
+import { METRICS_OUTPUT_SCHEMA, OS_INFO_OUTPUT_SCHEMA } from "./output-schemas.js";
+import { toolResult } from "./results.js";
+export class SystemToolProvider {
+    deps;
+    namespace = "system";
+    constructor(deps) {
+        this.deps = deps;
+    }
+    getTools() {
+        return [
+            {
+                name: "os_detect",
+                description: "Detects operating system and environment information",
+                annotations: annotate({
+                    title: "Detect Remote OS",
+                    readOnly: true,
+                    idempotent: true,
+                }),
+                outputSchema: OS_INFO_OUTPUT_SCHEMA,
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        sessionId: { type: "string", description: "SSH session ID" },
+                    },
+                    required: ["sessionId"],
+                },
+            },
+            {
+                name: "get_metrics",
+                description: "Returns server metrics including session counts, command statistics, and uptime",
+                annotations: annotate({
+                    title: "Get Runtime Metrics",
+                    readOnly: true,
+                    idempotent: true,
+                    openWorld: false,
+                }),
+                outputSchema: METRICS_OUTPUT_SCHEMA,
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        format: {
+                            type: "string",
+                            enum: ["json", "prometheus"],
+                            description: "Output format (default: json)",
+                        },
+                    },
+                    required: [],
+                },
+            },
+        ];
+    }
+    handleTool(toolName, args) {
+        switch (toolName) {
+            case "os_detect":
+                return this.detect(args);
+            case "get_metrics":
+                return this.getMetrics(args);
+            default:
+                return undefined;
+        }
+    }
+    async detect(args) {
+        const { sessionId } = SessionIdSchema.parse(args);
+        const result = await this.deps.sessionManager.getOSInfo(sessionId);
+        logger.info("OS detected", { sessionId });
+        return result;
+    }
+    async getMetrics(args) {
+        const { format } = MetricsFormatSchema.parse(args ?? {});
+        if (format === "prometheus") {
+            const metrics = this.deps.metrics.exportPrometheus();
+            return toolResult({ format: "prometheus", metrics }, metrics);
+        }
+        logger.debug("Metrics retrieved");
+        return this.deps.metrics.getMetrics();
+    }
+}
+//# sourceMappingURL=system.provider.js.map

package/dist/tools/system.provider.js.map

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