@poe-platform/safe-bash 0.1.814 → 0.1.816

package/dist/safe-bash-command-patch/unified.d.ts

@@ -1,22 +1,27 @@
 import { Budget } from "../safe-bash-diff-engine/shared.js";
+import { type PatchText } from "./patch-text.js";
 export interface PatchLine {
     readonly kind: " " | "+" | "-";
     text: string;
 }
-export interface Hunk<Lines = PatchLine[]> {
+export interface ParsedPatchLine {
+    readonly kind: PatchLine["kind"];
+    readonly text: PatchText;
+}
+export interface Hunk<Lines = PatchLine[], Section = string> {
     readonly oldStart: number;
     readonly oldCount: number;
     readonly newStart: number;
     readonly newCount: number;
     readonly lines: Lines;
-    readonly section?: string;
+    readonly section?: Section;
 }
-export interface FilePatch<Lines = PatchLine[]> {
+export interface FilePatch<Lines = PatchLine[], Hunks = Hunk<Lines>[]> {
     readonly oldPath: string;
     readonly newPath: string;
     readonly oldEpoch: boolean;
     readonly newEpoch: boolean;
-    readonly hunks: Hunk<Lines>[];
+    readonly hunks: Hunks;
     readonly oldHeader?: string;
     readonly newHeader?: string;
     readonly indexPath?: string;
@@ -26,7 +31,9 @@ export interface FilePatch<Lines = PatchLine[]> {
 export declare function startIndex(start: number, count: number): number;
 export interface PatchInput {
     readonly length: number;
-    read(index: number): Promise<string | undefined>;
+    read(index: number, prefix?: number): Promise<string | undefined>;
+    matches?(index: number, text: string): Promise<boolean>;
+    body?(index: number, skip: number, incomplete: boolean): Promise<PatchText>;
 }
 export interface UnifiedCursor {
     readonly lines: readonly string[];
@@ -40,12 +47,19 @@ export declare function parseUnified(text: string | PatchInput, budget: Budget):
 export declare function parseUnifiedSection(cursor: IndexedUnifiedCursor | UnifiedCursor, budget: Budget): Promise<FilePatch[]>;
 export interface HunkLineBuilder<Lines> {
     readonly lines: Lines;
-    append(line: PatchLine): void | Promise<void>;
+    append(line: ParsedPatchLine): void | Promise<void>;
+}
+export interface HunkBuilder<Lines, Hunks> {
+    readonly hunks: Hunks;
+    append(hunk: Hunk<Lines, PatchText>): void | Promise<void>;
 }
 export declare function parseUnifiedReader<Lines>(cursor: IndexedUnifiedCursor, budget: Budget, single: boolean, createLines: () => HunkLineBuilder<Lines>): Promise<FilePatch<Lines>[]>;
+export declare function parseUnifiedReader<Lines, Hunks extends {
+    readonly length: number;
+}>(cursor: IndexedUnifiedCursor, budget: Budget, single: boolean, createLines: () => HunkLineBuilder<Lines>, createHunks: () => HunkBuilder<Lines, Hunks>): Promise<FilePatch<Lines, Hunks>[]>;
 export declare function reversePatch(patch: FilePatch): FilePatch;
-export interface HunkOutcome<Lines = PatchLine[]> {
-    readonly hunk: Hunk<Lines>;
+export interface HunkOutcome<Lines = PatchLine[], Section = string> {
+    readonly hunk: Hunk<Lines, Section>;
     readonly index: number;
     readonly failed: boolean;
     readonly mergeRange?: readonly [number, number];

package/dist/safe-bash-command-patch/unified.js

@@ -5,8 +5,9 @@ import {
   parseUnifiedSection,
   reversePatch,
   startIndex
-} from "../safe-bash/command-chunks/chunk-VT7UBPAE.js";
+} from "../safe-bash/command-chunks/chunk-ALD53QFL.js";
 import "../safe-bash/command-chunks/chunk-AJEQUVDN.js";
+import "../safe-bash/command-chunks/chunk-KHUT7BB5.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   applyHunks,

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

@@ -481,7 +481,7 @@ async function* retainedInfoUpdates(chunks, signal) {
 }
 
 // packages/safe-bash-command-pdftk/src/retained-burst.ts
-import { createRetainedPageCopy as createRetainedPageCopy2, saveRetainedDocumentChunks } from "../pdf-ast/index.js";
+import { editRetainedDocument as editRetainedDocument2, createRetainedPageCopy as createRetainedPageCopy2, saveRetainedDocumentChunks } from "../pdf-ast/index.js";
 
 // packages/safe-bash-command-pdftk/src/retained-inspection.ts
 import { IntegerTable as IntegerTable3, PagedStorage as PagedStorage3 } from "@poe-platform/safe-fs/storage";
@@ -827,17 +827,20 @@ async function* retainedBurst(document, storage, options, pageCount, signal) {
     const path = formatBurstFilename(pattern, index + 1);
     if (path === "-" || path === report) continue;
     const copy = await createRetainedPageCopy2(document, [index], storage, { signal });
+    let edited;
     let failed = false;
     try {
-      const chunks = options.compressStreams || options.uncompressStreams ? saveRetainedDocumentChunks(await copy.openDocument(), storage, { signal, streamMode: options.uncompressStreams ? "uncompress" : "compress" }) : copy.chunks();
+      if (options.shouldFlatten) edited = await editRetainedDocument2(await copy.openDocument(), storage, { signal, flattenForms: true });
+      const chunks = options.compressStreams || options.uncompressStreams || edited ? saveRetainedDocumentChunks(edited?.document ?? await copy.openDocument(), storage, { signal, streamMode: options.uncompressStreams ? "uncompress" : options.compressStreams ? "compress" : "preserve" }) : copy.chunks();
       yield { path, chunks };
     } catch (error) {
       failed = true;
       throw error;
     } finally {
-      await copy.close().catch((error) => {
-        if (!failed) throw error;
-      });
+      const results = await Promise.allSettled([edited?.close(), copy.close()]);
+      if (!failed) {
+        for (const result of results) if (result.status === "rejected") await Promise.reject(result.reason);
+      }
     }
   }
   yield { path: report, chunks: retainedInspectionReport(document, storage, false, signal, "document") };
@@ -876,22 +879,29 @@ async function* retainedRotations(args, handles, primaryHandle, pageCount, stora
 }
 
 // packages/safe-bash-command-pdftk/src/retained-output.ts
-import { editRetainedDocument as editRetainedDocument2, PdfFileSource as PdfFileSource3, PdfMutableObjectStore as PdfMutableObjectStore4, PdfRetainedDocument, cosBool, dictDelete, dictGet as dictGet4, dictSet as dictSet2, encryptRetainedPdfChunks, retainedCosObjects, saveRetainedDocumentChunks as saveRetainedDocumentChunks2 } from "../pdf-ast/index.js";
-async function* retainedOutput(source, storage, options, selectedId, signal, handles, pageCount, attachments, attachmentPage, stamps, info) {
+import { parseRetainedFormData, editRetainedDocument as editRetainedDocument3, PdfFileSource as PdfFileSource3, PdfMutableObjectStore as PdfMutableObjectStore4, PdfRetainedDocument, cosBool, cosName, dictDelete, dictGet as dictGet4, dictSet as dictSet2, encryptRetainedPdfChunks, retainedCosObjects, saveRetainedDocumentChunks as saveRetainedDocumentChunks2 } from "../pdf-ast/index.js";
+async function* retainedOutput(source, storage, options, selectedId, signal, handles, pageCount, attachments, attachmentPage, stamps, info, formData) {
   const infoUpdates = info?.updates;
+  const flattenForms = options.operation === "flatten" || options.shouldFlatten && ["output", "fill_form", "cat", "shuffle", "stamp", "multistamp", "background", "multibackground"].includes(options.operation);
   const store = new PdfMutableObjectStore4(storage, { signal });
   let edited;
   let document, plaintext, failed = false;
   try {
-    if (options.operation === "attach_files" || stamps || infoUpdates) {
+    if (options.operation === "attach_files" || stamps || infoUpdates || formData || flattenForms) {
       const pageIndex = attachmentPage !== void 0 && pageCount > 0 ? attachmentPage.toLowerCase() === "end" ? pageCount - 1 : Math.max(0, Math.min(pageCount - 1, (Number.parseInt(attachmentPage, 10) || 1) - 1)) : void 0;
-      edited = await editRetainedDocument2(source, storage, { signal, ...infoUpdates ? { infoUpdates } : {}, ...options.operation === "attach_files" ? { appendAttachments: attachments } : {}, ...stamps ? { stamps } : {}, ...pageIndex !== void 0 ? { attachmentPageIndex: pageIndex } : {} });
+      edited = await editRetainedDocument3(source, storage, { signal, flattenForms, ...formData ? { formUpdates: parseRetainedFormData(formData, storage, { signal }) } : {}, ...infoUpdates ? { infoUpdates } : {}, ...options.operation === "attach_files" ? { appendAttachments: attachments } : {}, ...stamps ? { stamps } : {}, ...pageIndex !== void 0 ? { attachmentPageIndex: pageIndex } : {} });
     }
     const input = edited?.document ?? source;
     const pageReferences = edited ? { pageReferences: async function* () {
       for await (const page of input.pages()) if (page.reference) yield page.reference;
     } } : {};
-    for await (const object of retainedCosObjects(input, storage, { signal })) await store.set(object);
+    for await (const object of retainedCosObjects(input, storage, { signal })) {
+      if (formData && options.replacementFont && object.value.kind === "dict") {
+        const subtype = dictGet4(object.value, "Subtype"), font = dictGet4(object.value, "BaseFont");
+        if (subtype?.kind === "name" && subtype.decoded === "Type1" && font?.kind === "name" && font.decoded === "Helvetica") dictSet2(object.value, "BaseFont", cosName(options.replacementFont.startsWith("/") ? options.replacementFont.slice(1) : options.replacementFont));
+      }
+      await store.set(object);
+    }
     const reference = input.crossReference;
     const chosenId = info?.useUpdatedId ? reference.idArray : selectedId;
     const idArray = options.keepFinalId || options.keepFirstId ? chosenId ?? reference.idArray : reference.idArray ?? chosenId;
@@ -901,7 +911,7 @@ async function* retainedOutput(source, storage, options, selectedId, signal, han
       const form = await document.lookup(dictGet4(root.value, "AcroForm"));
       if (form?.value.kind === "dict" && !form.stream) {
         if (options.dropXfa) dictDelete(form.value, "XFA");
-        if (options.needAppearances) dictSet2(form.value, "NeedAppearances", cosBool(true));
+        if (!options.shouldFlatten && (formData || options.needAppearances)) dictSet2(form.value, "NeedAppearances", cosBool(options.needAppearances));
         if (form.reference) await store.set({ objectNumber: form.reference.objectNumber, generationNumber: form.reference.generationNumber, value: form.value });
         else dictSet2(root.value, "AcroForm", form.value);
       }
@@ -1159,6 +1169,7 @@ async function executeRetainedPdftk(context, options) {
   let selectedId;
   const counts = /* @__PURE__ */ new Map();
   const inputs = /* @__PURE__ */ new Map();
+  const formPath = options.operation === "fill_form" ? options.opArgs[0] ?? "-" : void 0;
   const infoPath = options.operation === "update_info" || options.operation === "update_info_utf8" ? options.opArgs[0] ?? "-" : void 0;
   const overlayPath = ["stamp", "multistamp", "background", "multibackground"].includes(options.operation) ? options.opArgs[0] ?? "-" : void 0;
   const attachmentPaths = [];
@@ -1183,13 +1194,13 @@ async function executeRetainedPdftk(context, options) {
   try {
     await context.fs.mkdir(storage.directory, { recursive: true, signal });
     const maximum = context.inputBudget?.maxBytes ?? Infinity;
-    if (options.inputs.some((input) => input.file === "-") || attachmentPaths.includes("-") || overlayPath === "-" || infoPath === "-") {
+    if (options.inputs.some((input) => input.file === "-") || attachmentPaths.includes("-") || overlayPath === "-" || infoPath === "-" || formPath === "-") {
       const source = await PdfFileSource5.fromStream(context.fs, storage.directory, context.stdin, { signal, maxInputBytes: maximum });
       inputs.set("-", source);
       total += source.size;
       context.inputBudget?.check(total);
     }
-    for (const input of [...options.inputs, ...attachmentPaths.map((file) => ({ file })), ...overlayPath !== void 0 ? [{ file: overlayPath }] : [], ...infoPath !== void 0 ? [{ file: infoPath }] : []]) {
+    for (const input of [...options.inputs, ...attachmentPaths.map((file) => ({ file })), ...overlayPath !== void 0 ? [{ file: overlayPath }] : [], ...infoPath !== void 0 ? [{ file: infoPath }] : [], ...formPath !== void 0 ? [{ file: formPath }] : []]) {
       if (inputs.has(input.file)) continue;
       let source;
       try {
@@ -1231,6 +1242,9 @@ async function executeRetainedPdftk(context, options) {
       await source.releaseCache();
     }
     document = await PdfRetainedDocument2.open(inputs.get(primary.file), storage, { signal, recovery: "strict", ...primary.password ? { password: primary.password } : {} });
+    const formSource = formPath === void 0 ? void 0 : inputs.get(formPath);
+    if (formPath !== void 0 && !formSource) return await diagnostic(`Error: Unable to open form data file '${formPath}'
+`);
     const infoSource = infoPath === void 0 ? void 0 : inputs.get(infoPath);
     if (infoPath !== void 0 && !infoSource) return await diagnostic(`Error: Unable to open info file '${infoPath}'
 `);
@@ -1266,7 +1280,7 @@ async function executeRetainedPdftk(context, options) {
     if (options.operation === "cat" || options.operation === "shuffle") {
       assembled = await assembleRetainedPdftk(document, storage, options, counts, handles, async (input) => PdfRetainedDocument2.open(inputs.get(input.file), storage, { signal, recovery: "strict", ...input.password ? { password: input.password } : {} }), signal);
     }
-    output = await PdfFileSource5.fromStream(context.fs, storage.directory, ["output", "rotate", "attach_files", "stamp", "multistamp", "background", "multibackground", "update_info", "update_info_utf8", "cat", "shuffle"].includes(options.operation) ? retainedOutput(assembled?.document ?? document, storage, options, selectedId, signal, new Map([...handles].map(([handle, input]) => [handle, { pageCount: counts.get(input) }])), counts.get(primary), attachments(), attachmentPage, overlayDocument ? [{ source: overlayDocument, mode: options.operation.includes("background") ? "underlay" : "overlay", preserveStreams: true, pages: stampPages() }] : void 0, infoSource ? { updates: retainedInfoUpdates(infoSource.stream(0, infoSource.size, signal), signal), useUpdatedId: idInput === primary } : void 0) : options.operation === "generate_fdf" ? retainedFdf(document, storage, signal) : options.operation === "dump_data_fields" || options.operation === "dump_data_fields_utf8" ? retainedFieldReport(document, options.operation.endsWith("_utf8"), signal) : retainedInspectionReport(document, storage, options.operation.endsWith("_utf8"), signal, options.operation === "dump_data" || options.operation === "dump_data_utf8" ? "document" : "annotations"), { signal });
+    output = await PdfFileSource5.fromStream(context.fs, storage.directory, ["output", "rotate", "attach_files", "stamp", "multistamp", "background", "multibackground", "update_info", "update_info_utf8", "cat", "shuffle", "fill_form", "flatten"].includes(options.operation) ? retainedOutput(assembled?.document ?? document, storage, options, selectedId, signal, new Map([...handles].map(([handle, input]) => [handle, { pageCount: counts.get(input) }])), counts.get(primary), attachments(), attachmentPage, overlayDocument ? [{ source: overlayDocument, mode: options.operation.includes("background") ? "underlay" : "overlay", preserveStreams: true, pages: stampPages() }] : void 0, infoSource ? { updates: retainedInfoUpdates(infoSource.stream(0, infoSource.size, signal), signal), useUpdatedId: idInput === primary } : void 0, formSource) : options.operation === "generate_fdf" ? retainedFdf(document, storage, signal) : options.operation === "dump_data_fields" || options.operation === "dump_data_fields_utf8" ? retainedFieldReport(document, options.operation.endsWith("_utf8"), signal) : retainedInspectionReport(document, storage, options.operation.endsWith("_utf8"), signal, options.operation === "dump_data" || options.operation === "dump_data_utf8" ? "document" : "annotations"), { signal });
     const destination = options.outputTarget;
     if (!destination || destination === "-") for await (const bytes of output.stream(0, output.size, signal)) await writeBytes(context.stdout, bytes, signal);
     else {
@@ -1485,22 +1499,20 @@ function* parsePdftkArgumentsSteps(argv) {
 }
 
 // packages/safe-bash-command-pdftk/src/index.ts
-import { resolvePath as resolvePath2 } from "../safe-bash-contracts/path.js";
-import { yieldTurn, drainCooperativeSteps as drainSteps } from "../safe-bash-contracts/yield.js";
+import { drainCooperativeSteps as drainSteps } from "../safe-bash-contracts/yield.js";
 import { InputByteBudget } from "../safe-bash-contracts/io.js";
-import { writeFileOutput as writeFileOutput2 } from "../safe-bash-contracts/filesystem-output-budget.js";
 import {
   commandRuntimeIdentity,
   getCommandArguments
 } from "../safe-bash-contracts/command.js";
-import { readBytes, writeBytes as writeBytes2 } from "../safe-bash-contracts/io.js";
+import { writeBytes as writeBytes2 } from "../safe-bash-contracts/io.js";
 import { createOutputOperation } from "../safe-bash-contracts/output.js";
 import {
   PdfDocument,
   cosArray as cosArray4,
   cosDict as cosDict4,
   cosHexString,
-  cosName,
+  cosName as cosName2,
   cosNumber as cosNumber4,
   cosStream,
   cosString as cosString4,
@@ -2124,7 +2136,7 @@ function setDocumentBookmarks(doc, bookmarks) {
   if (bookmarks.length === 0 || doc.pageCount === 0) return;
   const catalog = doc.cos.resolveDict(doc.cos.rootRef);
   if (!catalog) return;
-  const outlinesDict = cosDict4({ Type: cosName("Outlines") });
+  const outlinesDict = cosDict4({ Type: cosName2("Outlines") });
   const outlinesRef = doc.cos.allocateObject(outlinesDict);
   dictSet3(catalog, "Outlines", outlinesRef);
   const stack = [{ ref: outlinesRef, dict: outlinesDict, children: [] }];
@@ -2148,7 +2160,7 @@ function setDocumentBookmarks(doc, bookmarks) {
     const itemDict = cosDict4({
       Title: cosString4(bm.title),
       Parent: parentState.ref,
-      Dest: cosArray4([pageRef, cosName("XYZ"), { kind: "null" }, { kind: "null" }, { kind: "null" }])
+      Dest: cosArray4([pageRef, cosName2("XYZ"), { kind: "null" }, { kind: "null" }, { kind: "null" }])
     });
     const itemRef = doc.cos.allocateObject(itemDict);
     const prevSibling = parentState.children[parentState.children.length - 1];
@@ -2346,7 +2358,7 @@ function applyUpdateInfoText(doc, text) {
         }
         const pdfStyle = PAGE_LABEL_STYLE_TO_PDF[pl.style];
         if (pdfStyle) {
-          lblEntries.S = cosName(pdfStyle);
+          lblEntries.S = cosName2(pdfStyle);
         }
         numsItems.push(cosDict4(lblEntries));
       }
@@ -2381,13 +2393,13 @@ function attachFilesToDocument(doc, filePaths, files, toPageSpec) {
     const baseName = fp.slice(fp.lastIndexOf("/") + 1);
     const efStreamRef = doc.cos.allocateObject(
       cosStream(bytes, {
-        dict: cosDict4({ Type: cosName("EmbeddedFile") }),
+        dict: cosDict4({ Type: cosName2("EmbeddedFile") }),
         compress: true
       })
     );
     const filespecRef = doc.cos.allocateObject(
       cosDict4({
-        Type: cosName("Filespec"),
+        Type: cosName2("Filespec"),
         F: cosString4(baseName),
         UF: cosString4(baseName),
         EF: cosDict4({ F: efStreamRef })
@@ -2403,9 +2415,9 @@ function attachFilesToDocument(doc, filePaths, files, toPageSpec) {
       }
       const annotRef = doc.cos.allocateObject(
         cosDict4({
-          Type: cosName("Annot"),
-          Subtype: cosName("FileAttachment"),
-          Name: cosName("PushPin"),
+          Type: cosName2("Annot"),
+          Subtype: cosName2("FileAttachment"),
+          Name: cosName2("PushPin"),
           Contents: cosString4(baseName),
           FS: filespecRef,
           Rect: cosArray4([cosNumber4(20), cosNumber4(20), cosNumber4(40), cosNumber4(40)])
@@ -2965,7 +2977,7 @@ function* runPdftkCliSteps(argv, files, signal) {
         const subtype = stNode?.kind === "name" ? stNode.decoded : void 0;
         const baseFont = bfNode?.kind === "name" ? bfNode.decoded : void 0;
         if (subtype === "Type1" && baseFont === "Helvetica") {
-          dictSet3(obj.value, "BaseFont", cosName(cleanFontName));
+          dictSet3(obj.value, "BaseFont", cosName2(cleanFontName));
         }
       }
     }
@@ -3054,104 +3066,15 @@ function runPdftkCliSync(argv, files, signal) {
   return next.value;
 }
 async function executePdftk(context, retainedContext = context) {
-  let cooperativeWork = 63;
   const invocation = createOutputOperation(context, { write: async () => {
   } });
   try {
-    const carrier = getCommandArguments(context);
-    const argv = [...carrier.args];
-    const parsed = await drainSteps(parsePdftkArgumentsSteps(argv), invocation.signal);
-    if (parsed.options && (["output", "rotate", "attach_files", "stamp", "multistamp", "background", "multibackground", "burst", "update_info", "update_info_utf8", "cat", "shuffle"].includes(parsed.options.operation) && !parsed.options.shouldFlatten || ["dump_data", "dump_data_utf8", "dump_data_annots", "dump_data_annots_utf8", "dump_data_fields", "dump_data_fields_utf8", "generate_fdf", "unpack_files"].includes(parsed.options.operation))) {
-      return await executeRetainedPdftk({ ...retainedContext, signal: invocation.signal, stdout: invocation.child(context.stdout).output }, parsed.options);
-    }
-    const vfsFiles = /* @__PURE__ */ new Map();
-    let accountedBytes = 0;
-    const chargeBytes = (delta) => {
-      if (delta > 0) {
-        accountedBytes += delta;
-        context.inputBudget?.check(accountedBytes);
-      }
-    };
-    const inputPaths = [];
-    let operandIndex = 0;
-    while (operandIndex < argv.length && !PDFTK_OPERATIONS.has(argv[operandIndex].toLowerCase())) {
-      const token = argv[operandIndex++];
-      const eq = token.indexOf("=");
-      inputPaths.push(eq > 0 ? token.slice(eq + 1) : token);
-    }
-    while (argv[operandIndex]?.toLowerCase() === "input_pw") {
-      operandIndex++;
-      while (operandIndex < argv.length && !PDFTK_OPERATIONS.has(argv[operandIndex].toLowerCase())) operandIndex++;
-    }
-    const operation = argv[operandIndex++]?.toLowerCase();
-    if (["update_info", "update_info_utf8", "fill_form", "background", "multibackground", "stamp", "multistamp"].includes(operation ?? "")) {
-      const operand = argv[operandIndex];
-      inputPaths.push(operand && !PDFTK_OPERATIONS.has(operand.toLowerCase()) ? operand : "-");
-    } else if (operation === "attach_files") {
-      while (operandIndex < argv.length && !PDFTK_OPERATIONS.has(argv[operandIndex].toLowerCase())) {
-        const token = argv[operandIndex++];
-        if (token.toLowerCase() === "to_page") operandIndex++;
-        else inputPaths.push(token);
-      }
-    }
-    if (inputPaths.includes("-")) {
-      const chunks = [];
-      let total = 0;
-      for await (const chunk of readBytes(context.stdin, invocation.signal)) {
-        if (++cooperativeWork % 64 === 0) await yieldTurn(context.signal);
-        chunks.push(chunk);
-        total += chunk.byteLength;
-        chargeBytes(chunk.byteLength);
-      }
-      const buf = new Uint8Array(total);
-      let off = 0;
-      for (const c of chunks) {
-        if (++cooperativeWork % 64 === 0) await yieldTurn(context.signal);
-        buf.set(c, off);
-        off += c.byteLength;
-      }
-      vfsFiles.set("-", buf);
-    }
-    for (const filePath of new Set(inputPaths)) {
-      if (++cooperativeWork % 64 === 0) await yieldTurn(context.signal);
-      if (filePath === "-") continue;
-      try {
-        const bytes = await context.fs.readFile(resolvePath2(context.cwd, filePath), { signal: invocation.signal });
-        chargeBytes(bytes.byteLength);
-        vfsFiles.set(filePath, bytes);
-      } catch {
-      }
-    }
+    const parsed = await drainSteps(parsePdftkArgumentsSteps([...getCommandArguments(context).args]), invocation.signal);
+    if (parsed.options) return await executeRetainedPdftk({ ...retainedContext, signal: invocation.signal, stdout: invocation.child(context.stdout).output }, parsed.options);
     context.inputBudget?.check(0);
-    const existingSnap = new Map(vfsFiles);
-    const res = await runPdftkCli(argv, vfsFiles, invocation.signal);
-    if (res.stderr) {
-      await writeBytes2(context.stderr, new TextEncoder().encode(res.stderr), invocation.signal);
-    }
-    if (res.stdoutBytes) {
-      const stdout = invocation.child(context.stdout);
-      await writeBytes2(stdout.output, res.stdoutBytes, invocation.signal);
-    } else if (res.stdout) {
-      const outBytes = new TextEncoder().encode(res.stdout);
-      const stdout = invocation.child(context.stdout);
-      await writeBytes2(stdout.output, outBytes, invocation.signal);
-    }
-    for (const [key, val] of vfsFiles.entries()) {
-      if (++cooperativeWork % 64 === 0) await yieldTurn(context.signal);
-      if (key !== "-" && existingSnap.get(key) !== val) {
-        const abs = resolvePath2(context.cwd, key);
-        try {
-          await writeFileOutput2(context, val, (data) => context.fs.writeFile(abs, data, { signal: invocation.signal }));
-        } catch (error) {
-          invocation.signal.throwIfAborted();
-          if (!(error instanceof Error) || !("code" in error)) throw error;
-          await writeBytes2(context.stderr, new TextEncoder().encode(`Error: Failed to open output file '${key}': ${error.code}.
-`), invocation.signal);
-          return { exitCode: 1 };
-        }
-      }
-    }
-    return { exitCode: res.exitCode };
+    if (parsed.result.stderr) await writeBytes2(context.stderr, new TextEncoder().encode(parsed.result.stderr), invocation.signal);
+    if (parsed.result.stdout) await writeBytes2(invocation.child(context.stdout).output, new TextEncoder().encode(parsed.result.stdout), invocation.signal);
+    return { exitCode: parsed.result.exitCode };
   } finally {
     await invocation.close();
   }