@soyrageagency/docker-mcp 1.1.0

package/dist/tools/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/tools/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,UAAU,sBAAsB,CAAC,GAAgB;IACrD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAE/C,2DAA2D;IAC3D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IAED,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,6DAA6D;YAC7D,8BAA8B;QAChC,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;SAC/D;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CACtB,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC,cAAc,aAAa,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC,YAAY,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,qEAAqE;YACrE,gDAAgD;QAClD,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC9D,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAC/B,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC,cAAc,aAAa,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,YAAY,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,qEAAqE;YACrE,wBAAwB;QAC1B,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC9D,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAC/B,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3C,OAAO,EAAE,CAAC,cAAc,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,qEAAqE;YACrE,8DAA8D;QAChE,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC9D,KAAK,EAAE,CAAC;iBACL,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,0CAA0C,CAAC;YACvD,aAAa,EAAE,CAAC;iBACb,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,iDAAiD,CAAC;SAC/D;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,CAC5C,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,CAAC,EAAE,aAAa,IAAI,KAAK,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,CAAC,YAAY,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC,CACL,CAAC;IAEF,4EAA4E;IAC5E,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAE1E,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;YACE,KAAK,EAAE,8BAA8B;YACrC,WAAW,EACT,kEAAkE;gBAClE,kEAAkE;gBAClE,gEAAgE;gBAChE,0BAA0B;YAC5B,WAAW,EAAE;gBACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;gBAC9D,OAAO,EAAE,CAAC;qBACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;qBACjB,GAAG,CAAC,CAAC,CAAC;qBACN,QAAQ,CAAC,gDAAgD,CAAC;gBAC7D,OAAO,EAAE,CAAC;qBACP,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,yCAAyC,CAAC;aACvD;SACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CACxC,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;gBAC7B,GAAG,EAAE,OAAO;gBACZ,YAAY,EAAE,IAAI;gBAClB,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,OAAO;aACpB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAErC,MAAM,MAAM,GAAG,aAAa,OAAO,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC;YACtD,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,MAAM,eAAe,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3F,CAAC,CAAC,CACL,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,SAAS,aAAa,CAAC,MAA6B;IAClD,OAAO,IAAI,OAAO,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE;QACjD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACpB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,GAAG,GAAa,EAAE,CAAC;YACzB,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,8DAA8D;YAC9D,OAAO,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5B,IAAI,IAAI,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;oBACvC,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC7C,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;gBACzB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;gBAChE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;YACxB,CAAC;YACD,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/logs.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Container log retrieval.
+ *
+ *   • container_logs — fetch the tail of a container's stdout/stderr.
+ *
+ * Docker multiplexes stdout and stderr over a single stream with an 8-byte
+ * header per frame when a TTY is not allocated. We demultiplex it here so the
+ * LLM receives clean, readable text.
+ *
+ * Part of Docker MCP Server.
+ * Crafted by SoyRage Agency — https://soyrage.es/
+ * Licensed under the MIT License.
+ */
+import type { ToolContext } from "./context.js";
+export declare function registerLogTools({ server, docker, config }: ToolContext): void;

package/dist/tools/logs.js

