@kruntime/komputer 0.1.0

package/dist/shell/builtins/commands/text/wc.js

@@ -0,0 +1,30 @@
+import { parseWcArgs } from "../../text.js";
+export const wcBuiltin = async (ctx, args, stdin) => {
+    const { fields, paths } = parseWcArgs(args);
+    if (!paths.length)
+        return `${formatWcCounts(countText(stdin), fields)}\n`;
+    const rows = [];
+    const total = { lines: 0, words: 0, bytes: 0 };
+    for (const path of paths) {
+        const input = path === '-' ? stdin : await ctx.fs.readText(ctx.shellPath(path));
+        const counts = countText(input);
+        total.lines += counts.lines;
+        total.words += counts.words;
+        total.bytes += counts.bytes;
+        rows.push(`${formatWcCounts(counts, fields)} ${path === '-' ? '-' : ctx.shellPath(path)}`);
+    }
+    if (paths.length > 1)
+        rows.push(`${formatWcCounts(total, fields)} total`);
+    return `${rows.join('\n')}\n`;
+};
+function countText(input) {
+    return {
+        lines: input ? input.split('\n').length - (input.endsWith('\n') ? 1 : 0) : 0,
+        words: input.trim() ? input.trim().split(/\s+/).length : 0,
+        bytes: new TextEncoder().encode(input).length,
+    };
+}
+function formatWcCounts(counts, fields) {
+    return fields.map((field) => String(counts[field])).join(' ');
+}
+//# sourceMappingURL=wc.js.map

package/dist/shell/builtins/commands/text/wc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wc.js","sourceRoot":"","sources":["../../../../../../../../packages/komputer/src/shell/builtins/commands/text/wc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAU3C,MAAM,CAAC,MAAM,SAAS,GAAmB,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;IAClE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAC3C,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,IAAI,CAAA;IAEzE,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,MAAM,KAAK,GAAa,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;QAC/E,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAC/B,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAA;QAC3B,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAA;QAC3B,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAA;QAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC5F,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IACzE,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;AAC/B,CAAC,CAAA;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1D,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM;KAC9C,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,MAAgB,EAAE,MAAiB;IACzD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC/D,CAAC"}

package/dist/shell/builtins/commands/text/xargs.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinHandler } from '../../runtime.js';
+export declare const xargsBuiltin: BuiltinHandler;

package/dist/shell/builtins/commands/text/xargs.js

@@ -0,0 +1,138 @@
+import { quoteShellWord } from "../../runtime.js";
+export const xargsBuiltin = async (ctx, args, stdin, signal) => {
+    const options = parseXargsArgs(args);
+    const items = splitXargsInput(stdin, {
+        delimiter: options.delimiter,
+        byLine: Boolean(options.replace),
+    });
+    if (!items.length && options.noRunIfEmpty)
+        return '';
+    const command = options.command.length ? options.command : ['echo'];
+    const invocations = makeInvocations(command, items, options);
+    let stdout = '';
+    for (const invocation of invocations) {
+        const result = await ctx.exec(invocation.map(quoteShellWord).join(' '), { signal });
+        stdout += String(result.stdout || '');
+        const code = typeof result.code === 'number' ? result.code : result.status === 'committed' ? 0 : 1;
+        if (code !== 0)
+            throw new Error(String(result.stderr || `xargs command failed with exit ${code}`));
+    }
+    return stdout;
+};
+function parseXargsArgs(args) {
+    const options = {
+        command: [],
+        delimiter: 'whitespace',
+        maxArgs: Number.POSITIVE_INFINITY,
+        noRunIfEmpty: false,
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--') {
+            options.command = args.slice(index + 1);
+            return options;
+        }
+        if (arg === '-0' || arg === '--null') {
+            options.delimiter = 'nul';
+            continue;
+        }
+        if (arg === '-r' || arg === '--no-run-if-empty') {
+            options.noRunIfEmpty = true;
+            continue;
+        }
+        if (arg === '-n') {
+            options.maxArgs = parsePositiveInteger(args[++index], '-n');
+            continue;
+        }
+        if (/^-n[0-9]+$/.test(arg)) {
+            options.maxArgs = parsePositiveInteger(arg.slice(2), '-n');
+            continue;
+        }
+        if (arg === '-I') {
+            options.replace = args[++index] || '{}';
+            options.maxArgs = 1;
+            continue;
+        }
+        if (arg.startsWith('-I') && arg.length > 2) {
+            options.replace = arg.slice(2);
+            options.maxArgs = 1;
+            continue;
+        }
+        options.command = args.slice(index);
+        return options;
+    }
+    return options;
+}
+function splitXargsInput(input, options) {
+    if (!input)
+        return [];
+    if (options.delimiter === 'nul')
+        return input.split('\0').filter((item) => item.length > 0);
+    if (options.byLine)
+        return input.split(/\r?\n/).filter((item) => item.length > 0);
+    return splitShellLikeFields(input);
+}
+function splitShellLikeFields(input) {
+    const fields = [];
+    let current = '';
+    let quote;
+    let escaping = false;
+    const push = () => {
+        if (!current)
+            return;
+        fields.push(current);
+        current = '';
+    };
+    for (let index = 0; index < input.length; index += 1) {
+        const char = input[index];
+        if (escaping) {
+            current += char;
+            escaping = false;
+            continue;
+        }
+        if (char === '\\') {
+            escaping = true;
+            continue;
+        }
+        if (quote) {
+            if (char === quote)
+                quote = undefined;
+            else
+                current += char;
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            quote = char;
+            continue;
+        }
+        if (/\s/.test(char)) {
+            push();
+            continue;
+        }
+        current += char;
+    }
+    push();
+    return fields;
+}
+function makeInvocations(command, items, options) {
+    if (options.replace) {
+        if (!items.length)
+            return [];
+        return items.map((item) => command.map((part) => part.replaceAll(options.replace || '{}', item)));
+    }
+    if (!items.length)
+        return [command];
+    const invocations = [];
+    const size = Number.isFinite(options.maxArgs) ? options.maxArgs : items.length;
+    for (let index = 0; index < items.length; index += size) {
+        invocations.push([...command, ...items.slice(index, index + size)]);
+    }
+    return invocations;
+}
+function parsePositiveInteger(value, option) {
+    const parsed = Number.parseInt(value || '', 10);
+    if (!Number.isFinite(parsed) || parsed < 1)
+        throw new Error(`xargs ${option} requires a positive integer`);
+    return parsed;
+}
+//# sourceMappingURL=xargs.js.map

