@poe-platform/safe-bash 0.1.788 → 0.1.790

package/dist/safe-bash-command-wkhtmltopdf/pdf-renderer.d.ts

@@ -3,9 +3,9 @@ import type { CommandDefinition } from "../safe-bash-contracts/command.js";
 import type { VirtualShellPlugin } from "../safe-bash-contracts/plugin.js";
 import { type RendererProfile } from "./engine.js";
 export declare const pdfAstRendererProfile: RendererProfile;
-export declare function renderPdfAstSync(request: Parameters<StaticRenderer["open"]>[0]): Uint8Array;
 export declare function createPdfAstRenderer(): StaticRenderer;
 export declare const pdfAstRenderer: StaticRenderer;
 export declare function createPdfAstWkhtmltopdfCommand(options?: Partial<WkhtmltopdfCommandOptions>): CommandDefinition;
 export declare const pdfAstWkhtmltopdfCommand: CommandDefinition;
 export declare function pdfAstWkhtmltopdfCommands(options?: Partial<WkhtmltopdfCommandOptions>): VirtualShellPlugin;
+export declare function renderPdfAstSync(request: Parameters<StaticRenderer["open"]>[0]): Uint8Array;

package/dist/safe-bash-command-xxd/index.js

@@ -4,6 +4,7 @@ import {
 
 // packages/safe-bash-command-xxd/dist/index.js
 init_buffer();
+import { writeFileOutput } from "../safe-bash-contracts/filesystem-output-budget.js";
 import { isAbsolutePath, validatePath } from "@poe-platform/safe-fs/core";
 import { CommandArgumentIdentityError, FsError, readBytes, shellValueByteLength, writeBytes } from "../safe-bash-contracts/index.js";
 import { PublicDiagnostic } from "../safe-bash-contracts/public-diagnostic.js";
@@ -304,7 +305,18 @@ function hexDigit(byte) {
     return byte - 87;
   return -1;
 }
-async function reversePlain(context, files, maxInputBytes) {
+async function padToAddress(context, start, address) {
+  if (!Number.isSafeInteger(address) || address < start)
+    throw new PublicDiagnostic("invalid input: cannot seek backwards on output stream");
+  while (start < address) {
+    const length = Math.min(blockSize, address - start);
+    await output(context, new Uint8Array(length));
+    start += length;
+    await yieldTurn(context.signal);
+  }
+}
+async function reversePlain(context, files, maxInputBytes, seek) {
+  await padToAddress(context, 0, seek);
   let high = -1;
   for await (const chunk of sources(context, files, maxInputBytes)) {
     const pending = [];
@@ -327,7 +339,7 @@ async function reversePlain(context, files, maxInputBytes) {
       await output(context, Uint8Array.from(pending));
   }
 }
-async function reverseNormal(context, files, columns, maxInputBytes) {
+async function reverseNormal(context, files, columns, maxInputBytes, seek) {
   let line = "";
   let offset = 0;
   const outBuf = new Uint8Array(8192);
@@ -342,7 +354,7 @@ async function reverseNormal(context, files, columns, maxInputBytes) {
     }
   };
   const rowScratch = new Uint8Array(Math.max(columns, 256));
-  const parseLineBytesInto = (buf, startPos, endPos) => {
+  const parseLineBytesInto = async (buf, startPos, endPos) => {
     let nonSpace = false;
     for (let i = startPos; i < endPos; i++) {
       const c = buf[i];
@@ -351,7 +363,7 @@ async function reverseNormal(context, files, columns, maxInputBytes) {
         break;
       }
     }
-    if (!nonSpace)
+    if (!nonSpace || endPos - startPos === 1 && buf[startPos] === 42)
       return 0;
     const colonAbs = buf.indexOf(58, startPos);
     const colon = colonAbs >= 0 && colonAbs < endPos ? colonAbs - startPos : -1;
@@ -364,8 +376,10 @@ async function reverseNormal(context, files, columns, maxInputBytes) {
         throw new PublicDiagnostic("invalid input: expected hexadecimal address and colon");
       address = address * 16 + digit;
     }
-    if (!Number.isSafeInteger(address) || address !== offset)
-      throw new PublicDiagnostic("invalid input: reverse requires contiguous addresses starting at zero");
+    address = addOffset(address, seek);
+    await flushOut();
+    await padToAddress(context, offset, address);
+    offset = address;
     let count = 0;
     let high = -1;
     let spaces = 0;
@@ -406,7 +420,7 @@ async function reverseNormal(context, files, columns, maxInputBytes) {
       }
       let count = 0;
       if (line.length === 0) {
-        count = parseLineBytesInto(chunk, start, nl);
+        count = await parseLineBytesInto(chunk, start, nl);
       } else {
         for (let i = start; i < nl; i++)
           line += String.fromCharCode(chunk[i]);
@@ -414,7 +428,7 @@ async function reverseNormal(context, files, columns, maxInputBytes) {
         for (let i = 0; i < line.length; i++)
           lineBytes[i] = line.charCodeAt(i);
         line = "";
-        count = parseLineBytesInto(lineBytes, 0, lineBytes.length);
+        count = await parseLineBytesInto(lineBytes, 0, lineBytes.length);
       }
       start = nl + 1;
       if (count > 0) {
@@ -433,7 +447,7 @@ async function reverseNormal(context, files, columns, maxInputBytes) {
     const lineBytes = new Uint8Array(line.length);
     for (let i = 0; i < line.length; i++)
       lineBytes[i] = line.charCodeAt(i);
-    const count = parseLineBytesInto(lineBytes, 0, lineBytes.length);
+    const count = await parseLineBytesInto(lineBytes, 0, lineBytes.length);
     if (count > 0) {
       if (outUsed + count > outBuf.length)
         await flushOut();
@@ -472,7 +486,9 @@ function createXxdCommand(optionsOrMaxBytes) {
       "-len": "-l",
       "-bits": "-b",
       "-include": "-i",
-      "-name": "-n"
+      "-name": "-n",
+      "-autoskip": "-a",
+      "-capitalize": "-C"
     };
     let ended = false;
     const args = context.args.map((argument) => {
@@ -482,10 +498,17 @@ function createXxdCommand(optionsOrMaxBytes) {
         ended = true;
       return aliases[argument] ?? argument;
     });
-    const parsed = parseOptions(args, "prdubiec:g:l:s:o:n:");
+    const parsed = parseOptions(args, "aCprdubiec:g:l:s:o:n:");
     requireOperands(parsed.operands, 0, 2);
     if (parsed.operands[1] !== void 0 && parsed.operands[1] !== "-") {
-      throw new UsageError("output-file operands are not supported; output is stdout only");
+      const original = context;
+      const path = pathOf(context, parsed.operands[1]);
+      let started = false;
+      context = { ...original, stdout: { async write(bytes) {
+        await writeFileOutput(original, bytes, (data) => started ? original.fs.appendFile(path, data, { signal: original.signal }) : original.fs.writeFile(path, data, { signal: original.signal }));
+        started = true;
+      } } };
+      await writeBytes(context.stdout, new Uint8Array(), context.signal);
     }
     const files = parsed.operands.slice(0, 1);
     const plain = parsed.flags.has("p");
@@ -511,21 +534,31 @@ function createXxdCommand(optionsOrMaxBytes) {
     if (littleEndian && group && !Number.isInteger(Math.log2(group))) {
       throw new UsageError("number of octets per group must be a power of 2 with -e");
     }
-    const skip = validatedOption(parsed, "s", (text) => numeric(text.startsWith("+") && text.length > 1 ? text.slice(1) : text), 0);
+    let skip = validatedOption(parsed, "s", (text) => {
+      const relative = text.startsWith("+") ? text.slice(1) : text;
+      return relative.startsWith("-") ? -numeric(relative.slice(1)) : numeric(relative);
+    }, 0);
     const count = validatedOption(parsed, "l", numeric, Infinity);
     const displacement = validatedOption(parsed, "o", numeric, 0);
-    if (reverse && ["s", "l", "o", "d"].some((flag) => parsed.flags.has(flag))) {
+    if (reverse && ["l", "o", "d"].some((flag) => parsed.flags.has(flag))) {
       throw new UsageError("reverse does not support seek, length, displacement, or decimal addresses");
     }
     if (reverse) {
       if (plain)
-        await reversePlain(context, files, maxInputBytes);
+        await reversePlain(context, files, maxInputBytes, skip);
       else
-        await reverseNormal(context, files, columns, maxInputBytes);
+        await reverseNormal(context, files, columns, maxInputBytes, skip);
       return { exitCode: 0 };
     }
+    const input = sources(context, files, maxInputBytes);
+    if (skip < 0) {
+      if (!files[0] || files[0] === "-")
+        throw new UsageError("negative seek requires an input file");
+      const size = (await context.fs.stat(pathOf(context, files[0]), { signal: context.signal })).size;
+      skip = Math.max(0, size + skip);
+    }
     let offset = addOffset(skip, displacement);
-    const source = range(sources(context, files, maxInputBytes), skip, count);
+    const source = range(input, skip, count);
     let any = false;
     let includeLength = 0;
     let includeRow = "";
@@ -539,6 +572,8 @@ function createXxdCommand(optionsOrMaxBytes) {
       if (identifier[0] && identifier[0] >= "0" && identifier[0] <= "9")
         identifier = "__" + identifier;
     }
+    if (parsed.flags.has("C"))
+      identifier = identifier.toUpperCase();
     const upper = parsed.flags.has("u");
     const hexTable = upper ? HEX_UPPER : HEX_LOWER;
     const byteTable = binary ? BIN_TABLE : hexTable;
@@ -564,6 +599,17 @@ function createXxdCommand(optionsOrMaxBytes) {
       await writeOut(`unsigned char ${identifier}[] = {
 `);
     const rowWidth = plain && !columns ? 4096 : columns;
+    let zeroRun = 0;
+    let zeroSecond = "", zeroLast = "";
+    const finishZeros = (atEnd) => {
+      if (zeroRun >= (atEnd ? 4 : 3))
+        outBuf += "*\n" + (atEnd ? zeroLast : "");
+      else if (zeroRun === 3)
+        outBuf += zeroSecond + zeroLast;
+      else if (zeroRun === 2)
+        outBuf += zeroLast;
+      zeroRun = 0;
+    };
     for await (const batch of rows(source, rowWidth)) {
       any = true;
       for (let rowStart = 0; rowStart < batch.length; rowStart += rowWidth) {
@@ -578,7 +624,7 @@ function createXxdCommand(optionsOrMaxBytes) {
             await flushOut();
           continue;
         }
-        if (!plain && !littleEndian && !binary && columns === 16 && group === 2 && row.length === 16) {
+        if (!parsed.flags.has("a") && !plain && !littleEndian && !binary && columns === 16 && group === 2 && row.length === 16) {
           const b0 = row[0], b1 = row[1], b2 = row[2], b3 = row[3];
           const b4 = row[4], b5 = row[5], b6 = row[6], b7 = row[7];
           const b8 = row[8], b9 = row[9], b10 = row[10], b11 = row[11];
@@ -615,20 +661,32 @@ function createXxdCommand(optionsOrMaxBytes) {
           outBuf += data + (columns ? "\n" : "");
         else {
           const address = offset.toString(decimalAddress ? 10 : 16).padStart(8, "0");
-          outBuf += `${address}: ${data.padEnd(width)}  ${ascii}
+          const formatted = `${address}: ${data.padEnd(width)}  ${ascii}
 `;
+          if (parsed.flags.has("a") && row.length === columns && row.every((byte) => byte === 0)) {
+            if (zeroRun === 0)
+              outBuf += formatted;
+            if (zeroRun === 1)
+              zeroSecond = formatted;
+            zeroRun++;
+            zeroLast = formatted;
+          } else {
+            finishZeros(false);
+            outBuf += formatted;
+          }
         }
         offset = addOffset(offset, row.length);
         if (!flushedFirst || outBuf.length >= 16384)
           await flushOut();
       }
     }
+    finishZeros(true);
     if (include) {
       if (includeRow)
         await writeOut(includeRow + "\n");
       if (includeName !== void 0)
         await writeOut(`};
-unsigned int ${identifier}_len = ${includeLength};
+unsigned int ${identifier}${parsed.flags.has("C") ? "_LEN" : "_len"} = ${includeLength};
 `);
     }
     if (plain && !columns && any)

package/dist/safe-bash-command-xz/command.d.ts

@@ -1,7 +1,11 @@
 import type { CommandDefinition } from "../safe-bash-contracts/index.js";
 import { type CompressionCommandOptions } from "../safe-bash-compression-engine/stream.js";
 import type { VirtualShellPlugin } from "../safe-bash-contracts/plugin.js";
+export interface XzLimits {
+    readonly maxDecodedBytes: number;
+}
 export interface XzCommandsOptions extends CompressionCommandOptions {
+    readonly limits?: Partial<XzLimits>;
     readonly replace?: boolean;
 }
 export declare function createXzCommand(config?: XzCommandsOptions, name?: string): CommandDefinition;

package/dist/safe-bash-command-xz/index.d.ts

@@ -1,2 +1,2 @@
-export { createXzCommands, createXzCommand, xzCommands, type XzCommandsOptions } from "./command.js";
+export { createXzCommands, createXzCommand, xzCommands, type XzLimits, type XzCommandsOptions } from "./command.js";
 export type { CompressionCommandOptions } from "../safe-bash-compression-engine/stream.js";

package/dist/safe-bash-command-xz/index.js

@@ -24,7 +24,7 @@ import { runOperand } from "../safe-bash-compression-engine/operand.js";
 import { planOperands, verifyOperandDestinations } from "../safe-bash-compression-engine/files.js";
 import { DecodedBudget } from "../safe-bash-compression-engine/stream.js";
 function createXzCommand(config = {}, name = "xz") {
-  const maxDecodedBytes = config.maxDecodedBytes;
+  const maxDecodedBytes = config.limits?.maxDecodedBytes ?? config.maxDecodedBytes ?? Infinity;
   if (maxDecodedBytes !== void 0 && maxDecodedBytes !== Infinity && (!Number.isSafeInteger(maxDecodedBytes) || maxDecodedBytes < 0)) {
     throw new RangeError("maxDecodedBytes must be a nonnegative safe integer or Infinity");
   }

package/dist/safe-bash-compression-engine/bounded-codec.js

@@ -1,10 +1,10 @@
 import {
   boundedCodec
-} from "../safe-bash/command-chunks/chunk-ADCGH6A7.js";
-import "../safe-bash/command-chunks/chunk-DEH3CMGL.js";
-import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
+} from "../safe-bash/command-chunks/chunk-FH3D75FC.js";
+import "../safe-bash/command-chunks/chunk-QJ3ONEBI.js";
 import "../safe-bash/command-chunks/chunk-KHGQDFQ7.js";
 import "../safe-bash/command-chunks/chunk-A7L65T2H.js";
+import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
 import "../safe-bash/command-chunks/chunk-HX3SHTCE.js";
 export {
   boundedCodec

package/dist/safe-bash-compression-engine/codec-loader.js

@@ -1,9 +1,9 @@
 import {
   createCodec
-} from "../safe-bash/command-chunks/chunk-DEH3CMGL.js";
-import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
+} from "../safe-bash/command-chunks/chunk-QJ3ONEBI.js";
 import "../safe-bash/command-chunks/chunk-KHGQDFQ7.js";
 import "../safe-bash/command-chunks/chunk-A7L65T2H.js";
+import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
 import "../safe-bash/command-chunks/chunk-HX3SHTCE.js";
 export {
   createCodec

package/dist/safe-bash-compression-engine/files.js

@@ -4,17 +4,17 @@ import {
   unchangedSource,
   verifyOperandDestinations,
   writeFileOperand
-} from "../safe-bash/command-chunks/chunk-3HDIDEUJ.js";
+} from "../safe-bash/command-chunks/chunk-GF54KE2M.js";
 import "../safe-bash/command-chunks/chunk-LVEHHFOV.js";
-import "../safe-bash/command-chunks/chunk-PFBJR2PY.js";
-import "../safe-bash/command-chunks/chunk-L3MLMXL4.js";
+import "../safe-bash/command-chunks/chunk-2KRKKW5S.js";
+import "../safe-bash/command-chunks/chunk-3ZK5F23O.js";
 import "../safe-bash/command-chunks/chunk-6NTY42E5.js";
 import "../safe-bash/command-chunks/chunk-2MFNTNK7.js";
-import "../safe-bash/command-chunks/chunk-ADCGH6A7.js";
-import "../safe-bash/command-chunks/chunk-DEH3CMGL.js";
-import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
+import "../safe-bash/command-chunks/chunk-FH3D75FC.js";
+import "../safe-bash/command-chunks/chunk-QJ3ONEBI.js";
 import "../safe-bash/command-chunks/chunk-KHGQDFQ7.js";
 import "../safe-bash/command-chunks/chunk-A7L65T2H.js";
+import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
 import "../safe-bash/command-chunks/chunk-RDV7UCYZ.js";
 import "../safe-bash/command-chunks/chunk-HX3SHTCE.js";
 export {

package/dist/safe-bash-compression-engine/index.js

@@ -1,17 +1,17 @@
 import {
   DecodedBudget,
   transform
-} from "../safe-bash/command-chunks/chunk-PFBJR2PY.js";
-import "../safe-bash/command-chunks/chunk-L3MLMXL4.js";
+} from "../safe-bash/command-chunks/chunk-2KRKKW5S.js";
+import "../safe-bash/command-chunks/chunk-3ZK5F23O.js";
 import "../safe-bash/command-chunks/chunk-6NTY42E5.js";
 import "../safe-bash/command-chunks/chunk-2MFNTNK7.js";
 import {
   boundedCodec
-} from "../safe-bash/command-chunks/chunk-ADCGH6A7.js";
-import "../safe-bash/command-chunks/chunk-DEH3CMGL.js";
-import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
+} from "../safe-bash/command-chunks/chunk-FH3D75FC.js";
+import "../safe-bash/command-chunks/chunk-QJ3ONEBI.js";
 import "../safe-bash/command-chunks/chunk-KHGQDFQ7.js";
 import "../safe-bash/command-chunks/chunk-A7L65T2H.js";
+import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
 import "../safe-bash/command-chunks/chunk-RDV7UCYZ.js";
 import {
   init_buffer

package/dist/safe-bash-compression-engine/operand.js

@@ -2,21 +2,21 @@ import {
   sourceBytes,
   unchangedSource,
   writeFileOperand
-} from "../safe-bash/command-chunks/chunk-3HDIDEUJ.js";
+} from "../safe-bash/command-chunks/chunk-GF54KE2M.js";
 import {
   FileOperation
 } from "../safe-bash/command-chunks/chunk-LVEHHFOV.js";
 import {
   transform
-} from "../safe-bash/command-chunks/chunk-PFBJR2PY.js";
-import "../safe-bash/command-chunks/chunk-L3MLMXL4.js";
+} from "../safe-bash/command-chunks/chunk-2KRKKW5S.js";
+import "../safe-bash/command-chunks/chunk-3ZK5F23O.js";
 import "../safe-bash/command-chunks/chunk-6NTY42E5.js";
 import "../safe-bash/command-chunks/chunk-2MFNTNK7.js";
-import "../safe-bash/command-chunks/chunk-ADCGH6A7.js";
-import "../safe-bash/command-chunks/chunk-DEH3CMGL.js";
-import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
+import "../safe-bash/command-chunks/chunk-FH3D75FC.js";
+import "../safe-bash/command-chunks/chunk-QJ3ONEBI.js";
 import "../safe-bash/command-chunks/chunk-KHGQDFQ7.js";
 import "../safe-bash/command-chunks/chunk-A7L65T2H.js";
+import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
 import "../safe-bash/command-chunks/chunk-RDV7UCYZ.js";
 import {
   init_buffer

package/dist/safe-bash-compression-engine/stream.js

@@ -3,15 +3,15 @@ import {
   chunkBytes,
   stagingLimit,
   transform
-} from "../safe-bash/command-chunks/chunk-PFBJR2PY.js";
-import "../safe-bash/command-chunks/chunk-L3MLMXL4.js";
+} from "../safe-bash/command-chunks/chunk-2KRKKW5S.js";
+import "../safe-bash/command-chunks/chunk-3ZK5F23O.js";
 import "../safe-bash/command-chunks/chunk-6NTY42E5.js";
 import "../safe-bash/command-chunks/chunk-2MFNTNK7.js";
-import "../safe-bash/command-chunks/chunk-ADCGH6A7.js";
-import "../safe-bash/command-chunks/chunk-DEH3CMGL.js";
-import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
+import "../safe-bash/command-chunks/chunk-FH3D75FC.js";
+import "../safe-bash/command-chunks/chunk-QJ3ONEBI.js";
 import "../safe-bash/command-chunks/chunk-KHGQDFQ7.js";
 import "../safe-bash/command-chunks/chunk-A7L65T2H.js";
+import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
 import "../safe-bash/command-chunks/chunk-RDV7UCYZ.js";
 import "../safe-bash/command-chunks/chunk-HX3SHTCE.js";
 export {

package/dist/safe-bash-compression-engine/zstd-decode.js

@@ -1,13 +1,13 @@
 import {
   zstdDecode
-} from "../safe-bash/command-chunks/chunk-L3MLMXL4.js";
+} from "../safe-bash/command-chunks/chunk-3ZK5F23O.js";
 import "../safe-bash/command-chunks/chunk-6NTY42E5.js";
 import "../safe-bash/command-chunks/chunk-2MFNTNK7.js";
-import "../safe-bash/command-chunks/chunk-ADCGH6A7.js";
-import "../safe-bash/command-chunks/chunk-DEH3CMGL.js";
-import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
+import "../safe-bash/command-chunks/chunk-FH3D75FC.js";
+import "../safe-bash/command-chunks/chunk-QJ3ONEBI.js";
 import "../safe-bash/command-chunks/chunk-KHGQDFQ7.js";
 import "../safe-bash/command-chunks/chunk-A7L65T2H.js";
+import "../safe-bash/command-chunks/chunk-Z6SFT6OC.js";
 import "../safe-bash/command-chunks/chunk-RDV7UCYZ.js";
 import "../safe-bash/command-chunks/chunk-HX3SHTCE.js";
 export {

package/dist/safe-bash-contracts/command.js

@@ -8,12 +8,12 @@ import {
   registerDefaultExecutor,
   registerDefaultExecutors,
   validateExitCode
-} from "../safe-bash/command-chunks/chunk-IJ3FXP4Q.js";
+} from "../safe-bash/command-chunks/chunk-A3ZX6SCY.js";
 import {
   builtInDirectContextExecutors
-} from "../safe-bash/command-chunks/chunk-WYJTWJZ5.js";
-import "../safe-bash/command-chunks/chunk-D7TADAYG.js";
+} from "../safe-bash/command-chunks/chunk-G3G6W5ZE.js";
 import "../safe-bash/command-chunks/chunk-7QBEUGRX.js";
+import "../safe-bash/command-chunks/chunk-64LG3EVJ.js";
 import "../safe-bash/command-chunks/chunk-HX3SHTCE.js";
 export {
   CommandArgumentIdentityError,

package/dist/safe-bash-contracts/default-executor.d.ts

@@ -0,0 +1,5 @@
+import type { CommandDefinition } from "./command.js";
+export { builtInDirectContextExecutors } from "./runtime-control.js";
+export declare function isDefaultCommandOptions(options?: unknown): boolean;
+export declare function registerDefaultExecutor<T extends CommandDefinition>(def: T, options?: unknown): T;
+export declare function registerDefaultExecutors<T extends readonly CommandDefinition[]>(defs: T, options?: unknown): T;

package/dist/safe-bash-contracts/default-executor.js

@@ -0,0 +1,37 @@
+import {
+  builtInDirectContextExecutors
+} from "../safe-bash/command-chunks/chunk-G3G6W5ZE.js";
+import "../safe-bash/command-chunks/chunk-64LG3EVJ.js";
+import {
+  init_buffer
+} from "../safe-bash/command-chunks/chunk-HX3SHTCE.js";
+
+// packages/safe-bash-contracts/dist/default-executor.js
+init_buffer();
+function isDefaultCommandOptions(options) {
+  if (!options || typeof options !== "object")
+    return true;
+  for (const [k, v] of Object.entries(options)) {
+    if (k !== "replace" && v !== void 0)
+      return false;
+  }
+  return true;
+}
+function registerDefaultExecutor(def, options) {
+  if (isDefaultCommandOptions(options))
+    builtInDirectContextExecutors.add(def.execute);
+  return def;
+}
+function registerDefaultExecutors(defs, options) {
+  if (isDefaultCommandOptions(options)) {
+    for (let i = 0; i < defs.length; i++)
+      builtInDirectContextExecutors.add(defs[i].execute);
+  }
+  return defs;
+}
+export {
+  builtInDirectContextExecutors,
+  isDefaultCommandOptions,
+  registerDefaultExecutor,
+  registerDefaultExecutors
+};

package/dist/safe-bash-contracts/diagnostics.js

@@ -3,10 +3,10 @@ import {
 } from "../safe-bash/command-chunks/chunk-WCVGFWMI.js";
 import {
   CommandArgumentIdentityError
-} from "../safe-bash/command-chunks/chunk-IJ3FXP4Q.js";
-import "../safe-bash/command-chunks/chunk-WYJTWJZ5.js";
-import "../safe-bash/command-chunks/chunk-D7TADAYG.js";
+} from "../safe-bash/command-chunks/chunk-A3ZX6SCY.js";
+import "../safe-bash/command-chunks/chunk-G3G6W5ZE.js";
 import "../safe-bash/command-chunks/chunk-7QBEUGRX.js";
+import "../safe-bash/command-chunks/chunk-64LG3EVJ.js";
 import {
   FsError
 } from "../safe-bash/command-chunks/chunk-U6CJOXRY.js";

package/dist/safe-bash-contracts/escaping.js

@@ -1,23 +1,23 @@
 import "../safe-bash/command-chunks/chunk-UWNBM24V.js";
-import "../safe-bash/command-chunks/chunk-XGMWWUHV.js";
+import "../safe-bash/command-chunks/chunk-JCDHBLWM.js";
+import "../safe-bash/command-chunks/chunk-6LBBB4KL.js";
+import "../safe-bash/command-chunks/chunk-CZ5DAK4K.js";
 import "../safe-bash/command-chunks/chunk-3IC3LNJH.js";
 import "../safe-bash/command-chunks/chunk-PTLDMI4O.js";
-import "../safe-bash/command-chunks/chunk-JCDHBLWM.js";
-import "../safe-bash/command-chunks/chunk-IJ3FXP4Q.js";
-import "../safe-bash/command-chunks/chunk-WYJTWJZ5.js";
-import {
-  yieldTurn
-} from "../safe-bash/command-chunks/chunk-D7TADAYG.js";
+import "../safe-bash/command-chunks/chunk-A3ZX6SCY.js";
+import "../safe-bash/command-chunks/chunk-G3G6W5ZE.js";
 import {
   shellValueByteLength
 } from "../safe-bash/command-chunks/chunk-7QBEUGRX.js";
 import "../safe-bash/command-chunks/chunk-FCHHRTWP.js";
 import {
   writeBytes
-} from "../safe-bash/command-chunks/chunk-4QX6XCDD.js";
+} from "../safe-bash/command-chunks/chunk-4RNIZ3RT.js";
+import {
+  yieldTurn
+} from "../safe-bash/command-chunks/chunk-64LG3EVJ.js";
 import "../safe-bash/command-chunks/chunk-CRIWRVFY.js";
 import "../safe-bash/command-chunks/chunk-U6CJOXRY.js";
-import "../safe-bash/command-chunks/chunk-6LBBB4KL.js";
 import {
   init_buffer
 } from "../safe-bash/command-chunks/chunk-HX3SHTCE.js";

package/dist/safe-bash-contracts/filesystem-descriptor.js

@@ -1,9 +1,9 @@
 import {
   openCommandFile
-} from "../safe-bash/command-chunks/chunk-KSIGF4AG.js";
+} from "../safe-bash/command-chunks/chunk-BK4CMEE6.js";
 import "../safe-bash/command-chunks/chunk-PTLDMI4O.js";
-import "../safe-bash/command-chunks/chunk-WYJTWJZ5.js";
-import "../safe-bash/command-chunks/chunk-D7TADAYG.js";
+import "../safe-bash/command-chunks/chunk-G3G6W5ZE.js";
+import "../safe-bash/command-chunks/chunk-64LG3EVJ.js";
 import "../safe-bash/command-chunks/chunk-U6CJOXRY.js";
 import "../safe-bash/command-chunks/chunk-HX3SHTCE.js";
 export {

package/dist/safe-bash-contracts/filesystem-output.js

@@ -1,9 +1,9 @@
 import {
   openCommandFile
-} from "../safe-bash/command-chunks/chunk-KSIGF4AG.js";
+} from "../safe-bash/command-chunks/chunk-BK4CMEE6.js";
 import {
   createOutputOperation
-} from "../safe-bash/command-chunks/chunk-XGMWWUHV.js";
+} from "../safe-bash/command-chunks/chunk-CZ5DAK4K.js";
 import {
   assertCountedFileOutput,
   bindFileOutputBudget,
@@ -11,18 +11,18 @@ import {
   writeFileOutput,
   writeFileOutputCounted
 } from "../safe-bash/command-chunks/chunk-PTLDMI4O.js";
-import "../safe-bash/command-chunks/chunk-WYJTWJZ5.js";
+import "../safe-bash/command-chunks/chunk-G3G6W5ZE.js";
+import {
+  createBytePipe,
+  outputFailure
+} from "../safe-bash/command-chunks/chunk-4RNIZ3RT.js";
 import {
   abortManagedController,
   addAbortSignalWaiter,
   isManagedAbortSignal,
   registerManagedAbortSignal,
   removeAbortSignalWaiter
-} from "../safe-bash/command-chunks/chunk-D7TADAYG.js";
-import {
-  createBytePipe,
-  outputFailure
-} from "../safe-bash/command-chunks/chunk-4QX6XCDD.js";
+} from "../safe-bash/command-chunks/chunk-64LG3EVJ.js";
 import {
   FsError
 } from "../safe-bash/command-chunks/chunk-U6CJOXRY.js";

package/dist/safe-bash-contracts/http.d.ts

@@ -0,0 +1,41 @@
+import type { ByteSource } from "./io.js";
+import type { InvocationCleanup } from "./command.js";
+export type HttpHeaders = readonly (readonly [string, string])[];
+export interface HttpRequest {
+    /** Explicit VFS PEM trust for this request; replaces transport-default CAs. */
+    readonly ca?: Uint8Array;
+    readonly httpVersion?: "1.0" | "1.1";
+    /** Read until EOF rather than using Content-Length; host transport must opt in. */
+    readonly ignoreContentLength?: true;
+    /** Validated HTTP(S) origin with curl request-target spelling; transports must preserve it. */
+    readonly url: string;
+    readonly method: string;
+    readonly headers: HttpHeaders;
+    readonly body?: ByteSource;
+    /** Consumer body intent, independent of method. Omitted means "read".
+     * "omit" permits an empty body; "omit-on-http-error" permits it only for
+     * status >= 400. Neither changes the HTTP request or response status/headers. */
+    readonly responseBodyMode?: "omit" | "omit-on-http-error" | "read";
+    readonly signal: AbortSignal;
+    /** Deadline for DNS, TCP and TLS setup only; absent means no separate connection deadline. */
+    readonly connectTimeoutMs?: number;
+    readonly registerCleanup?: (cleanup: InvocationCleanup) => void;
+    readonly denyPrivateNetworks?: true;
+}
+export interface HttpResponse {
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers: HttpHeaders;
+    readonly httpVersion?: string;
+    readonly body: ByteSource;
+    /** True when the host already decoded Content-Encoding; encoded length is then unavailable. */
+    readonly contentDecoded?: boolean;
+    dispose(): Promise<void>;
+}
+export type HttpTransport = ((request: HttpRequest) => Promise<HttpResponse>) & {
+    readonly supportsRequestCa?: true;
+    readonly supportedHttpVersions?: readonly ("1.0" | "1.1")[];
+    readonly supportsIgnoreContentLength?: true;
+    readonly supportsPrivateNetworkDeny?: true;
+    readonly supportsConnectTimeout?: true;
+};

package/dist/safe-bash-contracts/http.js

@@ -0,0 +1,6 @@
+import {
+  init_buffer
+} from "../safe-bash/command-chunks/chunk-HX3SHTCE.js";
+
+// packages/safe-bash-contracts/dist/http.js
+init_buffer();