@@ -0,0 +1,110 @@
+/**
+ * Container log retrieval.
+ *
+ *   • container_logs — fetch the tail of a container's stdout/stderr.
+ *
+ * Docker multiplexes stdout and stderr over a single stream with an 8-byte
+ * header per frame when a TTY is not allocated. We demultiplex it here so the
+ * LLM receives clean, readable text.
+ *
+ * Part of Docker MCP Server.
+ * Crafted by SoyRage Agency — https://soyrage.es/
+ * Licensed under the MIT License.
+ */
+import { z } from "zod";
+import { normalizeName } from "../docker/client.js";
+import { guard, ok } from "../utils/result.js";
+/**
+ * Strip Docker's stream-multiplexing headers from a non-TTY log buffer.
+ * Each frame is: [stream(1)][000][size(4, big-endian)][payload(size)].
+ * If the buffer doesn't look framed (TTY containers), it is returned as-is.
+ */
+function demultiplex(buffer) {
+    const chunks = [];
+    let offset = 0;
+    while (offset + 8 <= buffer.length) {
+        const streamType = buffer[offset];
+        // A valid header has stream type 0, 1 or 2 and three zero bytes after it.
+        const looksFramed = (streamType === 0 || streamType === 1 || streamType === 2) &&
+            buffer[offset + 1] === 0 &&
+            buffer[offset + 2] === 0 &&
+            buffer[offset + 3] === 0;
+        if (!looksFramed)
+            return buffer.toString("utf8");
+        const size = buffer.readUInt32BE(offset + 4);
+        const start = offset + 8;
+        const end = start + size;
+        if (end > buffer.length)
+            break;
+        chunks.push(buffer.subarray(start, end).toString("utf8"));
+        offset = end;
+    }
+    return chunks.length > 0 ? chunks.join("") : buffer.toString("utf8");
+}
+export function registerLogTools({ server, docker, config }) {
+    server.registerTool("container_logs", {
+        title: "Read container logs",
+        description: "Fetch the most recent log lines from a container's stdout/stderr. " +
+            "Use this to diagnose crashes, watch startup output or confirm a " +
+            "deployment. Supports an optional time window via `since`.",
+        inputSchema: {
+            container: z
+                .string()
+                .min(1)
+                .describe("Container name, short id or full id."),
+            tail: z
+                .number()
+                .int()
+                .positive()
+                .max(5000)
+                .optional()
+                .describe("Number of trailing lines to return (default from server config)."),
+            since: z
+                .string()
+                .optional()
+                .describe("Only return logs newer than this. Accepts a Unix timestamp " +
+                "(seconds) or a relative value like '10m' or '2h'."),
+            timestamps: z
+                .boolean()
+                .optional()
+                .describe("Prefix each line with its timestamp (default: false)."),
+        },
+    }, async ({ container, tail, since, timestamps }) => guard(async () => {
+        const handle = await docker.resolveContainer(container);
+        const options = {
+            stdout: true,
+            stderr: true,
+            tail: tail ?? config.defaultLogTail,
+            timestamps: timestamps ?? false,
+        };
+        const sinceSeconds = parseSince(since);
+        if (sinceSeconds !== undefined)
+            options.since = sinceSeconds;
+        const raw = (await handle.logs(options));
+        const text = demultiplex(Buffer.from(raw)).trimEnd();
+        const name = normalizeName(container);
+        if (!text) {
+            return ok(`No log output for "${name}" in the requested window.`);
+        }
+        return ok(`Last ${options.tail} line(s) for "${name}":\n\n\`\`\`log\n${text}\n\`\`\``);
+    }));
+}
+/**
+ * Convert a `since` argument into an absolute Unix timestamp (seconds).
+ * Accepts raw seconds ("1700000000") or relative durations ("10m", "2h", "1d").
+ */
+function parseSince(since) {
+    if (!since)
+        return undefined;
+    const value = since.trim();
+    if (/^\d+$/.test(value))
+        return Number.parseInt(value, 10);
+    const match = /^(\d+)\s*(s|m|h|d)$/i.exec(value);
+    if (!match)
+        return undefined;
+    const amount = Number.parseInt(match[1], 10);
+    const unitSeconds = { s: 1, m: 60, h: 3600, d: 86400 };
+    const seconds = amount * unitSeconds[match[2].toLowerCase()];
+    return Math.floor(Date.now() / 1000) - seconds;
+}
+//# sourceMappingURL=logs.js.map

package/dist/tools/logs.js.map

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

package/dist/tools/system.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Host- and daemon-level tools.
+ *
+ *   • system_info   — daemon summary (version, OS, resources, counts).
+ *   • disk_usage    — reclaimable space across images/containers/volumes.
+ *   • list_networks — user and default networks.
+ *   • list_volumes  — named volumes and their drivers.
+ *
+ * Part of Docker MCP Server.
+ * Crafted by SoyRage Agency — https://soyrage.es/
+ * Licensed under the MIT License.
+ */
+import type { ToolContext } from "./context.js";
+export declare function registerSystemTools({ server, docker }: ToolContext): void;

package/dist/tools/system.js

