@jait/gateway 0.1.0

package/dist/tools/mcp-bridge.js

@@ -0,0 +1,166 @@
+/**
+ * MCP Tool Bridge — connects external MCP tool servers to Jait's registry.
+ *
+ * MCP (Model Context Protocol) lets users bring their own tool servers.
+ * This bridge:
+ *  1. Connects to an MCP server via stdio or HTTP/SSE transport
+ *  2. Discovers its tools via `tools/list`
+ *  3. Wraps each tool as a ToolDefinition and registers it
+ *  4. Proxies tool execution via `tools/call`
+ *
+ * All MCP tools get tier: "external", category: "external", source: "mcp".
+ *
+ * Scaffold — transport & full MCP protocol will be implemented when
+ * the MCP SDK is integrated. For now this provides the type contracts
+ * and registration flow.
+ */
+/**
+ * Connect to an MCP server and discover its tools.
+ *
+ * TODO: Implement actual MCP protocol transport. For now this is a
+ * scaffold that documents the expected flow and types.
+ */
+export async function connectMcpServer(_config) {
+    // Scaffold — real implementation will use @modelcontextprotocol/sdk
+    return {
+        serverId: _config.id,
+        serverName: _config.name,
+        status: "disconnected",
+        tools: [],
+        error: "MCP transport not yet implemented — scaffold only",
+    };
+}
+/**
+ * Call a tool on an MCP server.
+ *
+ * TODO: Implement actual MCP tools/call. For now returns an error
+ * indicating the scaffold state.
+ */
+export async function callMcpTool(_serverId, _toolName, _args) {
+    return {
+        ok: false,
+        message: `MCP tool execution not yet implemented (server: ${_serverId}, tool: ${_toolName})`,
+    };
+}
+// ── Register MCP tools into ToolRegistry ─────────────────────────────
+/**
+ * Wraps an MCP tool descriptor as a Jait ToolDefinition and registers it.
+ *
+ * The tool name is prefixed with the server id to avoid collisions:
+ *   e.g. "github:create_issue" → registered as "mcp.github.create_issue"
+ */
+export function wrapMcpTool(serverId, descriptor) {
+    const jaitName = `mcp.${serverId}.${descriptor.name}`;
+    return {
+        name: jaitName,
+        description: `[MCP: ${serverId}] ${descriptor.description}`,
+        parameters: descriptor.inputSchema,
+        tier: "external",
+        category: "external",
+        source: "mcp",
+        async execute(input, _context) {
+            return callMcpTool(serverId, descriptor.name, input);
+        },
+    };
+}
+/**
+ * Register all tools from an MCP server connection into a ToolRegistry.
+ * Returns the number of tools registered.
+ */
+export function registerMcpTools(registry, connection) {
+    let count = 0;
+    for (const descriptor of connection.tools) {
+        const tool = wrapMcpTool(connection.serverId, descriptor);
+        registry.register(tool);
+        count++;
+    }
+    return count;
+}
+/**
+ * Unregister all MCP tools from a specific server.
+ */
+export function unregisterMcpTools(registry, serverId) {
+    const prefix = `mcp.${serverId}.`;
+    const toRemove = registry.listNames().filter((n) => n.startsWith(prefix));
+    for (const _name of toRemove) {
+        // ToolRegistry doesn't have unregister yet — we'll need to add it
+        // For now, tools from disconnected servers will return errors on execute
+    }
+    return toRemove.length;
+}
+// ── MCP server manager ───────────────────────────────────────────────
+/**
+ * Manages multiple MCP server connections.
+ * Tracks connection state, provides reconnection, and manages tool lifecycle.
+ */
+export class McpManager {
+    registry;
+    connections = new Map();
+    configs = new Map();
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /** Add an MCP server configuration */
+    addServer(config) {
+        this.configs.set(config.id, config);
+    }
+    /** Remove an MCP server */
+    removeServer(serverId) {
+        this.disconnect(serverId);
+        this.configs.delete(serverId);
+    }
+    /** Connect to a specific server and register its tools */
+    async connect(serverId) {
+        const config = this.configs.get(serverId);
+        if (!config) {
+            return {
+                serverId,
+                serverName: serverId,
+                status: "error",
+                tools: [],
+                error: `No config found for MCP server '${serverId}'`,
+            };
+        }
+        const connection = await connectMcpServer(config);
+        this.connections.set(serverId, connection);
+        if (connection.status === "connected") {
+            registerMcpTools(this.registry, connection);
+        }
+        return connection;
+    }
+    /** Disconnect from a specific server */
+    disconnect(serverId) {
+        unregisterMcpTools(this.registry, serverId);
+        this.connections.delete(serverId);
+    }
+    /** Connect to all configured servers */
+    async connectAll() {
+        const results = [];
+        for (const config of this.configs.values()) {
+            if (config.enabled !== false) {
+                results.push(await this.connect(config.id));
+            }
+        }
+        return results;
+    }
+    /** Get connection status for all servers */
+    getStatus() {
+        const out = [];
+        for (const config of this.configs.values()) {
+            const conn = this.connections.get(config.id);
+            out.push({
+                id: config.id,
+                name: config.name,
+                status: conn?.status ?? "disconnected",
+                toolCount: conn?.tools.length ?? 0,
+                error: conn?.error,
+            });
+        }
+        return out;
+    }
+    /** Get all server configs */
+    getConfigs() {
+        return [...this.configs.values()];
+    }
+}
+//# sourceMappingURL=mcp-bridge.js.map