package/dist/shell/builtins/commands/text/xargs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xargs.js","sourceRoot":"","sources":["../../../../../../../../packages/komputer/src/shell/builtins/commands/text/xargs.ts"],"names":[],"mappings":"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"}

package/dist/shell/builtins/commands/text.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinEntry } from '../runtime.js';
+export declare const textBuiltins: Record<string, BuiltinEntry>;

package/dist/shell/builtins/commands/text.js

@@ -0,0 +1,41 @@
+import { awkBuiltin } from "./text/awk.js";
+import { base64Builtin } from "./text/base64.js";
+import { cutBuiltin } from "./text/cut.js";
+import { diffBuiltin } from "./text/diff.js";
+import { echoBuiltin } from "./text/echo.js";
+import { grepBuiltin } from "./text/grep.js";
+import { headBuiltin } from "./text/head.js";
+import { jqBuiltin } from "./text/jq.js";
+import { printfBuiltin } from "./text/printf.js";
+import { sedBuiltin } from "./text/sed.js";
+import { sha256sumBuiltin } from "./text/sha256sum.js";
+import { sortBuiltin } from "./text/sort.js";
+import { tailBuiltin } from "./text/tail.js";
+import { teeBuiltin } from "./text/tee.js";
+import { trBuiltin } from "./text/tr.js";
+import { uniqBuiltin } from "./text/uniq.js";
+import { wcBuiltin } from "./text/wc.js";
+import { xargsBuiltin } from "./text/xargs.js";
+import { builtinSpec } from "../runtime.js";
+import { HELP_TEXT } from "../help-text.js";
+export const textBuiltins = {
+    base64: builtinSpec(base64Builtin, HELP_TEXT.base64),
+    echo: builtinSpec(echoBuiltin, HELP_TEXT.echo),
+    printf: builtinSpec(printfBuiltin, HELP_TEXT.printf),
+    grep: builtinSpec(grepBuiltin, HELP_TEXT.grep),
+    wc: builtinSpec(wcBuiltin, HELP_TEXT.wc),
+    head: builtinSpec(headBuiltin, HELP_TEXT.head),
+    jq: builtinSpec(jqBuiltin, HELP_TEXT.jq),
+    tail: builtinSpec(tailBuiltin, HELP_TEXT.tail),
+    sort: builtinSpec(sortBuiltin, HELP_TEXT.sort),
+    uniq: builtinSpec(uniqBuiltin, HELP_TEXT.uniq),
+    sed: builtinSpec(sedBuiltin, HELP_TEXT.sed),
+    sha256sum: builtinSpec(sha256sumBuiltin, HELP_TEXT.sha256sum),
+    awk: builtinSpec(awkBuiltin, HELP_TEXT.awk),
+    tr: builtinSpec(trBuiltin, HELP_TEXT.tr),
+    cut: builtinSpec(cutBuiltin, HELP_TEXT.cut),
+    diff: builtinSpec(diffBuiltin, HELP_TEXT.diff),
+    tee: builtinSpec(teeBuiltin, HELP_TEXT.tee),
+    xargs: builtinSpec(xargsBuiltin, HELP_TEXT.xargs),
+};
+//# sourceMappingURL=text.js.map

