@pentoshi/clai 0.6.0 → 0.7.1

package/dist/tools/validate.js

@@ -0,0 +1,144 @@
+import net from "node:net";
+const HOSTNAME_RE = /^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$/i;
+const SHORT_HOSTNAME_RE = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/i;
+const SHELL_METACHAR_RE = /[\s;`$<>|&"'\\]/;
+/**
+ * Parse a network target as IP, CIDR, or hostname. Throws on shell-injection
+ * attempts. The output is safe to pass to spawn() with `shell: false`.
+ */
+export function parseHost(raw) {
+    const value = raw.trim();
+    if (!value) {
+        throw new Error(`Invalid host: empty value`);
+    }
+    if (SHELL_METACHAR_RE.test(value)) {
+        throw new Error(`Invalid host "${value}": contains shell metacharacters`);
+    }
+    // CIDR: <ip>/<bits>
+    if (value.includes("/")) {
+        const [addr, maskRaw] = value.split("/");
+        if (!addr || !maskRaw) {
+            throw new Error(`Invalid CIDR: ${value}`);
+        }
+        const mask = Number(maskRaw);
+        if (!Number.isInteger(mask)) {
+            throw new Error(`Invalid CIDR mask: ${maskRaw}`);
+        }
+        const family = net.isIP(addr);
+        if (family === 4) {
+            if (mask < 0 || mask > 32) {
+                throw new Error(`Invalid IPv4 CIDR mask: ${maskRaw}`);
+            }
+            return { kind: "cidr", value };
+        }
+        if (family === 6) {
+            if (mask < 0 || mask > 128) {
+                throw new Error(`Invalid IPv6 CIDR mask: ${maskRaw}`);
+            }
+            return { kind: "cidr", value };
+        }
+        throw new Error(`Invalid CIDR address: ${addr}`);
+    }
+    if (net.isIP(value)) {
+        return { kind: "ip", value };
+    }
+    if (HOSTNAME_RE.test(value) || SHORT_HOSTNAME_RE.test(value)) {
+        return { kind: "hostname", value: value.toLowerCase() };
+    }
+    throw new Error(`Invalid host: ${value}`);
+}
+/**
+ * Validate an nmap-compatible port specification. Accepts:
+ *   - single port: "80"
+ *   - csv: "80,443,8080"
+ *   - ranges: "1-1000"
+ *   - mixed: "22,80,443,8000-9000"
+ */
+export function parsePortSpec(raw) {
+    const value = raw.trim();
+    if (!value)
+        throw new Error("Invalid port spec: empty");
+    if (SHELL_METACHAR_RE.test(value)) {
+        throw new Error(`Invalid port spec "${value}": shell metacharacters`);
+    }
+    if (!/^[\d,\-]+$/.test(value)) {
+        throw new Error(`Invalid port spec: ${value}`);
+    }
+    for (const part of value.split(",")) {
+        if (part.includes("-")) {
+            const [lo, hi] = part.split("-").map((n) => Number(n));
+            if (!Number.isInteger(lo) || !Number.isInteger(hi)) {
+                throw new Error(`Invalid port range: ${part}`);
+            }
+            if (lo === undefined || hi === undefined) {
+                throw new Error(`Invalid port range: ${part}`);
+            }
+            if (lo < 1 || lo > 65535 || hi < 1 || hi > 65535 || lo > hi) {
+                throw new Error(`Invalid port range: ${part}`);
+            }
+        }
+        else {
+            const n = Number(part);
+            if (!Number.isInteger(n) || n < 1 || n > 65535) {
+                throw new Error(`Invalid port: ${part}`);
+            }
+        }
+    }
+    return value;
+}
+const SAFE_SCRIPT_RE = /^[a-z0-9_-]+(?:,[a-z0-9_-]+)*$/i;
+/** Convert a structured scan profile into safe argv for nmap. */
+export function profileToNmapArgs(profile = {}) {
+    const args = [];
+    if (profile.scanType === "syn")
+        args.push("-sS");
+    else if (profile.scanType === "tcp")
+        args.push("-sT");
+    else if (profile.scanType === "ping")
+        args.push("-sn");
+    if (profile.udp || profile.scanType === "udp")
+        args.push("-sU");
+    if (profile.serviceDetect)
+        args.push("-sV");
+    if (profile.timing) {
+        if (!/^T[0-5]$/.test(profile.timing)) {
+            throw new Error(`Invalid timing template: ${profile.timing}`);
+        }
+        args.push(`-${profile.timing}`);
+    }
+    if (typeof profile.topPorts === "number") {
+        if (!Number.isInteger(profile.topPorts) ||
+            profile.topPorts < 1 ||
+            profile.topPorts > 65535) {
+            throw new Error(`Invalid topPorts: ${profile.topPorts}`);
+        }
+        args.push("--top-ports", String(profile.topPorts));
+    }
+    if (profile.scripts && profile.scripts.length > 0) {
+        const joined = profile.scripts.join(",");
+        if (!SAFE_SCRIPT_RE.test(joined)) {
+            throw new Error(`Invalid scripts list: ${joined}`);
+        }
+        args.push("--script", joined);
+    }
+    return args;
+}
+/**
+ * For backwards compatibility with the legacy `flags` string. We accept a
+ * whitespace-delimited list, but only if every token matches a strict
+ * safe pattern (no shell metacharacters, no leading `-` followed by anything
+ * we don't recognize as a benign flag).
+ */
+export function parseLegacyFlags(raw) {
+    const value = raw.trim();
+    if (!value)
+        return [];
+    const tokens = value.split(/\s+/);
+    for (const token of tokens) {
+        if (!/^[A-Za-z0-9_./@:=,-]+$/.test(token)) {
+            throw new Error(`Invalid flag token: ${token}`);
+        }
+    }
+    return tokens;
+}
+//# sourceMappingURL=validate.js.map

package/dist/tools/validate.js.map

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

package/dist/types.d.ts

@@ -39,26 +39,18 @@ export interface ToolCall {
     name: string;
     args: Record<string, unknown>;
 }
+export interface ToolStats {
+    bytesRead: number;
+    bytesDropped: number;
+    linesRead: number;
+    elapsedMs: number;
+    captureLimitHit?: boolean | undefined;
+}
 export interface ToolResult {
     ok: boolean;
     output: string;
     exitCode?: number | undefined;
     outputPath?: string | undefined;
     truncated?: boolean | undefined;
-    modelContext?: string | undefined;
-    summary?: string | undefined;
-    artifacts?: ToolArtifact[] | undefined;
     stats?: ToolStats | undefined;
 }
-export interface ToolArtifact {
-    path: string;
-    kind: "raw" | "json" | "xml" | "report";
-    redacted: boolean;
-}
-export interface ToolStats {
-    bytesRead?: number | undefined;
-    bytesShown?: number | undefined;
-    bytesDropped?: number | undefined;
-    linesRead?: number | undefined;
-    elapsedMs?: number | undefined;
-}

package/dist/ui/keys.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Canonical keypress shapes used by clai. Centralized so the REPL,
+ * one-shot mode, and tests agree on what counts as "Ctrl+O" / "Ctrl+T" /
+ * "Ctrl+C" / "ESC" regardless of platform.
+ *
+ * Node's `readline.emitKeypressEvents` already normalizes the most
+ * common combinations across macOS / Linux / Windows terminals into the
+ * same `{ ctrl, meta, name, sequence }` shape, so we just need to be
+ * explicit about which fields matter.
+ */
+export interface Keypress {
+    ctrl?: boolean | undefined;
+    meta?: boolean | undefined;
+    shift?: boolean | undefined;
+    name?: string | undefined;
+    sequence?: string | undefined;
+}
+export declare function isCtrlC(key: Keypress): boolean;
+export declare function isCtrlT(key: Keypress): boolean;
+export declare function isCtrlO(key: Keypress): boolean;
+export declare function isEscape(key: Keypress): boolean;

package/dist/ui/keys.js

@@ -0,0 +1,13 @@
+export function isCtrlC(key) {
+    return Boolean(key.ctrl) && key.name === "c";
+}
+export function isCtrlT(key) {
+    return Boolean(key.ctrl) && key.name === "t";
+}
+export function isCtrlO(key) {
+    return Boolean(key.ctrl) && key.name === "o";
+}
+export function isEscape(key) {
+    return key.name === "escape";
+}
+//# sourceMappingURL=keys.js.map

package/dist/ui/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/ui/keys.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,OAAO,CAAC,GAAa;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAa;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAa;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAa;IACpC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC/B,CAAC"}

package/dist/ui/output-pane.d.ts

@@ -0,0 +1,31 @@
+export interface OutputViewport {
+    /** Display name for the tool (e.g. "shell.exec", "nmap"). */
+    toolName: string;
+    /** Short args display (e.g. the command line). */
+    argsDisplay: string;
+    /** Path to the raw artifact file on disk (if present). */
+    artifactPath?: string | undefined;
+    /** AI-facing reduced summary shown to the user as well. */
+    summary: string;
+    /** Whether the user has expanded the full output via Ctrl+O / /output. */
+    expanded: boolean;
+    /** Timestamp the viewport was registered (for /output last). */
+    createdAt: number;
+    /** Unique id; users can refer to it via /output <id>. */
+    id: string;
+}
+export declare function newViewportId(toolName: string): string;
+export declare function registerViewport(partial: Omit<OutputViewport, "id" | "expanded" | "createdAt"> & {
+    id?: string | undefined;
+}): OutputViewport;
+export declare function getViewport(id: string): OutputViewport | undefined;
+export declare function getLastViewport(): OutputViewport | undefined;
+export declare function listViewports(): OutputViewport[];
+/**
+ * Toggle expansion and render either the full artifact (when expanding) or
+ * a collapse confirmation (when collapsing). Used both by the Ctrl+O key
+ * handler and the /output slash command so the two paths agree.
+ */
+export declare function toggleViewport(id: string, write?: (chunk: string) => void): Promise<boolean>;
+export declare function clearViewports(): void;
+export declare function formatViewportHint(v: OutputViewport): string;

package/dist/ui/output-pane.js

@@ -0,0 +1,81 @@
+import { readFile } from "node:fs/promises";
+import chalk from "chalk";
+let viewportCounter = 0;
+const viewports = new Map();
+let lastViewportId;
+export function newViewportId(toolName) {
+    viewportCounter += 1;
+    return `${toolName.replace(/\W+/g, "-")}-${viewportCounter}`;
+}
+export function registerViewport(partial) {
+    const id = partial.id ?? newViewportId(partial.toolName);
+    const v = {
+        ...partial,
+        id,
+        expanded: false,
+        createdAt: Date.now(),
+    };
+    viewports.set(id, v);
+    lastViewportId = id;
+    return v;
+}
+export function getViewport(id) {
+    return viewports.get(id);
+}
+export function getLastViewport() {
+    if (!lastViewportId)
+        return undefined;
+    return viewports.get(lastViewportId);
+}
+export function listViewports() {
+    return [...viewports.values()].sort((a, b) => a.createdAt - b.createdAt);
+}
+/**
+ * Toggle expansion and render either the full artifact (when expanding) or
+ * a collapse confirmation (when collapsing). Used both by the Ctrl+O key
+ * handler and the /output slash command so the two paths agree.
+ */
+export async function toggleViewport(id, write = (c) => process.stdout.write(c)) {
+    const v = viewports.get(id);
+    if (!v)
+        return false;
+    v.expanded = !v.expanded;
+    if (v.expanded) {
+        write(chalk.dim(`\n  ── full output for ${v.toolName} (${v.argsDisplay}) ──\n`));
+        if (v.artifactPath) {
+            try {
+                const raw = await readFile(v.artifactPath, "utf8");
+                write(raw);
+                if (!raw.endsWith("\n"))
+                    write("\n");
+            }
+            catch (error) {
+                write(chalk.yellow(`  (could not read artifact: ${error instanceof Error ? error.message : String(error)})\n`));
+            }
+        }
+        else {
+            write(chalk.dim("  (no artifact file — only the summary is available)\n"));
+        }
+        write(chalk.dim(`  ── summary still shown below; press Ctrl+O again to collapse ──\n`));
+        // Re-print summary so the user has it without scrolling.
+        write(`${v.summary}\n`);
+    }
+    else {
+        write(chalk.dim(`\n  ── collapsed; press Ctrl+O to expand ──\n`));
+    }
+    return true;
+}
+export function clearViewports() {
+    viewports.clear();
+    lastViewportId = undefined;
+}
+export function formatViewportHint(v) {
+    const hints = [];
+    if (process.stdout.isTTY)
+        hints.push("Ctrl+O");
+    hints.push("/output last");
+    if (v.artifactPath)
+        hints.push(`/output ${v.id}`);
+    return chalk.dim(`  ${hints.join(" or ")} to ${v.expanded ? "collapse" : "show full output"}${v.artifactPath ? ` (${v.artifactPath})` : ""}`);
+}
+//# sourceMappingURL=output-pane.js.map

package/dist/ui/output-pane.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pentoshi/clai",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "A fast, cross-platform AI CLI assistant with ask and agent modes for shell tasks, file operations, and cybersecurity workflows.",
   "type": "module",
   "license": "MIT",