package/dist/tools/mcp-bridge.js.map

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

package/dist/tools/memory-tools.d.ts

@@ -0,0 +1,19 @@
+import type { MemoryService, MemoryScope } from "../memory/contracts.js";
+import type { ToolDefinition } from "./contracts.js";
+export declare function createMemorySaveTool(memory: MemoryService): ToolDefinition<{
+    scope: MemoryScope;
+    content: string;
+    sourceType: string;
+    sourceId: string;
+    sourceSurface: string;
+    ttlSeconds?: number;
+}>;
+export declare function createMemorySearchTool(memory: MemoryService): ToolDefinition<{
+    query: string;
+    limit?: number;
+    scope?: MemoryScope;
+}>;
+export declare function createMemoryForgetTool(memory: MemoryService): ToolDefinition<{
+    id: string;
+}>;
+//# sourceMappingURL=memory-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../../src/tools/memory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAAC;IAC1E,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,CAmCD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC,CAqBpI;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB5F"}

package/dist/tools/memory-tools.js

@@ -0,0 +1,78 @@
+export function createMemorySaveTool(memory) {
+    return {
+        name: "memory.save",
+        description: "Save a memory entry for later retrieval.",
+        tier: "standard",
+        category: "memory",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                scope: { type: "string", enum: ["workspace", "project", "contact"] },
+                content: { type: "string" },
+                sourceType: { type: "string" },
+                sourceId: { type: "string" },
+                sourceSurface: { type: "string" },
+                ttlSeconds: { type: "number" },
+            },
+            required: ["scope", "content", "sourceType", "sourceId", "sourceSurface"],
+        },
+        async execute(input) {
+            const expiresAt = input.ttlSeconds ? new Date(Date.now() + input.ttlSeconds * 1000).toISOString() : undefined;
+            const entry = await memory.save({
+                scope: input.scope,
+                content: input.content,
+                source: {
+                    type: input.sourceType,
+                    id: input.sourceId,
+                    surface: input.sourceSurface,
+                },
+                expiresAt,
+            });
+            return { ok: true, message: `Saved memory ${entry.id}`, data: entry };
+        },
+    };
+}
+export function createMemorySearchTool(memory) {
+    return {
+        name: "memory.search",
+        description: "Search saved memories using semantic similarity.",
+        tier: "standard",
+        category: "memory",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                query: { type: "string" },
+                limit: { type: "number" },
+                scope: { type: "string", enum: ["workspace", "project", "contact"] },
+            },
+            required: ["query"],
+        },
+        async execute(input) {
+            const results = await memory.search(input.query, input.limit ?? 5, input.scope);
+            return { ok: true, message: `Found ${results.length} memories`, data: results };
+        },
+    };
+}
+export function createMemoryForgetTool(memory) {
+    return {
+        name: "memory.forget",
+        description: "Forget a memory by ID.",
+        tier: "standard",
+        category: "memory",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+            },
+            required: ["id"],
+        },
+        async execute(input) {
+            const removed = await memory.forget(input.id);
+            return { ok: removed, message: removed ? `Forgot memory ${input.id}` : `Memory ${input.id} not found` };
+        },
+    };
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/tools/memory-tools.js.map

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