@@ -0,0 +1,108 @@
+/**
+ * Host- and daemon-level tools.
+ *
+ *   • system_info   — daemon summary (version, OS, resources, counts).
+ *   • disk_usage    — reclaimable space across images/containers/volumes.
+ *   • list_networks — user and default networks.
+ *   • list_volumes  — named volumes and their drivers.
+ *
+ * Part of Docker MCP Server.
+ * Crafted by SoyRage Agency — https://soyrage.es/
+ * Licensed under the MIT License.
+ */
+import { formatBytes, renderTable, truncate } from "../utils/format.js";
+import { guard, ok } from "../utils/result.js";
+export function registerSystemTools({ server, docker }) {
+    server.registerTool("system_info", {
+        title: "System info",
+        description: "Summarise the Docker daemon: engine version, host OS/architecture, " +
+            "CPU and memory available, and how many containers/images exist. Use " +
+            "this to answer 'what does this server look like?'.",
+        inputSchema: {},
+    }, async () => guard(async () => {
+        const [info, version] = await Promise.all([
+            docker.info(),
+            docker.version(),
+        ]);
+        const get = (obj, key) => obj[key] === undefined ? "n/a" : String(obj[key]);
+        const memBytes = Number(info.MemTotal ?? 0);
+        const lines = [
+            `Engine:        ${get(version, "Version")} (API ${get(version, "ApiVersion")})`,
+            `Host OS:       ${get(info, "OperatingSystem")} / ${get(info, "OSType")}-${get(info, "Architecture")}`,
+            `Kernel:        ${get(info, "KernelVersion")}`,
+            `CPUs:          ${get(info, "NCPU")}`,
+            `Memory:        ${formatBytes(memBytes)}`,
+            `Containers:    ${get(info, "Containers")} (running ${get(info, "ContainersRunning")}, stopped ${get(info, "ContainersStopped")})`,
+            `Images:        ${get(info, "Images")}`,
+            `Storage driver:${" "}${get(info, "Driver")}`,
+            `Docker root:   ${get(info, "DockerRootDir")}`,
+        ];
+        return ok(lines.join("\n"));
+    }));
+    server.registerTool("disk_usage", {
+        title: "Disk usage",
+        description: "Report Docker disk usage across images, containers and volumes " +
+            "(equivalent to `docker system df`), highlighting reclaimable space.",
+        inputSchema: {},
+    }, async () => guard(async () => {
+        const df = await docker.diskUsage();
+        const sumSize = (items) => Array.isArray(items)
+            ? items.reduce((sum, item) => sum + Number(item.Size ?? 0), 0)
+            : 0;
+        const images = df.Images;
+        const containers = df.Containers;
+        const volumes = df.Volumes;
+        const rows = [
+            [
+                "Images",
+                String(Array.isArray(images) ? images.length : 0),
+                formatBytes(sumSize(images)),
+            ],
+            [
+                "Containers",
+                String(Array.isArray(containers) ? containers.length : 0),
+                formatBytes(sumSize(containers)),
+            ],
+            [
+                "Volumes",
+                String(Array.isArray(volumes) ? volumes.length : 0),
+                formatBytes(Array.isArray(volumes)
+                    ? volumes.reduce((sum, v) => sum +
+                        Number(v.UsageData
+                            ?.Size ?? 0), 0)
+                    : 0),
+            ],
+        ];
+        return ok(renderTable(["TYPE", "COUNT", "SIZE"], rows));
+    }));
+    server.registerTool("list_networks", {
+        title: "List networks",
+        description: "List Docker networks with their driver and scope. Useful to " +
+            "understand how containers can reach one another.",
+        inputSchema: {},
+    }, async () => guard(async () => {
+        const networks = await docker.listNetworks();
+        const rows = networks.map((net) => [
+            truncate(net.Name, 28),
+            (net.Id ?? "").slice(0, 12),
+            net.Driver ?? "—",
+            net.Scope ?? "—",
+        ]);
+        return ok(renderTable(["NAME", "ID", "DRIVER", "SCOPE"], rows));
+    }));
+    server.registerTool("list_volumes", {
+        title: "List volumes",
+        description: "List named Docker volumes and their storage driver. These persist " +
+            "data beyond a container's lifecycle.",
+        inputSchema: {},
+    }, async () => guard(async () => {
+        const volumes = await docker.listVolumes();
+        const rows = volumes.map((vol) => [
+            truncate(vol.Name, 32),
+            vol.Driver ?? "—",
+            truncate(vol.Mountpoint ?? "—", 40),
+        ]);
+        return ok(renderTable(["NAME", "DRIVER", "MOUNTPOINT"], rows));
+    }));
+}
+//# sourceMappingURL=system.js.map