package/dist/shell/builtins/commands/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../../../../../packages/komputer/src/shell/builtins/commands/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3C,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,MAAM,EAAE,WAAW,CAAC,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC;IAC9C,MAAM,EAAE,WAAW,CAAC,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC;IAC9C,EAAE,EAAE,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;IACxC,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC;IAC9C,EAAE,EAAE,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;IACxC,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC;IAC9C,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC;IAC9C,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC;IAC9C,GAAG,EAAE,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC;IAC3C,SAAS,EAAE,WAAW,CAAC,gBAAgB,EAAE,SAAS,CAAC,SAAS,CAAC;IAC7D,GAAG,EAAE,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC;IAC3C,EAAE,EAAE,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;IACxC,GAAG,EAAE,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC;IAC3C,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC;IAC9C,GAAG,EAAE,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC;IAC3C,KAAK,EAAE,WAAW,CAAC,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC;CAClD,CAAA"}

package/dist/shell/builtins/help-text.d.ts

@@ -0,0 +1,69 @@
+export declare const HELP_TEXT: {
+    readonly awk: "\nUsage: awk [-F SEP] PROGRAM [FILE...]\n\nProcess text records from files or stdin.\nSupported programs cover common Agent workflows such as {print}, field\nreferences like $1, and simple pattern/action processing.\n";
+    readonly basename: "\nUsage: basename PATH\n\nPrint the final path component.\n";
+    readonly base64: "\nUsage: base64 [-d] [FILE...]\n\nEncode or decode Base64 from files or stdin.\nUse -d or --decode to decode. Whitespace is ignored while decoding.\n";
+    readonly bg: "\nUsage: bg JOB\n\nResume a stopped virtual background job.\nJOB may be a virtual process id, job id, or shell-style %job spec.\n";
+    readonly cat: "\nUsage: cat [OPTIONS] [FILE...]\n\nConcatenate files or stdin to stdout.\nOptions: -n/--number, -b/--number-nonblank, -s/--squeeze-blank\n";
+    readonly cd: "\nUsage: cd [DIR]\n\nChange the current K shell directory. Without DIR, changes to $HOME.\n";
+    readonly chmod: "\nUsage: chmod [-R] MODE FILE...\n\nChange KFS permissions.\nMODE may be octal, such as 755, or symbolic, such as u+x,g-w.\n";
+    readonly command: "\nUsage: command -v NAME...\n\nResolve command names without running them.\n";
+    readonly cp: "\nUsage: cp [-aRrpf] SOURCE... DEST\n\nCopy files or directories in KFS.\nUse -r or -R for directories. Use -p to preserve mode and mtime when supported.\nUse -a as a portable archive shorthand for -R -p.\n";
+    readonly curl: "\nUsage: curl [OPTIONS] URL\n\nFetch from K virtual network hosts.\nOptions: -L, -f, -I, -i, -X METHOD, -H HEADER, -d DATA, -o FILE, -D FILE\n";
+    readonly cut: "\nUsage: cut (-c LIST | -f LIST [-d DELIM]) [FILE...]\n\nSelect character or field ranges from files or stdin.\nLong options: --characters=LIST, --fields=LIST, --delimiter=DELIM\n";
+    readonly date: "\nUsage: date [-u] [-I|--iso-8601[=seconds]] [-d DATE] [+FORMAT]\n\nPrint or format a date.\nSupported DATE forms include ISO dates, @SECONDS, now, today, yesterday,\ntomorrow, and relative forms such as \"2 days ago\".\n";
+    readonly diff: "\nUsage: diff [-u] [-q] LEFT RIGHT\n\nCompare two KFS files.\nReturns exit code 1 when files differ, matching Unix diff behavior.\n";
+    readonly dirname: "\nUsage: dirname PATH\n\nPrint PATH with its final component removed.\n";
+    readonly du: "\nUsage: du [-a] [-s] [-h] [PATH...]\n\nEstimate file usage in KFS.\nOptions: -a/--all, -s/--summarize, -h/--human-readable\n";
+    readonly echo: "\nUsage: echo [-n] [ARG...]\n\nWrite arguments separated by spaces and followed by a newline.\nUse -n to omit the trailing newline.\n";
+    readonly env: "\nUsage: env [-i] [-u NAME] [NAME=VALUE...] [COMMAND [ARG...]]\n\nPrint the environment or run COMMAND with a modified environment.\n";
+    readonly export: "\nUsage: export [-p] [NAME[=VALUE]...]\n\nMark variables in the current K shell environment.\n";
+    readonly false: "\nUsage: false\n\nReturn an unsuccessful exit status.\n";
+    readonly find: "\nUsage: find [PATH] [TESTS] [ACTIONS]\n\nWalk files in KFS.\nTests: -type f|d|l, -name GLOB, -path GLOB, -maxdepth N, -mindepth N,\n  -empty, -mtime [+|-]N, ! TEST, -not TEST\nActions: -print, -print0, -exec COMMAND {} \\;, -exec COMMAND {} +\n";
+    readonly fg: "\nUsage: fg JOB\n\nBring a virtual background job to the foreground and stream its result.\nJOB may be a virtual process id, job id, or shell-style %job spec.\n";
+    readonly grep: "\nUsage: grep [OPTIONS] PATTERN [FILE...]\n\nSearch text from files or stdin.\nOptions: -R/-r, -n, -i, -v, -c, -l, -q, -o, -h, -H, -F, -E,\n  -m N, -A N, -B N, -C N,\n  --include=GLOB, --exclude=GLOB, --exclude-dir=GLOB\n";
+    readonly head: "\nUsage: head [-n COUNT] [-c BYTES] [FILE...]\n\nPrint the first lines or bytes from files or stdin.\n";
+    readonly help: "\nUsage: help [TOPIC]\n\nList K builtins or print help for one builtin.\n";
+    readonly hostname: "\nUsage: hostname\n\nPrint this Komputer's virtual hostname.\n";
+    readonly id: "\nUsage: id [-u|-g|-G] [-n] [USER]\n\nPrint the virtual Unix identity for the current Agent user.\n";
+    readonly install: "\nUsage: install [-D] [-d] [-m MODE] SOURCE... DEST\n\nCopy files into KFS and set their mode.\nUse -d to create directories, -D to create the destination parent directory,\nand -m MODE to set permissions. Default file mode is 755.\n";
+    readonly jobs: "\nUsage: jobs\n\nList active virtual shell jobs.\n";
+    readonly jq: "\nUsage: jq [-r] [-c] FILTER [FILE...]\n\nApply a JSON filter to files or stdin.\nSupported filters include ., fields, indexes, [], length, keys, select(), and pipelines.\n";
+    readonly kill: "\nUsage: kill [-s SIGNAL | -SIGNAL] TARGET...\n\nSignal virtual processes or jobs.\nTARGET may be a virtual process id, job id, or shell-style %job spec.\n";
+    readonly ln: "\nUsage: ln -s [-f] TARGET LINK_NAME\n\nCreate a symbolic link in KFS.\n";
+    readonly ls: "\nUsage: ls [OPTIONS] [FILE...]\n\nList files in KFS.\nOptions: -a, -A, -l, -F, -R, -1, -h, -G, --all, --almost-all,\n  --classify, --recursive, --color\n";
+    readonly mkdir: "\nUsage: mkdir [-p] DIR...\n\nCreate directories in KFS.\nUse -p or --parents to create missing parents and ignore existing directories.\n";
+    readonly mktemp: "\nUsage: mktemp [-d] [-p DIR] [TEMPLATE]\n\nCreate a unique temporary file, or a directory with -d.\nTemplates must contain at least three consecutive X characters.\n";
+    readonly mv: "\nUsage: mv [-f] SOURCE... DEST\n\nMove or rename files and directories in KFS.\nWhen moving multiple sources, DEST must be an existing directory.\n";
+    readonly printenv: "\nUsage: printenv [NAME...]\n\nPrint environment variables.\n";
+    readonly printf: "\nUsage: printf FORMAT [ARG...]\n\nFormat and print data using common printf escapes and conversions.\n";
+    readonly ps: "\nUsage: ps\n\nList virtual processes owned by the current Agent session.\n";
+    readonly pwd: "\nUsage: pwd\n\nPrint the current K shell directory.\n";
+    readonly read: "\nUsage: read [-r] [NAME...]\n\nRead one line from stdin and assign fields to shell variables.\n";
+    readonly readlink: "\nUsage: readlink [-f|-e|-m] FILE...\n\nPrint symbolic link targets, or canonical paths with -f/-e/-m.\n";
+    readonly realpath: "\nUsage: realpath [-e|-f|-m] FILE...\n\nPrint canonical KFS paths.\n";
+    readonly rm: "\nUsage: rm [-f] [-r|-R] FILE...\n\nRemove files from KFS.\nUse -r or -R for directories. Use -f to ignore missing operands and paths.\n";
+    readonly sed: "\nUsage: sed [-n] [-E] [-i[SUFFIX]] SCRIPT [FILE...]\n\nEdit text from files or stdin.\nSupported scripts include s/// substitutions, p, d, address ranges, and -i.\n";
+    readonly sha256sum: "\nUsage: sha256sum [-c] [FILE...]\n\nPrint or verify SHA-256 checksums for KFS files or stdin.\nWithout FILE, reads stdin and prints a checksum for \"-\".\n";
+    readonly set: "\nUsage: set [OPTIONS]\n\nShow or update K shell options.\nSupported options: -e/+e, -u/+u, -o pipefail, +o pipefail\n";
+    readonly sh: "\nUsage: sh (-c COMMAND | SCRIPT) [ARG...]\n\nRun a K shell command string or KFS script.\nbash is an alias for this K shell-compatible interpreter.\n";
+    readonly sleep: "\nUsage: sleep SECONDS\n\nPause a foreground or background virtual process.\n";
+    readonly sort: "\nUsage: sort [-n] [-r] [-u] [-t DELIM] [-k KEY] [FILE...]\n\nSort lines from files or stdin.\nKEY uses common field notation such as 2, 2,2, or 2,2n.\n";
+    readonly source: "\nUsage: source FILE [ARG...]\n\nRun a KFS shell script in the current shell environment.\n. is an alias for source.\n";
+    readonly stat: "\nUsage: stat [-c FORMAT|--printf FORMAT] FILE...\n\nPrint KFS file metadata.\nCommon format escapes: %n, %s, %F, %a, %A, %y, %Y\n";
+    readonly tail: "\nUsage: tail [-n COUNT] [-c BYTES] [FILE...]\n\nPrint the last lines or bytes from files or stdin.\n";
+    readonly tee: "\nUsage: tee [-a] [FILE...]\n\nCopy stdin to stdout and to KFS files.\n";
+    readonly test: "\nUsage: test EXPRESSION\nUsage: [ EXPRESSION ]\nUsage: [[ EXPRESSION ]]\n\nEvaluate a shell test expression and return success or failure.\n";
+    readonly touch: "\nUsage: touch [-c] [-r FILE] [-d DATE] [-t TIME] FILE...\n\nCreate files or update their modification time in KFS.\n";
+    readonly tr: "\nUsage: tr SET1 SET2\n\nTranslate characters from stdin.\n";
+    readonly true: "\nUsage: true\n\nReturn a successful exit status.\n";
+    readonly type: "\nUsage: type [-a|-p|-t] NAME...\n\nDescribe how command names resolve in the K shell.\n";
+    readonly uname: "\nUsage: uname [-a]\n\nPrint K virtual system information.\n";
+    readonly uniq: "\nUsage: uniq [-c] [-d] [-u] [FILE...]\n\nFilter adjacent repeated lines from files or stdin.\n";
+    readonly unset: "\nUsage: unset NAME...\n\nRemove shell variables from the current K shell environment.\n";
+    readonly wait: "\nUsage: wait [JOB...]\n\nWait for virtual background jobs. Without JOB, waits for all active jobs.\n";
+    readonly wc: "\nUsage: wc [-lwmc] [FILE...]\n\nCount lines, words, and bytes from files or stdin.\n";
+    readonly wget: "\nUsage: wget [OPTIONS] URL\n\nFetch from K virtual network hosts.\nOptions: -O FILE, -L, -X METHOD, -H HEADER, -d DATA\n";
+    readonly which: "\nUsage: which NAME...\n\nPrint the resolved executable path or command name.\n";
+    readonly whoami: "\nUsage: whoami\n\nPrint the current Agent Unix user name.\n";
+    readonly xargs: "\nUsage: xargs [OPTIONS] [COMMAND [ARG...]]\n\nBuild command invocations from stdin.\nOptions: -0, -r, -n N, -I REPLACE\n";
+};