package/dist/tools/meta-tools.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Meta-tools — tools.search and tools.list
+ *
+ * These are "discovery" tools that let the LLM find and load tool schemas
+ * on demand, rather than sending all 40+ schemas in every request.
+ *
+ * tools.list  — Returns a brief catalogue of all available tools grouped by
+ *               category, with tier badges. Lightweight (names + one-liners).
+ * tools.search — Searches tools by keyword and returns FULL schemas so the
+ *                LLM can use them in subsequent rounds.
+ *
+ * Both are tier: "core" so they're always available.
+ */
+import type { ToolDefinition } from "./contracts.js";
+import type { ToolRegistry } from "./registry.js";
+interface ToolsListInput {
+    category?: string;
+}
+export declare function createToolsListTool(registry: ToolRegistry): ToolDefinition<ToolsListInput>;
+interface ToolsSearchInput {
+    query: string;
+}
+export declare function createToolsSearchTool(registry: ToolRegistry): ToolDefinition<ToolsSearchInput>;
+export {};
+//# sourceMappingURL=meta-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-tools.d.ts","sourceRoot":"","sources":["../../src/tools/meta-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,CAAC,cAAc,CAAC,CAuE1F;AAID,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,CAAC,gBAAgB,CAAC,CA+C9F"}

package/dist/tools/meta-tools.js

@@ -0,0 +1,125 @@
+/**
+ * Meta-tools — tools.search and tools.list
+ *
+ * These are "discovery" tools that let the LLM find and load tool schemas
+ * on demand, rather than sending all 40+ schemas in every request.
+ *
+ * tools.list  — Returns a brief catalogue of all available tools grouped by
+ *               category, with tier badges. Lightweight (names + one-liners).
+ * tools.search — Searches tools by keyword and returns FULL schemas so the
+ *                LLM can use them in subsequent rounds.
+ *
+ * Both are tier: "core" so they're always available.
+ */
+import { toOpenAIName } from "./agent-loop.js";
+export function createToolsListTool(registry) {
+    return {
+        name: "tools.list",
+        description: "List all available tools grouped by category. Use this to discover what tools exist before calling tools.search for full schemas. Optionally filter by category.",
+        parameters: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    description: "Optional category filter: terminal, filesystem, os, surfaces, scheduler, gateway, screen, browser, web, memory, voice, agent, meta, external",
+                    enum: [
+                        "terminal",
+                        "filesystem",
+                        "os",
+                        "surfaces",
+                        "scheduler",
+                        "gateway",
+                        "screen",
+                        "browser",
+                        "web",
+                        "memory",
+                        "voice",
+                        "agent",
+                        "meta",
+                        "external",
+                    ],
+                },
+            },
+            required: [],
+        },
+        tier: "core",
+        category: "meta",
+        source: "builtin",
+        async execute(input) {
+            let tools = registry.listInfo();
+            if (input.category) {
+                tools = tools.filter((t) => t.category === input.category);
+            }
+            // Group by category
+            const grouped = new Map();
+            for (const t of tools) {
+                const cat = t.category;
+                if (!grouped.has(cat))
+                    grouped.set(cat, []);
+                grouped.get(cat).push(t);
+            }
+            const lines = [];
+            for (const [cat, items] of grouped) {
+                lines.push(`## ${cat}`);
+                for (const t of items) {
+                    const tierBadge = t.tier === "core" ? " [core]" : t.tier === "external" ? " [external]" : "";
+                    lines.push(`- **${t.name}**${tierBadge}: ${t.description}`);
+                }
+                lines.push("");
+            }
+            return {
+                ok: true,
+                message: `Found ${tools.length} tool(s) across ${grouped.size} category/categories.`,
+                data: {
+                    total: tools.length,
+                    categories: [...grouped.keys()],
+                    catalogue: lines.join("\n"),
+                },
+            };
+        },
+    };
+}
+export function createToolsSearchTool(registry) {
+    return {
+        name: "tools.search",
+        description: "Search available tools by keyword and return their FULL schemas (name, description, parameters). Call this when you need a tool that isn\u2019t in your current set \u2014 e.g. browser, cron, memory, screen, voice, or any MCP tool.",
+        parameters: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search keyword(s). Matches against tool names, descriptions, and categories. Examples: 'browser', 'schedule cron', 'memory save', 'screenshot'.",
+                },
+            },
+            required: ["query"],
+        },
+        tier: "core",
+        category: "meta",
+        source: "builtin",
+        async execute(input) {
+            const results = registry.search(input.query);
+            if (results.length === 0) {
+                return {
+                    ok: true,
+                    message: `No tools found matching "${input.query}". Try broader keywords or use tools.list to see all available tools.`,
+                    data: { matches: [] },
+                };
+            }
+            // Return full schemas so the LLM can use them
+            const schemas = results.map((t) => ({
+                name: t.name,
+                openai_name: toOpenAIName(t.name),
+                description: t.description,
+                tier: t.tier ?? "standard",
+                category: t.category ?? "external",
+                parameters: t.parameters,
+            }));
+            return {
+                ok: true,
+                message: `Found ${results.length} tool(s) matching "${input.query}". You can now call these tools directly.`,
+                data: { matches: schemas },
+            };
+        },
+    };
+}
+//# sourceMappingURL=meta-tools.js.map