package/dist/tools/system.js.map

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

package/dist/tui/ansi.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ANSI terminal helpers.
+ *
+ * A tiny, dependency-free toolkit for the terminal UI: colours, cursor control
+ * and width-aware padding/truncation that accounts for invisible escape codes
+ * so columns line up perfectly.
+ *
+ * Part of Docker MCP Server.
+ * Crafted by SoyRage Agency — https://soyrage.es/
+ * MIT licensed (see LICENSE).
+ */
+/** Raw control sequences. */
+export declare const ctl: {
+    enterAlt: string;
+    exitAlt: string;
+    hideCursor: string;
+    showCursor: string;
+    clear: string;
+    home: string;
+    clearLine: string;
+    clearBelow: string;
+};
+/** Move the cursor to a 1-based (row, col). */
+export declare function moveTo(row: number, col: number): string;
+export declare const color: {
+    reset: string;
+    dim: (s: string) => string;
+    bold: (s: string) => string;
+    black: (s: string) => string;
+    red: (s: string) => string;
+    green: (s: string) => string;
+    yellow: (s: string) => string;
+    blue: (s: string) => string;
+    magenta: (s: string) => string;
+    cyan: (s: string) => string;
+    white: (s: string) => string;
+    gray: (s: string) => string;
+    brightBlue: (s: string) => string;
+    brightCyan: (s: string) => string;
+    brightGreen: (s: string) => string;
+    brightRed: (s: string) => string;
+    brightYellow: (s: string) => string;
+    /** SoyRage accent (256-colour blue). */
+    accent: (s: string) => string;
+    /** Inverse video for selection highlight. */
+    invert: (s: string) => string;
+    /** Background helpers. */
+    bgAccent: (s: string) => string;
+};
+/** Strip ANSI escapes to measure the visible length of a string. */
+export declare function stripAnsi(s: string): string;
+/** Visible length (ignoring escape codes). */
+export declare function visLen(s: string): number;
+/** Truncate to a visible width, preserving trailing reset. */
+export declare function truncate(s: string, width: number): string;
+/** Pad a string on the right to a visible width. */
+export declare function padEnd(s: string, width: number): string;
+/** Pad a string on the left to a visible width. */
+export declare function padStart(s: string, width: number): string;
+/** Centre a string within a visible width. */
+export declare function center(s: string, width: number): string;
+/**
+ * Render a horizontal usage bar of the given inner width, coloured by level.
+ * Example: `[██████░░░░]`.
+ */
+export declare function bar(percent: number, width: number): string;

package/dist/tui/ansi.js

