@pentoshi/clai 0.8.2 → 0.9.2

package/dist/tools/jobs.js

@@ -0,0 +1,161 @@
+import { spawn } from "node:child_process";
+import { createWriteStream } from "node:fs";
+import { readFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { randomUUID } from "node:crypto";
+export class JobManager {
+    jobs = new Map();
+    processes = new Map();
+    streams = new Map();
+    async startJob(command, options) {
+        const id = randomUUID().slice(0, 8);
+        const cwd = options?.cwd ?? process.cwd();
+        const dir = join(homedir(), ".clai", "jobs");
+        await mkdir(dir, { recursive: true });
+        const artifactPath = join(dir, `${new Date().toISOString().replace(/[:.]/g, "-")}-${id}.txt`);
+        const stream = createWriteStream(artifactPath, { flags: "w" });
+        stream.write(`$ ${command}\n\n`);
+        try {
+            const detached = process.platform !== "win32";
+            const child = spawn(command, {
+                cwd,
+                detached,
+                shell: true,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            const job = {
+                id,
+                command,
+                cwd,
+                pid: child.pid,
+                status: "running",
+                startedAt: new Date().toISOString(),
+                artifactPath,
+            };
+            this.jobs.set(id, job);
+            this.processes.set(id, child);
+            this.streams.set(id, stream);
+            child.stdout?.on("data", (chunk) => {
+                stream.write(chunk);
+            });
+            child.stderr?.on("data", (chunk) => {
+                stream.write(chunk);
+            });
+            child.on("close", (code) => {
+                job.status = "exited";
+                job.exitCode = code ?? undefined;
+                job.endedAt = new Date().toISOString();
+                stream.end();
+                this.processes.delete(id);
+                this.streams.delete(id);
+            });
+            child.on("error", () => {
+                job.status = "failed";
+                job.endedAt = new Date().toISOString();
+                stream.end();
+                this.processes.delete(id);
+                this.streams.delete(id);
+            });
+            // Detach so the child outlives the parent if needed
+            child.unref();
+            return {
+                ok: true,
+                output: `Background job started: id=${id} pid=${child.pid ?? "?"}\nCommand: ${command}\nOutput: ${artifactPath}`,
+            };
+        }
+        catch (error) {
+            stream.end();
+            return {
+                ok: false,
+                output: `Failed to start job: ${error instanceof Error ? error.message : String(error)}`,
+                exitCode: 1,
+            };
+        }
+    }
+    listJobs() {
+        if (this.jobs.size === 0) {
+            return { ok: true, output: "No background jobs." };
+        }
+        const lines = [];
+        for (const job of this.jobs.values()) {
+            const status = job.status === "running" ? "▶ running" : `${job.status} (exit=${job.exitCode ?? "?"})`;
+            const elapsed = job.endedAt
+                ? `${Math.round((new Date(job.endedAt).getTime() - new Date(job.startedAt).getTime()) / 1000)}s`
+                : `${Math.round((Date.now() - new Date(job.startedAt).getTime()) / 1000)}s ago`;
+            lines.push(`[${job.id}] ${status} ${elapsed}  ${job.command.slice(0, 60)}`);
+        }
+        return { ok: true, output: lines.join("\n") };
+    }
+    getJob(id) {
+        return this.jobs.get(id);
+    }
+    async tailJob(id, bytes) {
+        const job = this.jobs.get(id);
+        if (!job) {
+            return { ok: false, output: `Job "${id}" not found.`, exitCode: 1 };
+        }
+        const tailBytes = bytes ?? 8_000;
+        try {
+            const content = await readFile(job.artifactPath, "utf8");
+            const tail = content.length > tailBytes
+                ? `... (showing last ${tailBytes.toLocaleString()} bytes)\n${content.slice(-tailBytes)}`
+                : content;
+            return {
+                ok: true,
+                output: `[${job.id}] ${job.status}:\n${tail}`,
+                outputPath: job.artifactPath,
+            };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                output: `Failed to read job output: ${error instanceof Error ? error.message : String(error)}`,
+                exitCode: 1,
+            };
+        }
+    }
+    stopJob(id, signal) {
+        const job = this.jobs.get(id);
+        if (!job) {
+            return { ok: false, output: `Job "${id}" not found.`, exitCode: 1 };
+        }
+        if (job.status !== "running") {
+            return {
+                ok: false,
+                output: `Job "${id}" is already ${job.status}.`,
+                exitCode: 1,
+            };
+        }
+        const child = this.processes.get(id);
+        if (!child?.pid) {
+            job.status = "killed";
+            job.endedAt = new Date().toISOString();
+            return { ok: true, output: `Job "${id}" marked as killed (no pid).` };
+        }
+        try {
+            const sig = signal ?? "SIGTERM";
+            if (process.platform !== "win32") {
+                process.kill(-child.pid, sig);
+            }
+            else {
+                child.kill(sig);
+            }
+            job.status = "killed";
+            job.endedAt = new Date().toISOString();
+            return { ok: true, output: `Job "${id}" sent ${sig}.` };
+        }
+        catch {
+            return {
+                ok: false,
+                output: `Failed to stop job "${id}".`,
+                exitCode: 1,
+            };
+        }
+    }
+    getRunningJobs() {
+        return [...this.jobs.values()].filter((j) => j.status === "running");
+    }
+}
+export const jobManager = new JobManager();
+//# sourceMappingURL=jobs.js.map

package/dist/tools/jobs.js.map

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

package/dist/tools/net-ping-sweep.d.ts

@@ -0,0 +1,24 @@
+import type { ToolResult } from "../types.js";
+export interface PingSweepArgs {
+    target: string;
+    method?: "auto" | "nmap" | "arp" | "native" | undefined;
+    timeoutMs?: number | undefined;
+}
+export interface ActiveDevice {
+    ip: string;
+    hostname?: string | undefined;
+    mac?: string | undefined;
+    vendor?: string | undefined;
+    source: "nmap" | "arp-scan" | "arp" | "ip-neigh";
+}
+/**
+ * Parse nmap -sn output to extract active devices.
+ * Exported for testing.
+ */
+export declare function parseNmapPingSweep(output: string): ActiveDevice[];
+/**
+ * Parse arp -a output to extract devices from the ARP table.
+ * Exported for testing.
+ */
+export declare function parseArpTable(output: string): ActiveDevice[];
+export declare function pingSweep(args: PingSweepArgs): Promise<ToolResult>;

package/dist/tools/net-ping-sweep.js

@@ -0,0 +1,205 @@
+import { spawn } from "node:child_process";
+import { execSync } from "node:child_process";
+import { platform } from "node:os";
+const PRIVATE_CIDR_RE = /^(?:10\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.(?:1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3}|169\.254\.\d{1,3}\.\d{1,3})(?:\/\d{1,2})?$/;
+function isPrivateCidr(target) {
+    return PRIVATE_CIDR_RE.test(target);
+}
+function commandAvailable(command) {
+    try {
+        const cmd = platform() === "win32" ? `where.exe ${command}` : `command -v ${command}`;
+        execSync(cmd, { timeout: 3_000, stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function runCommand(command, argv, timeoutMs) {
+    return new Promise((resolve) => {
+        const child = spawn(command, argv, {
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        let killed = false;
+        const timeout = setTimeout(() => {
+            killed = true;
+            child.kill("SIGTERM");
+        }, timeoutMs);
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", () => {
+            clearTimeout(timeout);
+            resolve({ ok: false, stdout, stderr, exitCode: 1 });
+        });
+        child.on("close", (code) => {
+            clearTimeout(timeout);
+            resolve({
+                ok: !killed && code === 0,
+                stdout,
+                stderr,
+                exitCode: killed ? 124 : code,
+            });
+        });
+    });
+}
+/**
+ * Parse nmap -sn output to extract active devices.
+ * Exported for testing.
+ */
+export function parseNmapPingSweep(output) {
+    const devices = [];
+    const blocks = output.split(/(?=Nmap scan report for )/);
+    for (const block of blocks) {
+        const hostMatch = /Nmap scan report for\s+(?:(\S+)\s+\()?(\d+\.\d+\.\d+\.\d+)\)?/i.exec(block);
+        if (!hostMatch)
+            continue;
+        const ip = hostMatch[2];
+        const hostname = hostMatch[1] || undefined;
+        if (!/Host is up/i.test(block))
+            continue;
+        const macMatch = /MAC Address:\s+([0-9A-Fa-f:]+)(?:\s+\(([^)]+)\))?/i.exec(block);
+        devices.push({
+            ip,
+            hostname,
+            mac: macMatch?.[1],
+            vendor: macMatch?.[2],
+            source: "nmap",
+        });
+    }
+    return devices;
+}
+/**
+ * Parse arp -a output to extract devices from the ARP table.
+ * Exported for testing.
+ */
+export function parseArpTable(output) {
+    const devices = [];
+    const lines = output.split("\n");
+    for (const line of lines) {
+        // macOS: ? (192.168.1.1) at aa:bb:cc:dd:ee:ff on en0 [ethernet]
+        // Linux: ? (192.168.1.1) at aa:bb:cc:dd:ee:ff [ether] on eth0
+        const match = /\((\d+\.\d+\.\d+\.\d+)\)\s+at\s+([0-9a-fA-F:]+)/i.exec(line);
+        if (match && match[2] !== "(incomplete)") {
+            devices.push({
+                ip: match[1],
+                mac: match[2],
+                source: "arp",
+            });
+        }
+    }
+    return devices;
+}
+function parseArpScanOutput(output) {
+    const devices = [];
+    const lines = output.split("\n");
+    for (const line of lines) {
+        // 192.168.1.1	aa:bb:cc:dd:ee:ff	Vendor Corp
+        const match = /^(\d+\.\d+\.\d+\.\d+)\s+([0-9a-fA-F:]+)\s*(.*)/i.exec(line);
+        if (match) {
+            devices.push({
+                ip: match[1],
+                mac: match[2],
+                vendor: match[3]?.trim() || undefined,
+                source: "arp-scan",
+            });
+        }
+    }
+    return devices;
+}
+function parseIpNeigh(output) {
+    const devices = [];
+    const lines = output.split("\n");
+    for (const line of lines) {
+        // 192.168.1.1 dev eth0 lladdr aa:bb:cc:dd:ee:ff REACHABLE
+        const match = /^(\d+\.\d+\.\d+\.\d+)\s+.*?lladdr\s+([0-9a-fA-F:]+)/i.exec(line);
+        if (match) {
+            devices.push({
+                ip: match[1],
+                mac: match[2],
+                source: "ip-neigh",
+            });
+        }
+    }
+    return devices;
+}
+function formatDevices(devices) {
+    if (devices.length === 0)
+        return "No active devices found.";
+    const lines = [`Found ${devices.length} active device(s):\n`];
+    for (const dev of devices) {
+        const parts = [dev.ip];
+        if (dev.hostname)
+            parts.push(`(${dev.hostname})`);
+        if (dev.mac)
+            parts.push(`MAC: ${dev.mac}`);
+        if (dev.vendor)
+            parts.push(`[${dev.vendor}]`);
+        lines.push(`  ${parts.join("  ")}`);
+    }
+    return lines.join("\n");
+}
+export async function pingSweep(args) {
+    const target = args.target.trim();
+    const timeoutMs = args.timeoutMs ?? 120_000;
+    const method = args.method ?? "auto";
+    if (!isPrivateCidr(target)) {
+        return {
+            ok: false,
+            output: `net.pingSweep is restricted to local/private networks. Target "${target}" does not appear to be a private CIDR. Use net.scan for individual host scanning.`,
+            exitCode: 1,
+        };
+    }
+    // Method selection
+    if (method === "nmap" || (method === "auto" && commandAvailable("nmap"))) {
+        const result = await runCommand("nmap", ["-sn", target], timeoutMs);
+        const devices = parseNmapPingSweep(result.stdout);
+        return {
+            ok: result.ok,
+            output: formatDevices(devices) + (result.ok ? "" : `\n\nStderr: ${result.stderr}`),
+        };
+    }
+    if (method === "arp" || method === "auto") {
+        // Try arp-scan first (gives richer data)
+        if (commandAvailable("arp-scan")) {
+            const result = await runCommand("arp-scan", ["--localnet"], timeoutMs);
+            const devices = parseArpScanOutput(result.stdout);
+            if (devices.length > 0) {
+                return {
+                    ok: true,
+                    output: formatDevices(devices),
+                };
+            }
+        }
+        // Linux: try ip neigh
+        if (platform() === "linux" && commandAvailable("ip")) {
+            const result = await runCommand("ip", ["neigh", "show"], timeoutMs);
+            const devices = parseIpNeigh(result.stdout);
+            return {
+                ok: true,
+                output: formatDevices(devices) +
+                    "\n\nNote: ARP cache only shows recently-seen devices. For comprehensive discovery, install nmap: `pkg.install nmap`",
+            };
+        }
+        // Fallback: arp -a (available everywhere)
+        const result = await runCommand("arp", ["-a"], timeoutMs);
+        const devices = parseArpTable(result.stdout);
+        return {
+            ok: true,
+            output: formatDevices(devices) +
+                "\n\nNote: ARP cache only shows recently-seen devices. For comprehensive discovery, install nmap: `pkg.install nmap`",
+        };
+    }
+    return {
+        ok: false,
+        output: `No suitable method for ping sweep. Install nmap for best results: pkg.install nmap`,
+        exitCode: 1,
+    };
+}
+//# sourceMappingURL=net-ping-sweep.js.map

package/dist/tools/net-ping-sweep.js.map

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

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

@@ -0,0 +1,26 @@
+import type { ToolResult } from "../types.js";
+export interface NetworkInterfaceInfo {
+    name: string;
+    address: string;
+    family: "IPv4" | "IPv6";
+    netmask?: string | undefined;
+    cidr?: string | undefined;
+    mac?: string | undefined;
+    internal: boolean;
+    defaultRoute?: boolean | undefined;
+    gateway?: string | undefined;
+}
+export interface NetworkContextResult {
+    hostname: string;
+    platform: NodeJS.Platform;
+    interfaces: NetworkInterfaceInfo[];
+    candidates: NetworkInterfaceInfo[];
+    selected?: NetworkInterfaceInfo | undefined;
+    warnings?: string[] | undefined;
+}
+/**
+ * Convert a dotted-quad IPv4 netmask (e.g. "255.255.255.0") to CIDR prefix
+ * length (e.g. 24). Returns undefined if the mask is not valid.
+ */
+export declare function netmaskToCidr(netmask: string): number | undefined;
+export declare function getNetworkContext(): Promise<ToolResult>;

package/dist/tools/network-context.js

@@ -0,0 +1,138 @@
+import { networkInterfaces, hostname, platform } from "node:os";
+import { execSync } from "node:child_process";
+/**
+ * Convert a dotted-quad IPv4 netmask (e.g. "255.255.255.0") to CIDR prefix
+ * length (e.g. 24). Returns undefined if the mask is not valid.
+ */
+export function netmaskToCidr(netmask) {
+    const parts = netmask.split(".");
+    if (parts.length !== 4)
+        return undefined;
+    let bits = 0;
+    for (const part of parts) {
+        const n = Number(part);
+        if (Number.isNaN(n) || n < 0 || n > 255)
+            return undefined;
+        bits += n.toString(2).split("1").length - 1;
+    }
+    return bits;
+}
+function isPrivateV4(address) {
+    const parts = address.split(".").map(Number);
+    const [a, b] = parts;
+    if (a === 10)
+        return true;
+    if (a === 172 && b !== undefined && b >= 16 && b <= 31)
+        return true;
+    if (a === 192 && b === 168)
+        return true;
+    if (a === 169 && b === 254)
+        return true;
+    return false;
+}
+function detectGateway() {
+    const os = platform();
+    try {
+        if (os === "darwin") {
+            const out = execSync("route -n get default 2>/dev/null", {
+                timeout: 5_000,
+                encoding: "utf8",
+            });
+            const match = /gateway:\s+(\S+)/i.exec(out);
+            return match?.[1];
+        }
+        if (os === "linux") {
+            const out = execSync("ip route show default 2>/dev/null", {
+                timeout: 5_000,
+                encoding: "utf8",
+            });
+            const match = /via\s+(\S+)/i.exec(out);
+            return match?.[1];
+        }
+        if (os === "win32") {
+            const out = execSync('powershell -Command "(Get-NetRoute -DestinationPrefix 0.0.0.0/0 | Select-Object -First 1).NextHop"', { timeout: 5_000, encoding: "utf8" });
+            const trimmed = out.trim();
+            return trimmed || undefined;
+        }
+    }
+    catch {
+        // gateway detection failed — non-fatal
+    }
+    return undefined;
+}
+function sameSubnet(addr, gateway, prefix) {
+    const toBits = (ip) => {
+        const parts = ip.split(".").map(Number);
+        return ((parts[0] << 24) | (parts[1] << 16) | (parts[2] << 8) | parts[3]) >>> 0;
+    };
+    const mask = prefix === 0 ? 0 : (~0 << (32 - prefix)) >>> 0;
+    return (toBits(addr) & mask) === (toBits(gateway) & mask);
+}
+export async function getNetworkContext() {
+    const ifaces = networkInterfaces();
+    const all = [];
+    const warnings = [];
+    const gateway = detectGateway();
+    for (const [name, addrs] of Object.entries(ifaces)) {
+        if (!addrs)
+            continue;
+        for (const addr of addrs) {
+            all.push({
+                name,
+                address: addr.address,
+                family: addr.family,
+                netmask: addr.netmask,
+                cidr: addr.cidr ?? undefined,
+                mac: addr.mac,
+                internal: addr.internal,
+            });
+        }
+    }
+    // Filter to active private IPv4 interfaces
+    const candidates = all.filter((iface) => iface.family === "IPv4" &&
+        !iface.internal &&
+        isPrivateV4(iface.address));
+    let selected;
+    if (gateway && candidates.length > 0) {
+        // Find the interface whose subnet contains the gateway
+        for (const candidate of candidates) {
+            const prefix = candidate.netmask
+                ? netmaskToCidr(candidate.netmask)
+                : undefined;
+            if (prefix !== undefined && sameSubnet(candidate.address, gateway, prefix)) {
+                selected = {
+                    ...candidate,
+                    defaultRoute: true,
+                    gateway,
+                };
+                break;
+            }
+        }
+        // If no subnet match, just take the first candidate
+        if (!selected && candidates.length > 0) {
+            selected = { ...candidates[0], gateway };
+        }
+    }
+    else if (candidates.length === 1) {
+        selected = candidates[0];
+    }
+    else if (candidates.length > 1) {
+        warnings.push(`Multiple network interfaces found (${candidates.map((c) => `${c.name}:${c.address}`).join(", ")}). Could not determine default route.`);
+    }
+    else {
+        warnings.push("No active private IPv4 interfaces detected.");
+    }
+    const result = {
+        hostname: hostname(),
+        platform: platform(),
+        interfaces: all,
+        candidates,
+        selected,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+    return {
+        ok: candidates.length > 0,
+        output: JSON.stringify(result, null, 2),
+    };
+}
+//# sourceMappingURL=network-context.js.map

package/dist/tools/network-context.js.map

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

package/dist/tools/registry.js

@@ -1,11 +1,15 @@
 import { detectSystem } from "../os/detect.js";
 import { detectPackageManager, assertSafePackageName } from "../os/pkgmgr.js";
-import { fsList, fsRead, fsSearch, fsWrite } from "./fs.js";
+import { fsEdit, fsDelete, fsList, fsRead, fsSearch, fsWrite } from "./fs.js";
 import { httpFetch } from "./http.js";
 import { shellExec, spawnArgv } from "./shell.js";
 import { classifyToolCall } from "../safety/classifier.js";
 import { loadScope } from "../store/scope.js";
 import { parseHost, parsePortSpec, parseLegacyFlags, profileToNmapArgs, } from "./validate.js";
+import { getNetworkContext } from "./network-context.js";
+import { pingSweep } from "./net-ping-sweep.js";
+import { toolCheckHandler } from "./capabilities.js";
+import { jobManager } from "./jobs.js";
 function requireString(args, key) {
     const value = args[key];
     if (typeof value !== "string" || value.length === 0) {
@@ -74,7 +78,11 @@ export const toolRegistry = {
             ? args.profile
             : undefined;
         const legacyFlags = optionalString(args, "flags");
-        const profileArgs = profileToNmapArgs(profile);
+        // ports and topPorts conflict on the nmap CLI — ports takes priority
+        const cleanedProfile = ports && profile?.topPorts
+            ? { ...profile, topPorts: undefined }
+            : profile;
+        const profileArgs = profileToNmapArgs(cleanedProfile);
         const legacyArgs = legacyFlags ? parseLegacyFlags(legacyFlags) : [];
         const argv = [];
         if (ports)
@@ -232,6 +240,42 @@ export const toolRegistry = {
     async "tool.batch"(args, options) {
         return runToolBatch(args, options);
     },
+    async "net.context"() {
+        return getNetworkContext();
+    },
+    async "net.pingSweep"(args) {
+        const target = requireString(args, "target");
+        return pingSweep({
+            target,
+            method: optionalString(args, "method"),
+            timeoutMs: optionalNumber(args, "timeoutMs"),
+        });
+    },
+    async "tool.check"(args) {
+        return toolCheckHandler(args);
+    },
+    async "shell.start"(args) {
+        const command = requireString(args, "command");
+        return jobManager.startJob(command, {
+            cwd: optionalString(args, "cwd"),
+            name: optionalString(args, "name"),
+        });
+    },
+    async "shell.jobs"() {
+        return jobManager.listJobs();
+    },
+    async "shell.tail"(args) {
+        return jobManager.tailJob(requireString(args, "id"), optionalNumber(args, "bytes"));
+    },
+    async "shell.stop"(args) {
+        return jobManager.stopJob(requireString(args, "id"));
+    },
+    async "fs.edit"(args) {
+        return fsEdit(requireString(args, "path"), requireString(args, "oldText"), requireString(args, "newText"), optionalNumber(args, "expectedReplacements"));
+    },
+    async "fs.delete"(args) {
+        return fsDelete(requireString(args, "path"), typeof args.recursive === "boolean" ? args.recursive : undefined);
+    },
 };
 export function availableToolNames() {
     return Object.keys(toolRegistry);
@@ -258,6 +302,8 @@ const BATCH_SAFE_TOOLS = new Set([
     "sysinfo",
     "dns.lookup",
     "whois.lookup",
+    "net.context",
+    "tool.check",
 ]);
 const BATCH_MAX_CALLS = 8;
 const BATCH_DEFAULT_CONCURRENCY = 3;