package/dist/tools/meta-tools.js.map

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

package/dist/tools/network-tools.d.ts

@@ -0,0 +1,21 @@
+import type { ToolDefinition } from "./contracts.js";
+export interface NetworkScanHost {
+    ip: string;
+    mac: string | null;
+    hostname: string | null;
+    alive: boolean;
+    openPorts: number[];
+    sshReachable: boolean;
+    agentStatus: "not-installed" | "installed" | "running" | "unreachable";
+    lastSeen: string;
+}
+export interface NetworkScanData {
+    subnet: string;
+    hosts: NetworkScanHost[];
+    scannedAt: string;
+    durationMs: number;
+}
+export declare function getLatestNetworkScan(): NetworkScanData | null;
+export declare function setLatestNetworkScan(data: NetworkScanData): void;
+export declare function createNetworkScanTool(): ToolDefinition;
+//# sourceMappingURL=network-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network-tools.d.ts","sourceRoot":"","sources":["../../src/tools/network-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,gBAAgB,CAAC;AAuEjE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,eAAe,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,oBAAoB,IAAI,eAAe,GAAG,IAAI,CAE7D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAEhE;AAMD,wBAAgB,qBAAqB,IAAI,cAAc,CAkItD"}

package/dist/tools/network-tools.js

@@ -0,0 +1,189 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { platform, networkInterfaces } from "node:os";
+import { createConnection } from "node:net";
+const execAsync = promisify(exec);
+// ---------------------------------------------------------------------------
+// Helpers (shared with routes/network.ts — extract later if needed)
+// ---------------------------------------------------------------------------
+function getLocalSubnets() {
+    const ifaces = networkInterfaces();
+    const subnets = [];
+    for (const entries of Object.values(ifaces)) {
+        if (!entries)
+            continue;
+        for (const entry of entries) {
+            if (entry.family === "IPv4" && !entry.internal) {
+                // Skip link-local / APIPA addresses (169.254.x.x)
+                if (entry.address.startsWith("169.254."))
+                    continue;
+                const parts = entry.address.split(".");
+                subnets.push(parts.slice(0, 3).join("."));
+            }
+        }
+    }
+    return [...new Set(subnets)];
+}
+function parseArpTable(output) {
+    const results = [];
+    const lineRegex = /(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})\s+(?:at\s+)?([0-9a-fA-F]{2}[:-][0-9a-fA-F]{2}[:-][0-9a-fA-F]{2}[:-][0-9a-fA-F]{2}[:-][0-9a-fA-F]{2}[:-][0-9a-fA-F]{2})/;
+    for (const line of output.split("\n")) {
+        const match = lineRegex.exec(line);
+        if (match) {
+            results.push({ ip: match[1], mac: match[2].replace(/-/g, ":").toLowerCase() });
+        }
+    }
+    return results;
+}
+function probePort(ip, port, timeoutMs = 2000) {
+    return new Promise((resolve) => {
+        const socket = createConnection({ host: ip, port, timeout: timeoutMs });
+        socket.once("connect", () => { socket.destroy(); resolve(true); });
+        socket.once("timeout", () => { socket.destroy(); resolve(false); });
+        socket.once("error", () => { socket.destroy(); resolve(false); });
+    });
+}
+async function reverseResolve(ip) {
+    try {
+        const cmd = platform() === "win32"
+            ? `nslookup ${ip} 2>nul`
+            : `host ${ip} 2>/dev/null || true`;
+        const { stdout } = await execAsync(cmd, { timeout: 3000 });
+        const winMatch = /Name:\s+(\S+)/i.exec(stdout);
+        if (winMatch)
+            return winMatch[1];
+        const linMatch = /pointer\s+(\S+)/i.exec(stdout);
+        if (linMatch)
+            return linMatch[1].replace(/\.$/, "");
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** In-memory cache of the latest scan result, populated by the tool/job */
+let latestScan = null;
+export function getLatestNetworkScan() {
+    return latestScan;
+}
+export function setLatestNetworkScan(data) {
+    latestScan = data;
+}
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+export function createNetworkScanTool() {
+    return {
+        name: "network.scan",
+        description: "Scan the local network using ARP + port probing. Discovers hosts, checks SSH (port 22), and detects running Jait gateway nodes. Returns a summary of discovered hosts.",
+        tier: "standard",
+        category: "network",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                subnet: {
+                    type: "string",
+                    description: 'Target subnet prefix (e.g. "192.168.1"). If omitted, auto-detects from local interfaces.',
+                },
+            },
+        },
+        execute: async (input) => {
+            const { subnet: targetSubnet } = (input ?? {});
+            const subnets = targetSubnet ? [targetSubnet] : getLocalSubnets();
+            if (subnets.length === 0) {
+                return { ok: false, message: "No active IPv4 subnets found" };
+            }
+            const start = Date.now();
+            // 1. Collect / refresh ARP table
+            let arpEntries = [];
+            try {
+                const { stdout } = await execAsync("arp -a", { timeout: 10000 });
+                arpEntries = parseArpTable(stdout);
+            }
+            catch {
+                // continue without ARP
+            }
+            // 2. Quick ping sweep for every detected subnet to populate ARP cache
+            try {
+                for (const subnet of subnets) {
+                    if (platform() === "win32") {
+                        const pingCmd = Array.from({ length: 254 }, (_, i) => `start /b ping -n 1 -w 500 ${subnet}.${i + 1} > nul 2>&1`).join(" & ");
+                        await execAsync(pingCmd, { timeout: 30000 }).catch(() => { });
+                    }
+                    else {
+                        const pingCmd = `for i in $(seq 1 254); do ping -c 1 -W 1 ${subnet}.$i & done; wait`;
+                        await execAsync(pingCmd, { timeout: 30000, shell: "/bin/bash" }).catch(() => { });
+                    }
+                }
+                // Re-read ARP table after all sweeps
+                const { stdout } = await execAsync("arp -a", { timeout: 10000 });
+                arpEntries = parseArpTable(stdout);
+            }
+            catch {
+                // use existing ARP entries
+            }
+            // 3. Filter to subnet
+            const subnetFiltered = arpEntries.filter((e) => subnets.some((s) => e.ip.startsWith(s + ".")));
+            // 4. Probe ports in parallel
+            const PROBE_PORTS = [22, 80, 443, 8000, 8080];
+            const hosts = await Promise.all(subnetFiltered.map(async (entry) => {
+                const portResults = await Promise.all(PROBE_PORTS.map(async (port) => ({
+                    port,
+                    open: await probePort(entry.ip, port, 1500),
+                })));
+                const openPorts = portResults.filter((p) => p.open).map((p) => p.port);
+                const sshReachable = openPorts.includes(22);
+                const hostname = await reverseResolve(entry.ip);
+                let agentStatus = "not-installed";
+                if (openPorts.includes(8000)) {
+                    try {
+                        const res = await fetch(`http://${entry.ip}:8000/health`, {
+                            signal: AbortSignal.timeout(2000),
+                        });
+                        if (res.ok) {
+                            const health = (await res.json());
+                            if (health.name === "jait-gateway")
+                                agentStatus = "running";
+                        }
+                    }
+                    catch {
+                        agentStatus = "not-installed";
+                    }
+                }
+                return {
+                    ip: entry.ip,
+                    mac: entry.mac,
+                    hostname,
+                    alive: true,
+                    openPorts,
+                    sshReachable,
+                    agentStatus,
+                    lastSeen: new Date().toISOString(),
+                };
+            }));
+            // Sort by IP
+            hosts.sort((a, b) => {
+                const aNum = a.ip.split(".").map(Number).reduce((sum, n) => sum * 256 + n, 0);
+                const bNum = b.ip.split(".").map(Number).reduce((sum, n) => sum * 256 + n, 0);
+                return aNum - bNum;
+            });
+            const result = {
+                subnet: subnets.map(s => s + ".0/24").join(", "),
+                hosts,
+                scannedAt: new Date().toISOString(),
+                durationMs: Date.now() - start,
+            };
+            // Cache for the UI network panel
+            latestScan = result;
+            const gatewayCount = hosts.filter((h) => h.agentStatus === "running").length;
+            const sshCount = hosts.filter((h) => h.sshReachable).length;
+            return {
+                ok: true,
+                message: `Network scan complete: ${hosts.length} hosts found (${sshCount} with SSH, ${gatewayCount} running Jait Gateway)`,
+                data: result,
+            };
+        },
+    };
+}
+//# sourceMappingURL=network-tools.js.map