@@ -0,0 +1,118 @@
+/**
+ * ANSI terminal helpers.
+ *
+ * A tiny, dependency-free toolkit for the terminal UI: colours, cursor control
+ * and width-aware padding/truncation that accounts for invisible escape codes
+ * so columns line up perfectly.
+ *
+ * Part of Docker MCP Server.
+ * Crafted by SoyRage Agency — https://soyrage.es/
+ * MIT licensed (see LICENSE).
+ */
+const ESC = "\x1b[";
+/** Raw control sequences. */
+export const ctl = {
+    enterAlt: `${ESC}?1049h`,
+    exitAlt: `${ESC}?1049l`,
+    hideCursor: `${ESC}?25l`,
+    showCursor: `${ESC}?25h`,
+    clear: `${ESC}2J`,
+    home: `${ESC}H`,
+    clearLine: `${ESC}K`,
+    clearBelow: `${ESC}J`,
+};
+/** Move the cursor to a 1-based (row, col). */
+export function moveTo(row, col) {
+    return `${ESC}${row};${col}H`;
+}
+/** SGR colour wrappers. */
+const sgr = (code) => (s) => `${ESC}${code}m${s}${ESC}0m`;
+export const color = {
+    reset: `${ESC}0m`,
+    dim: sgr(2),
+    bold: (s) => `${ESC}1m${s}${ESC}22m`,
+    black: sgr(30),
+    red: sgr(31),
+    green: sgr(32),
+    yellow: sgr(33),
+    blue: sgr(34),
+    magenta: sgr(35),
+    cyan: sgr(36),
+    white: sgr(37),
+    gray: sgr(90),
+    brightBlue: sgr(94),
+    brightCyan: sgr(96),
+    brightGreen: sgr(92),
+    brightRed: sgr(91),
+    brightYellow: sgr(93),
+    /** SoyRage accent (256-colour blue). */
+    accent: (s) => `${ESC}38;5;39m${s}${ESC}0m`,
+    /** Inverse video for selection highlight. */
+    invert: (s) => `${ESC}7m${s}${ESC}27m`,
+    /** Background helpers. */
+    bgAccent: (s) => `${ESC}48;5;24m${s}${ESC}0m`,
+};
+// eslint-disable-next-line no-control-regex
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+/** Strip ANSI escapes to measure the visible length of a string. */
+export function stripAnsi(s) {
+    return s.replace(ANSI_RE, "");
+}
+/** Visible length (ignoring escape codes). */
+export function visLen(s) {
+    return stripAnsi(s).length;
+}
+/** Truncate to a visible width, preserving trailing reset. */
+export function truncate(s, width) {
+    if (visLen(s) <= width)
+        return s;
+    // Walk characters, counting only visible ones, keeping escapes intact.
+    let out = "";
+    let visible = 0;
+    let i = 0;
+    while (i < s.length && visible < width - 1) {
+        if (s[i] === "\x1b") {
+            const match = /^\x1b\[[0-9;]*m/.exec(s.slice(i));
+            if (match) {
+                out += match[0];
+                i += match[0].length;
+                continue;
+            }
+        }
+        out += s[i];
+        visible += 1;
+        i += 1;
+    }
+    return `${out}…${color.reset}`;
+}
+/** Pad a string on the right to a visible width. */
+export function padEnd(s, width) {
+    const len = visLen(s);
+    return len >= width ? truncate(s, width) : s + " ".repeat(width - len);
+}
+/** Pad a string on the left to a visible width. */
+export function padStart(s, width) {
+    const len = visLen(s);
+    return len >= width ? truncate(s, width) : " ".repeat(width - len) + s;
+}
+/** Centre a string within a visible width. */
+export function center(s, width) {
+    const len = visLen(s);
+    if (len >= width)
+        return truncate(s, width);
+    const left = Math.floor((width - len) / 2);
+    return " ".repeat(left) + s + " ".repeat(width - len - left);
+}
+/**
+ * Render a horizontal usage bar of the given inner width, coloured by level.
+ * Example: `[██████░░░░]`.
+ */
+export function bar(percent, width) {
+    const clamped = Math.max(0, Math.min(100, percent));
+    const filled = Math.round((clamped / 100) * width);
+    const fill = "█".repeat(filled);
+    const rest = "░".repeat(Math.max(0, width - filled));
+    const paint = clamped >= 80 ? color.red : clamped >= 50 ? color.yellow : color.green;
+    return `${paint(fill)}${color.gray(rest)}`;
+}
+//# sourceMappingURL=ansi.js.map

package/dist/tui/ansi.js.map

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

package/dist/tui/app.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Terminal UI application.
+ *
+ * A creative, dependency-free TUI in the spirit of lazydocker: a full-screen
+ * dashboard with a live container list, per-container CPU/memory gauges, a
+ * details/logs pane and one-key lifecycle actions — wrapped in a SoyRage
+ * Agency welcome that thanks you for using the repo and asks for a ⭐.
+ *
+ * Rendering is a hand-rolled ANSI frame (no curses library), which keeps the
+ * dependency surface at zero and the styling fully under our control.
+ *
+ * Part of Docker MCP Server.
+ * Crafted by SoyRage Agency — https://soyrage.es/
+ * MIT licensed (see LICENSE).
+ */
+import type { PanelService } from "../panel/service.js";
+export type Input = "normal" | "ai" | "confirm" | "message" | "filter" | "volume" | "snapshots" | "menu";
+/** The interactive terminal application. */
+export declare class TuiApp {
+    private readonly service;
+    private readonly out;
+    private readonly inp;
+    private mode;
+    private containers;
+    private system;
+    private selected;
+    private showLogs;
+    private logs;
+    private status;
+    private timer;
+    private refreshing;
+    private input;
+    private aiInput;
+    private message;
+    private messageTitle;
+    private pending;
+    private update;
+    /** Lazy-loaded inspect detail for the selected container (LazyDocker-style). */
+    private detail;
+    private detailFor;
+    /** An in-flight lifecycle animation (start/stop/restart). */
+    private anim;
+    private animTimer;
+    private filter;
+    private sortKey;
+    private sortDesc;
+    private frozen;
+    private freezeOverride;
+    private logFollow;
+    private logTail;
+    private volumeInput;
+    private tick;
+    private ticker;
+    private menuIndex;
+    private menuItems;
+    constructor(service: PanelService, out?: NodeJS.WriteStream & {
+        fd: 1;
+    }, inp?: NodeJS.ReadStream & {
+        fd: 0;
+    });
+    /** Enter alt-screen, wire input, show splash, then run. */
+    start(): Promise<void>;
+    private readonly onData;
+    private setupInput;
+    /**
+     * Hand the terminal to an interactive child (a shell, an editor), then take it
+     * back. We leave the alt-screen and raw mode, detach our key handler, run the
+     * child with inherited stdio, and on exit restore everything and repaint.
+     */
+    private runInteractive;
+    private onKey;
+    private onAiKey;
+    private onConfirmKey;
+    /** Live-editing the container name/image filter. */
+    private onFilterKey;
+    /** Typing the "host:container[:ro]" bind spec. */
+    private onVolumeKey;
+    /** Cycle the sort column: name → cpu → mem → state → name. */
+    private cycleSort;
+    /** Copy the selected container's full ID to the clipboard (OSC 52). */
+    private copyId;
+    /** Full inspect overlay: command, health, networks, mounts and env. */
+    private showInspect;
+    /** Networks overlay. */
+    private showNetworks;
+    /** Volumes overlay. */
+    private showVolumes;
+    /** Current alerts overlay. */
+    private showAlerts;
+    /** Confirm then snapshot the selected container (image commit). */
+    private confirmSnapshot;
+    /** Open an interactive shell inside the selected container (docker exec -it). */
+    private openShell;
+    /** Edit a compose file in the user's $EDITOR (suspends the dashboard). */
+    private editCompose;
+    /** Open the per-container action menu over the current selection. */
+    private openMenu;
+    private onMenuKey;
+    /** The action-menu body, with the highlighted row and shortcut hints. */
+    private menuText;
+    /** Snapshot picker → restore (numbered overlay). */
+    private openSnapshots;
+    /** Attach an extra volume via a one-line "host:container[:ro]" prompt. */
+    private startVolume;
+    private submitVolume;
+    /** Handle key presses while the snapshot picker is open. */
+    private onSnapshotsKey;
+    /** Ask the AI copilot; propose the docker command and confirm before running. */
+    private runAi;
+    private runAiCommand;
+    private showMessage;
+    private helpText;
+    /** Containers after the active filter and sort — what the list actually shows. */
+    private visible;
+    private move;
+    /** Jump to the first or last row. */
+    private jump;
+    /** Fetch the inspect summary for the selected container, once, lazily. */
+    private loadDetail;
+    private current;
+    private enterMain;
+    /** Fetch the update channel once in the background; silent on any failure. */
+    private checkUpdate;
+    private action;
+    /** Begin the lifecycle spinner and drive its frames. */
+    private startAnim;
+    private stopAnim;
+    private loadLogs;
+    private refresh;
+    private quit;
+    private cols;
+    private rows;
+    /** Paint the whole frame from a line array. */
+    private paint;
+    /** Build the welcome-splash lines (also used by `--splash` snapshot mode). */
+    splashLines(cols?: number, rows?: number): string[];
+    private renderSplash;
+    /**
+     * Render one static main frame to a string (no cursor control). Used by the
+     * `--frame` snapshot mode to document the TUI. Refreshes data first.
+     */
+    frame(cols?: number, rows?: number, demoInput?: Input): Promise<string>;
+    private render;
+    private buildMainLines;
+    private headerLine;
+    private resourceLine;
+    private containerRows;
+    private detailRows;
+    private logRows;
+    private footerKeys;
+    /** Overlay a centered modal box (help / AI answers) onto the frame. */
+    private overlay;
+    /** A single-line update notice under the resource bar; null when up to date. */
+    private updateBanner;
+    /** The numbered snapshot list shown in the restore picker. */
+    private snapshotsText;
+    /** The modal body for [u]: every release newer than what's running. */
+    private changelogText;
+    private footerBrand;
+}