@poe-platform/safe-bash 0.1.823 → 0.1.825

package/dist/safe-bash/command-chunks/{chunk-EO3RYGUZ.js → chunk-LFTGMUAV.js}

@@ -1,17 +1,20 @@
 import {
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,
-  openPythonPackageFile,
-  pythonDocumentPackages,
-  stagePythonPackage
-} from "./chunk-WDTWJFPK.js";
+  publishPythonBuildWheel,
+  pythonDocumentPackages
+} from "./chunk-RZOHZGEZ.js";
 import {
   pythonShellDispatchActive
 } from "./chunk-NHAG4DWL.js";
+import {
+  openPythonPackageFile
+} from "./chunk-NXCJNPL3.js";
 import {
   PythonInvocationError,
-  parsePythonInvocation
-} from "./chunk-64HIOP7Q.js";
+  parsePythonInvocation,
+  pythonPackageUrlHash
+} from "./chunk-WY6THI6J.js";
 import {
   pythonLlmProvider
 } from "./chunk-YYRVGXJH.js";
@@ -113,11 +116,13 @@ function encodePythonReply(value, maxBytes) {
 }
 
 // packages/safe-bash-command-python/src/installation.ts
-var pythonInstallationHelp = `Usage: python -m pip install [-r/--requirement FILE] [OPTIONS] PACKAGE ...
+var PythonInstallationError = class extends Error {
+};
+var pythonInstallationHelp = `Usage: python -m pip install [OPTIONS] PACKAGE ...
        python -m pip uninstall [-y/--yes] PACKAGE ...
-Install options: --pre, -U/--upgrade, --force-reinstall, --no-cache-dir
-Compatible wheels; configure transport with the Python package SDK.
-Both accept -h/--help and --. Other pip operations are unsupported.
+Install: -r/--requirement FILE, -e/--editable PATH, --pre, -U/--upgrade,
+         --force-reinstall, --no-cache-dir
+Both accept -h/--help and --.
 `;
 function parsePythonInstallation(pipArgs) {
   const controls = {};
@@ -138,12 +143,9 @@ function parsePythonInstallation(pipArgs) {
       packages.push(option);
       continue;
     }
-    if (!uninstall && (option === "--pre" || option === "--no-cache-dir")) {
-      controls[option === "--pre" ? "pre" : "noCache"] = true;
-      continue;
-    }
-    if (!uninstall && (option === "-U" || option === "--upgrade" || option === "--force-reinstall")) {
-      controls[option === "--force-reinstall" ? "forceReinstall" : "upgrade"] = true;
+    const flag = { "--pre": "pre", "--no-cache-dir": "noCache", "-U": "upgrade", "--upgrade": "upgrade", "--force-reinstall": "forceReinstall" }[option];
+    if (!uninstall && flag) {
+      controls[flag] = true;
       continue;
     }
     if (option === "--") {
@@ -158,15 +160,19 @@ function parsePythonInstallation(pipArgs) {
       yes = true;
       continue;
     }
-    if (!uninstall && (option === "-r" || option === "--requirement" || option.startsWith("--requirement=") || option.startsWith("-r"))) {
-      const path = option.startsWith("--requirement=") ? option.slice("--requirement=".length) : option !== "-r" && option.startsWith("-r") ? option.slice(2) : pipArgs[++index];
-      if (!path || path.startsWith("-")) throw new PythonInvocationError(option + " requires a path");
-      requirements.push(path);
-      continue;
+    if (!uninstall) {
+      const kind = ["requirement", "editable"].find((name) => option.startsWith("-" + name[0]) || option.split("=", 1)[0] === "--" + name);
+      if (kind) {
+        const prefix = "--" + kind;
+        const path = option.startsWith(prefix + "=") ? option.slice(prefix.length + 1) : option === prefix || option.length === 2 ? pipArgs[++index] : option.slice(2);
+        if (!path || path.startsWith("-")) throw new PythonInvocationError(option + " requires a path");
+        (kind === "editable" ? controls.editable ??= [] : requirements).push(path);
+        continue;
+      }
     }
     throw new PythonInvocationError("unsupported pip option " + option);
   }
-  if (!help && packages.length === 0 && requirements.length === 0) throw new PythonInvocationError("pip " + pipArgs[0] + " requires at least one package or requirements file");
+  if (!help && packages.length === 0 && requirements.length === 0 && !controls.editable?.length) throw new PythonInvocationError("pip " + pipArgs[0] + " requires at least one package or requirements file");
   return { packages, requirements, help, controls, ...uninstall ? { uninstall, yes } : {} };
 }
 
@@ -845,7 +851,7 @@ function createPythonLlmToolLoader(options) {
     const queue = [];
     let waiter;
     let serial3 = 0, controls = 0, loaded = false, initializationFailed = false, closed = false, closing;
-    const encoder = new TextEncoder();
+    const encoder2 = new TextEncoder();
     const fail = (error) => {
       ready.reject(error);
       queue.length = 0;
@@ -930,7 +936,7 @@ function createPythonLlmToolLoader(options) {
         return null;
       }
       if (message.op === "register" || message.op === "toolbox" || message.op === "plugins") {
-        controls += encoder.encode(JSON.stringify(message)).length;
+        controls += encoder2.encode(JSON.stringify(message)).length;
         if (controls > maxInputBytes) throw new RangeError("Python tool definition byte limit exceeded");
       }
       if (message.op === "plugins") {
@@ -1000,7 +1006,7 @@ function createPythonLlmToolLoader(options) {
         let bytes, target = job.output;
         if (message.op === "text") {
           if (typeof message.text !== "string" || message.text.length > 8192) throw new TypeError("Invalid Python tool output window");
-          bytes = encoder.encode(message.text);
+          bytes = encoder2.encode(message.text);
           if (bytes.length > 16384) throw new TypeError("Invalid Python tool output window");
         } else {
           if (!Array.isArray(message.bytes) || message.bytes.length > 4096 || message.bytes.some((value2) => typeof value2 !== "number" || !Number.isInteger(value2) || value2 < 0 || value2 > 255)) throw new TypeError("Invalid Python attachment window");
@@ -1016,7 +1022,7 @@ function createPythonLlmToolLoader(options) {
       if (message.op === "attachment") {
         const metadata = record(message.descriptor);
         if (typeof metadata.mimeType !== "string" || typeof metadata.id !== "string" || metadata.url !== void 0 && typeof metadata.url !== "string") throw new TypeError("Invalid Python tool attachment");
-        const size = encoder.encode(JSON.stringify(metadata)).length;
+        const size = encoder2.encode(JSON.stringify(metadata)).length;
         if (size > job.limit - job.bytes) throw new RangeError("Python tool attachment metadata limit exceeded");
         job.bytes += size;
         const index = job.attachments.length;
@@ -1097,6 +1103,7 @@ function createPythonLlmToolLoader(options) {
 function createPythonBuildEnvironment(options = {}) {
   const manifestStore = createPythonPackageManifestStore({ maxEntries: 1, ...options.maxManifestBytes === void 0 ? {} : { maxBytes: options.maxManifestBytes } });
   const isolated = { ...options, manifestStore, scope: "build" };
+  delete isolated.editable;
   delete isolated.requirements;
   delete isolated.requirementFiles;
   delete isolated.profile;
@@ -1110,14 +1117,58 @@ function createPythonBuildEnvironment(options = {}) {
 // packages/safe-bash-command-python/src/build-dependencies.ts
 import { toByteSource as toByteSource6 } from "../../safe-bash-contracts/index.js";
 
+// packages/safe-bash-command-python/src/source-origin-program.generated.ts
+var pythonSourceOriginProgram = "def read_source_origin(request):\n import re, json\n from urllib.parse import urlsplit, urlunsplit\n source = request['source']\n if source.startswith('/'):\n  from pathlib import Path\n  source = Path(source).as_uri()\n url = urlsplit(source)\n netloc = url.netloc\n if '@' in netloc:\n  credentials, host = netloc.split('@', 1)\n  if not re.match(r'^\\$\\{[A-Za-z0-9-_]+\\}(:\\$\\{[A-Za-z0-9-_]+\\})?$', credentials): netloc = host\n result = {'url': urlunsplit((url.scheme, netloc, url.path, url.query, ''))}\n subdirectory = re.search(r'[#&]subdirectory=([^&]*)', source)\n if subdirectory: result['subdirectory'] = subdirectory.group(1)\n info = {}\n if not request['directory']:\n  hashed = re.search(r'(sha1|sha224|sha384|sha256|sha512|md5)=([a-f0-9]+)', source)\n  if hashed: info['hash'] = hashed.group(1) + '=' + hashed.group(2)\n result['dir_info' if request['directory'] else 'archive_info'] = info\n return json.dumps(result, sort_keys=True)\n";
+
+// packages/safe-bash-command-python/src/source-filename-program.ts
+var pythonDownloadFilenameProgram = /* @__PURE__ */ (() => String.raw`
+MIME_PREFERENCES = {"application/andrew-inset":".ez","application/applixware":".aw","application/atom+xml":".atom","application/atomcat+xml":".atomcat","application/atomsvc+xml":".atomsvc","application/ccxml+xml":".ccxml","application/cdmi-capability":".cdmia","application/cdmi-container":".cdmic","application/cdmi-domain":".cdmid","application/cdmi-object":".cdmio","application/cdmi-queue":".cdmiq","application/cu-seeme":".cu","application/davmount+xml":".davmount","application/docbook+xml":".dbk","application/dssc+der":".dssc","application/dssc+xml":".xdssc","application/ecmascript":".ecma","application/emma+xml":".emma","application/epub+zip":".epub","application/exi":".exi","application/font-tdpfr":".pfr","application/gml+xml":".gml","application/gpx+xml":".gpx","application/gxf":".gxf","application/hyperstudio":".stk","application/inkml+xml":".ink","application/ipfix":".ipfix","application/java-archive":".jar","application/java-serialized-object":".ser","application/java-vm":".class","application/json":".json","application/jsonml+json":".jsonml","application/lost+xml":".lostxml","application/mac-binhex40":".hqx","application/mac-compactpro":".cpt","application/mads+xml":".mads","application/manifest+json":".webmanifest","application/marc":".mrc","application/marcxml+xml":".mrcx","application/mathematica":".ma","application/mathml+xml":".mathml","application/mbox":".mbox","application/mediaservercontrol+xml":".mscml","application/metalink+xml":".metalink","application/metalink4+xml":".meta4","application/mets+xml":".mets","application/mods+xml":".mods","application/mp21":".m21","application/mp4":".mp4s","application/msword":".doc","application/mxf":".mxf","application/octet-stream":".bin","application/oda":".oda","application/oebps-package+xml":".opf","application/ogg":".ogx","application/omdoc+xml":".omdoc","application/onenote":".onetoc","application/oxps":".oxps","application/patch-ops-error+xml":".xer","application/pdf":".pdf","application/pgp-encrypted":".pgp","application/pgp-signature":".asc","application/pics-rules":".prf","application/pkcs10":".p10","application/pkcs7-mime":".p7c","application/pkcs7-signature":".p7s","application/pkcs8":".p8","application/pkix-attr-cert":".ac","application/pkix-cert":".cer","application/pkix-crl":".crl","application/pkix-pkipath":".pkipath","application/pkixcmp":".pki","application/pls+xml":".pls","application/postscript":".ps","application/prs.cww":".cww","application/pskc+xml":".pskcxml","application/rdf+xml":".rdf","application/reginfo+xml":".rif","application/relax-ng-compact-syntax":".rnc","application/resource-lists+xml":".rl","application/resource-lists-diff+xml":".rld","application/rls-services+xml":".rs","application/rpki-ghostbusters":".gbr","application/rpki-manifest":".mft","application/rpki-roa":".roa","application/rsd+xml":".rsd","application/rss+xml":".rss","application/rtf":".rtf","application/sbml+xml":".sbml","application/scvp-cv-request":".scq","application/scvp-cv-response":".scs","application/scvp-vp-request":".spq","application/scvp-vp-response":".spp","application/sdp":".sdp","application/set-payment-initiation":".setpay","application/set-registration-initiation":".setreg","application/shf+xml":".shf","application/smil+xml":".smi","application/sparql-query":".rq","application/sparql-results+xml":".srx","application/srgs":".gram","application/srgs+xml":".grxml","application/sru+xml":".sru","application/ssdl+xml":".ssdl","application/ssml+xml":".ssml","application/tei+xml":".tei","application/thraud+xml":".tfi","application/timestamped-data":".tsd","application/vnd.3gpp.pic-bw-large":".plb","application/vnd.3gpp.pic-bw-small":".psb","application/vnd.3gpp.pic-bw-var":".pvb","application/vnd.3gpp2.tcap":".tcap","application/vnd.3m.post-it-notes":".pwn","application/vnd.accpac.simply.aso":".aso","application/vnd.accpac.simply.imp":".imp","application/vnd.acucobol":".acu","application/vnd.acucorp":".atc","application/vnd.adobe.air-application-installer-package+zip":".air","application/vnd.adobe.formscentral.fcdt":".fcdt","application/vnd.adobe.fxp":".fxp","application/vnd.adobe.xdp+xml":".xdp","application/vnd.adobe.xfdf":".xfdf","application/vnd.ahead.space":".ahead","application/vnd.airzip.filesecure.azf":".azf","application/vnd.airzip.filesecure.azs":".azs","application/vnd.amazon.ebook":".azw","application/vnd.americandynamics.acc":".acc","application/vnd.amiga.ami":".ami","application/vnd.android.package-archive":".apk","application/vnd.anser-web-certificate-issue-initiation":".cii","application/vnd.anser-web-funds-transfer-initiation":".fti","application/vnd.antix.game-component":".atx","application/vnd.apple.installer+xml":".mpkg","application/vnd.aristanetworks.swi":".swi","application/vnd.astraea-software.iota":".iota","application/vnd.audiograph":".aep","application/vnd.blueice.multipass":".mpm","application/vnd.bmi":".bmi","application/vnd.businessobjects":".rep","application/vnd.chemdraw+xml":".cdxml","application/vnd.chipnuts.karaoke-mmd":".mmd","application/vnd.cinderella":".cdy","application/vnd.claymore":".cla","application/vnd.cloanto.rp9":".rp9","application/vnd.clonk.c4group":".c4g","application/vnd.cluetrust.cartomobile-config":".c11amc","application/vnd.cluetrust.cartomobile-config-pkg":".c11amz","application/vnd.commonspace":".csp","application/vnd.contact.cmsg":".cdbcmsg","application/vnd.cosmocaller":".cmc","application/vnd.crick.clicker":".clkx","application/vnd.crick.clicker.keyboard":".clkk","application/vnd.crick.clicker.palette":".clkp","application/vnd.crick.clicker.template":".clkt","application/vnd.crick.clicker.wordbank":".clkw","application/vnd.criticaltools.wbs+xml":".wbs","application/vnd.ctc-posml":".pml","application/vnd.cups-ppd":".ppd","application/vnd.curl.car":".car","application/vnd.curl.pcurl":".pcurl","application/vnd.dart":".dart","application/vnd.data-vision.rdz":".rdz","application/vnd.dece.data":".uvf","application/vnd.dece.ttml+xml":".uvt","application/vnd.dece.unspecified":".uvx","application/vnd.dece.zip":".uvz","application/vnd.denovo.fcselayout-link":".fe_launch","application/vnd.dna":".dna","application/vnd.dolby.mlp":".mlp","application/vnd.dpgraph":".dpg","application/vnd.dreamfactory":".dfac","application/vnd.ds-keypoint":".kpxx","application/vnd.dvb.ait":".ait","application/vnd.dvb.service":".svc","application/vnd.dynageo":".geo","application/vnd.ecowin.chart":".mag","application/vnd.enliven":".nml","application/vnd.epson.esf":".esf","application/vnd.epson.msf":".msf","application/vnd.epson.quickanime":".qam","application/vnd.epson.salt":".slt","application/vnd.epson.ssf":".ssf","application/vnd.eszigno3+xml":".es3","application/vnd.ezpix-album":".ez2","application/vnd.ezpix-package":".ez3","application/vnd.fdf":".fdf","application/vnd.fdsn.mseed":".mseed","application/vnd.fdsn.seed":".seed","application/vnd.flographit":".gph","application/vnd.fluxtime.clip":".ftc","application/vnd.framemaker":".fm","application/vnd.frogans.fnc":".fnc","application/vnd.frogans.ltf":".ltf","application/vnd.fsc.weblaunch":".fsc","application/vnd.fujitsu.oasys":".oas","application/vnd.fujitsu.oasys2":".oa2","application/vnd.fujitsu.oasys3":".oa3","application/vnd.fujitsu.oasysgp":".fg5","application/vnd.fujitsu.oasysprs":".bh2","application/vnd.fujixerox.ddd":".ddd","application/vnd.fujixerox.docuworks":".xdw","application/vnd.fujixerox.docuworks.binder":".xbd","application/vnd.fuzzysheet":".fzs","application/vnd.genomatix.tuxedo":".txd","application/vnd.geogebra.file":".ggb","application/vnd.geogebra.slides":".ggs","application/vnd.geogebra.tool":".ggt","application/vnd.geometry-explorer":".gex","application/vnd.geonext":".gxt","application/vnd.geoplan":".g2w","application/vnd.geospace":".g3w","application/vnd.gmx":".gmx","application/vnd.google-earth.kml+xml":".kml","application/vnd.google-earth.kmz":".kmz","application/vnd.grafeq":".gqf","application/vnd.groove-account":".gac","application/vnd.groove-help":".ghf","application/vnd.groove-identity-message":".gim","application/vnd.groove-injector":".grv","application/vnd.groove-tool-message":".gtm","application/vnd.groove-tool-template":".tpl","application/vnd.groove-vcard":".vcg","application/vnd.hal+xml":".hal","application/vnd.handheld-entertainment+xml":".zmm","application/vnd.hbci":".hbci","application/vnd.hhe.lesson-player":".les","application/vnd.hp-hpgl":".hpgl","application/vnd.hp-hpid":".hpid","application/vnd.hp-hps":".hps","application/vnd.hp-jlyt":".jlt","application/vnd.hp-pcl":".pcl","application/vnd.hp-pclxl":".pclxl","application/vnd.hydrostatix.sof-data":".sfd-hdstx","application/vnd.ibm.minipay":".mpy","application/vnd.ibm.modcap":".afp","application/vnd.ibm.rights-management":".irm","application/vnd.ibm.secure-container":".sc","application/vnd.iccprofile":".icc","application/vnd.igloader":".igl","application/vnd.immervision-ivp":".ivp","application/vnd.immervision-ivu":".ivu","application/vnd.insors.igm":".igm","application/vnd.intercon.formnet":".xpw","application/vnd.intergeo":".i2g","application/vnd.intu.qbo":".qbo","application/vnd.intu.qfx":".qfx","application/vnd.ipunplugged.rcprofile":".rcprofile","application/vnd.irepository.package+xml":".irp","application/vnd.is-xpr":".xpr","application/vnd.isac.fcs":".fcs","application/vnd.jam":".jam","application/vnd.jcp.javame.midlet-rms":".rms","application/vnd.jisp":".jisp","application/vnd.joost.joda-archive":".joda","application/vnd.kahootz":".ktz","application/vnd.kde.karbon":".karbon","application/vnd.kde.kchart":".chrt","application/vnd.kde.kformula":".kfo","application/vnd.kde.kivio":".flw","application/vnd.kde.kontour":".kon","application/vnd.kde.kpresenter":".kpr","application/vnd.kde.kspread":".ksp","application/vnd.kde.kword":".kwd","application/vnd.kenameaapp":".htke","application/vnd.kidspiration":".kia","application/vnd.kinar":".kne","application/vnd.koan":".skp","application/vnd.kodak-descriptor":".sse","application/vnd.las.las+xml":".lasxml","application/vnd.llamagraphics.life-balance.desktop":".lbd","application/vnd.llamagraphics.life-balance.exchange+xml":".lbe","application/vnd.lotus-1-2-3":".123","application/vnd.lotus-approach":".apr","application/vnd.lotus-freelance":".pre","application/vnd.lotus-notes":".nsf","application/vnd.lotus-organizer":".org","application/vnd.lotus-screencam":".scm","application/vnd.lotus-wordpro":".lwp","application/vnd.macports.portpkg":".portpkg","application/vnd.mcd":".mcd","application/vnd.medcalcdata":".mc1","application/vnd.mediastation.cdkey":".cdkey","application/vnd.mfer":".mwf","application/vnd.mfmp":".mfm","application/vnd.micrografx.flo":".flo","application/vnd.micrografx.igx":".igx","application/vnd.mif":".mif","application/vnd.mobius.daf":".daf","application/vnd.mobius.dis":".dis","application/vnd.mobius.mbk":".mbk","application/vnd.mobius.mqy":".mqy","application/vnd.mobius.msl":".msl","application/vnd.mobius.plc":".plc","application/vnd.mobius.txf":".txf","application/vnd.mophun.application":".mpn","application/vnd.mophun.certificate":".mpc","application/vnd.mozilla.xul+xml":".xul","application/vnd.ms-artgalry":".cil","application/vnd.ms-cab-compressed":".cab","application/vnd.ms-excel":".xls","application/vnd.ms-excel.addin.macroenabled.12":".xlam","application/vnd.ms-excel.sheet.binary.macroenabled.12":".xlsb","application/vnd.ms-excel.sheet.macroenabled.12":".xlsm","application/vnd.ms-excel.template.macroenabled.12":".xltm","application/vnd.ms-fontobject":".eot","application/vnd.ms-htmlhelp":".chm","application/vnd.ms-ims":".ims","application/vnd.ms-lrm":".lrm","application/vnd.ms-officetheme":".thmx","application/vnd.ms-pki.seccat":".cat","application/vnd.ms-pki.stl":".stl","application/vnd.ms-powerpoint":".ppt","application/vnd.ms-powerpoint.addin.macroenabled.12":".ppam","application/vnd.ms-powerpoint.presentation.macroenabled.12":".pptm","application/vnd.ms-powerpoint.slide.macroenabled.12":".sldm","application/vnd.ms-powerpoint.slideshow.macroenabled.12":".ppsm","application/vnd.ms-powerpoint.template.macroenabled.12":".potm","application/vnd.ms-project":".mpp","application/vnd.ms-word.document.macroenabled.12":".docm","application/vnd.ms-word.template.macroenabled.12":".dotm","application/vnd.ms-works":".wps","application/vnd.ms-wpl":".wpl","application/vnd.ms-xpsdocument":".xps","application/vnd.mseq":".mseq","application/vnd.musician":".mus","application/vnd.muvee.style":".msty","application/vnd.mynfc":".taglet","application/vnd.neurolanguage.nlu":".nlu","application/vnd.nitf":".ntf","application/vnd.noblenet-directory":".nnd","application/vnd.noblenet-sealer":".nns","application/vnd.noblenet-web":".nnw","application/vnd.nokia.n-gage.data":".ngdat","application/vnd.nokia.n-gage.symbian.install":".n-gage","application/vnd.nokia.radio-preset":".rpst","application/vnd.nokia.radio-presets":".rpss","application/vnd.novadigm.edm":".edm","application/vnd.novadigm.edx":".edx","application/vnd.novadigm.ext":".ext","application/vnd.oasis.opendocument.chart":".odc","application/vnd.oasis.opendocument.chart-template":".otc","application/vnd.oasis.opendocument.database":".odb","application/vnd.oasis.opendocument.formula":".odf","application/vnd.oasis.opendocument.formula-template":".odft","application/vnd.oasis.opendocument.graphics":".odg","application/vnd.oasis.opendocument.graphics-template":".otg","application/vnd.oasis.opendocument.image":".odi","application/vnd.oasis.opendocument.image-template":".oti","application/vnd.oasis.opendocument.presentation":".odp","application/vnd.oasis.opendocument.presentation-template":".otp","application/vnd.oasis.opendocument.spreadsheet":".ods","application/vnd.oasis.opendocument.spreadsheet-template":".ots","application/vnd.oasis.opendocument.text":".odt","application/vnd.oasis.opendocument.text-master":".odm","application/vnd.oasis.opendocument.text-template":".ott","application/vnd.oasis.opendocument.text-web":".oth","application/vnd.olpc-sugar":".xo","application/vnd.oma.dd2+xml":".dd2","application/vnd.openofficeorg.extension":".oxt","application/vnd.openxmlformats-officedocument.presentationml.presentation":".pptx","application/vnd.openxmlformats-officedocument.presentationml.slide":".sldx","application/vnd.openxmlformats-officedocument.presentationml.slideshow":".ppsx","application/vnd.openxmlformats-officedocument.presentationml.template":".potx","application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":".xlsx","application/vnd.openxmlformats-officedocument.spreadsheetml.template":".xltx","application/vnd.openxmlformats-officedocument.wordprocessingml.document":".docx","application/vnd.openxmlformats-officedocument.wordprocessingml.template":".dotx","application/vnd.osgeo.mapguide.package":".mgp","application/vnd.osgi.dp":".dp","application/vnd.osgi.subsystem":".esa","application/vnd.palm":".pdb","application/vnd.pawaafile":".paw","application/vnd.pg.format":".str","application/vnd.pg.osasli":".ei6","application/vnd.picsel":".efif","application/vnd.pmi.widget":".wg","application/vnd.pocketlearn":".plf","application/vnd.powerbuilder6":".pbd","application/vnd.previewsystems.box":".box","application/vnd.proteus.magazine":".mgz","application/vnd.publishare-delta-tree":".qps","application/vnd.pvi.ptid1":".ptid","application/vnd.quark.quarkxpress":".qxd","application/vnd.realvnc.bed":".bed","application/vnd.recordare.musicxml":".mxl","application/vnd.recordare.musicxml+xml":".musicxml","application/vnd.rig.cryptonote":".cryptonote","application/vnd.rim.cod":".cod","application/vnd.rn-realmedia":".rm","application/vnd.rn-realmedia-vbr":".rmvb","application/vnd.route66.link66+xml":".link66","application/vnd.sailingtracker.track":".st","application/vnd.seemail":".see","application/vnd.sema":".sema","application/vnd.semd":".semd","application/vnd.semf":".semf","application/vnd.shana.informed.formdata":".ifm","application/vnd.shana.informed.formtemplate":".itp","application/vnd.shana.informed.interchange":".iif","application/vnd.shana.informed.package":".ipk","application/vnd.simtech-mindmapper":".twd","application/vnd.smaf":".mmf","application/vnd.smart.teacher":".teacher","application/vnd.solent.sdkm+xml":".sdkm","application/vnd.spotfire.dxp":".dxp","application/vnd.spotfire.sfs":".sfs","application/vnd.stardivision.calc":".sdc","application/vnd.stardivision.draw":".sda","application/vnd.stardivision.impress":".sdd","application/vnd.stardivision.math":".smf","application/vnd.stardivision.writer":".sdw","application/vnd.stardivision.writer-global":".sgl","application/vnd.stepmania.package":".smzip","application/vnd.stepmania.stepchart":".sm","application/vnd.sun.xml.calc":".sxc","application/vnd.sun.xml.calc.template":".stc","application/vnd.sun.xml.draw":".sxd","application/vnd.sun.xml.draw.template":".std","application/vnd.sun.xml.impress":".sxi","application/vnd.sun.xml.impress.template":".sti","application/vnd.sun.xml.math":".sxm","application/vnd.sun.xml.writer":".sxw","application/vnd.sun.xml.writer.global":".sxg","application/vnd.sun.xml.writer.template":".stw","application/vnd.sus-calendar":".sus","application/vnd.svd":".svd","application/vnd.symbian.install":".sis","application/vnd.syncml+xml":".xsm","application/vnd.syncml.dm+wbxml":".bdm","application/vnd.syncml.dm+xml":".xdm","application/vnd.tao.intent-module-archive":".tao","application/vnd.tcpdump.pcap":".pcap","application/vnd.tmobile-livetv":".tmo","application/vnd.trid.tpt":".tpt","application/vnd.triscape.mxs":".mxs","application/vnd.trueapp":".tra","application/vnd.ufdl":".ufd","application/vnd.uiq.theme":".utz","application/vnd.umajin":".umj","application/vnd.unity":".unityweb","application/vnd.uoml+xml":".uoml","application/vnd.vcx":".vcx","application/vnd.visio":".vsd","application/vnd.visionary":".vis","application/vnd.vsf":".vsf","application/vnd.wap.wbxml":".wbxml","application/vnd.wap.wmlc":".wmlc","application/vnd.wap.wmlscriptc":".wmlsc","application/vnd.webturbo":".wtb","application/vnd.wolfram.player":".nbp","application/vnd.wordperfect":".wpd","application/vnd.wqd":".wqd","application/vnd.wt.stf":".stf","application/vnd.xara":".xar","application/vnd.xfdl":".xfdl","application/vnd.yamaha.hv-dic":".hvd","application/vnd.yamaha.hv-script":".hvs","application/vnd.yamaha.hv-voice":".hvp","application/vnd.yamaha.openscoreformat":".osf","application/vnd.yamaha.openscoreformat.osfpvg+xml":".osfpvg","application/vnd.yamaha.smaf-audio":".saf","application/vnd.yamaha.smaf-phrase":".spf","application/vnd.yellowriver-custom-menu":".cmp","application/vnd.zul":".zir","application/vnd.zzazz.deck+xml":".zaz","application/voicexml+xml":".vxml","application/wasm":".wasm","application/widget":".wgt","application/winhlp":".hlp","application/wsdl+xml":".wsdl","application/wspolicy+xml":".wspolicy","application/x-7z-compressed":".7z","application/x-abiword":".abw","application/x-ace-compressed":".ace","application/x-apple-diskimage":".dmg","application/x-authorware-bin":".aab","application/x-authorware-map":".aam","application/x-authorware-seg":".aas","application/x-bcpio":".bcpio","application/x-bittorrent":".torrent","application/x-blorb":".blb","application/x-bzip":".bz","application/x-bzip2":".bz2","application/x-cbr":".cbr","application/x-cdlink":".vcd","application/x-cfs-compressed":".cfs","application/x-chat":".chat","application/x-chess-pgn":".pgn","application/x-conference":".nsc","application/x-cpio":".cpio","application/x-csh":".csh","application/x-debian-package":".deb","application/x-dgc-compressed":".dgc","application/x-director":".dir","application/x-doom":".wad","application/x-dtbncx+xml":".ncx","application/x-dtbook+xml":".dtb","application/x-dtbresource+xml":".res","application/x-dvi":".dvi","application/x-envoy":".evy","application/x-eva":".eva","application/x-font-bdf":".bdf","application/x-font-ghostscript":".gsf","application/x-font-linux-psf":".psf","application/x-font-pcf":".pcf","application/x-font-snf":".snf","application/x-font-type1":".pfa","application/x-freearc":".arc","application/x-futuresplash":".spl","application/x-gca-compressed":".gca","application/x-glulx":".ulx","application/x-gnumeric":".gnumeric","application/x-gramps-xml":".gramps","application/x-gtar":".gtar","application/x-hdf":".hdf","application/x-install-instructions":".install","application/x-iso9660-image":".iso","application/x-java-jnlp-file":".jnlp","application/x-latex":".latex","application/x-lzh-compressed":".lzh","application/x-mie":".mie","application/x-mobipocket-ebook":".prc","application/x-mpegurl":".m3u8","application/x-ms-application":".application","application/x-ms-shortcut":".lnk","application/x-ms-wmd":".wmd","application/x-ms-xbap":".xbap","application/x-msaccess":".mdb","application/x-msbinder":".obd","application/x-mscardfile":".crd","application/x-msclip":".clp","application/x-msdownload":".exe","application/x-msmediaview":".mvb","application/x-msmetafile":".wmf","application/x-msmoney":".mny","application/x-mspublisher":".pub","application/x-msschedule":".scd","application/x-msterminal":".trm","application/x-mswrite":".wri","application/x-netcdf":".cdf","application/x-nzb":".nzb","application/x-pkcs12":".p12","application/x-pkcs7-certificates":".p7b","application/x-pkcs7-certreqresp":".p7r","application/x-python-code":".pyc","application/x-rar-compressed":".rar","application/x-research-info-systems":".ris","application/x-sh":".sh","application/x-shar":".shar","application/x-shockwave-flash":".swf","application/x-silverlight-app":".xap","application/x-sql":".sql","application/x-stuffit":".sit","application/x-stuffitx":".sitx","application/x-subrip":".srt","application/x-sv4cpio":".sv4cpio","application/x-sv4crc":".sv4crc","application/x-t3vm-image":".t3","application/x-tads":".gam","application/x-tar":".tar","application/x-tcl":".tcl","application/x-tex":".tex","application/x-tex-tfm":".tfm","application/x-texinfo":".texi","application/x-tgif":".obj","application/x-ustar":".ustar","application/x-wais-source":".src","application/x-x509-ca-cert":".der","application/x-xfig":".fig","application/x-xliff+xml":".xlf","application/x-xpinstall":".xpi","application/x-xz":".xz","application/x-zmachine":".z1","application/xaml+xml":".xaml","application/xcap-diff+xml":".xdf","application/xenc+xml":".xenc","application/xhtml+xml":".xhtml","application/xml":".xsl","application/xml-dtd":".dtd","application/xop+xml":".xop","application/xproc+xml":".xpl","application/xslt+xml":".xslt","application/xspf+xml":".xspf","application/xv+xml":".mxml","application/yang":".yang","application/yin+xml":".yin","application/zip":".zip","audio/adpcm":".adp","audio/basic":".au","audio/midi":".mid","audio/mp4":".m4a","audio/mp4a-latm":".m4a","audio/mpeg":".mp3","audio/ogg":".oga","audio/s3m":".s3m","audio/silk":".sil","audio/vnd.dece.audio":".uva","audio/vnd.digital-winds":".eol","audio/vnd.dra":".dra","audio/vnd.dts":".dts","audio/vnd.dts.hd":".dtshd","audio/vnd.lucent.voice":".lvp","audio/vnd.ms-playready.media.pya":".pya","audio/vnd.nuera.ecelp4800":".ecelp4800","audio/vnd.nuera.ecelp7470":".ecelp7470","audio/vnd.nuera.ecelp9600":".ecelp9600","audio/vnd.rip":".rip","audio/webm":".weba","audio/x-aac":".aac","audio/x-aiff":".aif","audio/x-caf":".caf","audio/x-flac":".flac","audio/x-matroska":".mka","audio/x-mpegurl":".m3u","audio/x-ms-wax":".wax","audio/x-ms-wma":".wma","audio/x-pn-realaudio":".ra","audio/x-pn-realaudio-plugin":".rmp","audio/x-wav":".wav","audio/xm":".xm","chemical/x-cdx":".cdx","chemical/x-cif":".cif","chemical/x-cmdf":".cmdf","chemical/x-cml":".cml","chemical/x-csml":".csml","chemical/x-xyz":".xyz","font/collection":".ttc","font/otf":".otf","font/ttf":".ttf","font/woff":".woff","font/woff2":".woff2","image/avif":".avif","image/bmp":".bmp","image/cgm":".cgm","image/g3fax":".g3","image/gif":".gif","image/ief":".ief","image/jp2":".jp2","image/jpeg":".jpg","image/jxl":".jxl","image/ktx":".ktx","image/pict":".pict","image/png":".png","image/prs.btif":".btif","image/sgi":".sgi","image/svg+xml":".svg","image/tiff":".tiff","image/vnd.adobe.photoshop":".psd","image/vnd.dece.graphic":".uvi","image/vnd.djvu":".djvu","image/vnd.dwg":".dwg","image/vnd.dxf":".dxf","image/vnd.fastbidsheet":".fbs","image/vnd.fpx":".fpx","image/vnd.fst":".fst","image/vnd.fujixerox.edmics-mmr":".mmr","image/vnd.fujixerox.edmics-rlc":".rlc","image/vnd.ms-modi":".mdi","image/vnd.ms-photo":".wdp","image/vnd.net-fpx":".npx","image/vnd.wap.wbmp":".wbmp","image/vnd.xiff":".xif","image/webp":".webp","image/x-3ds":".3ds","image/x-cmu-raster":".ras","image/x-cmx":".cmx","image/x-freehand":".fh","image/x-icon":".ico","image/x-macpaint":".pntg","image/x-mrsid-image":".sid","image/x-pcx":".pcx","image/x-pict":".pic","image/x-portable-anymap":".pnm","image/x-portable-bitmap":".pbm","image/x-portable-graymap":".pgm","image/x-portable-pixmap":".ppm","image/x-quicktime":".qtif","image/x-rgb":".rgb","image/x-tga":".tga","image/x-xbitmap":".xbm","image/x-xpixmap":".xpm","image/x-xwindowdump":".xwd","message/rfc822":".eml","model/iges":".igs","model/mesh":".msh","model/vnd.collada+xml":".dae","model/vnd.dwf":".dwf","model/vnd.gdl":".gdl","model/vnd.gtw":".gtw","model/vnd.vtu":".vtu","model/vrml":".wrl","model/x3d+binary":".x3db","model/x3d+vrml":".x3dv","model/x3d+xml":".x3d","text/cache-manifest":".manifest","text/calendar":".ics","text/css":".css","text/csv":".csv","text/html":".html","text/javascript":".js","text/n3":".n3","text/plain":".txt","text/prs.lines.tag":".dsc","text/richtext":".rtx","text/sgml":".sgml","text/tab-separated-values":".tsv","text/troff":".t","text/turtle":".ttl","text/uri-list":".uri","text/vcard":".vcard","text/vnd.curl":".curl","text/vnd.curl.dcurl":".dcurl","text/vnd.curl.mcurl":".mcurl","text/vnd.curl.scurl":".scurl","text/vnd.dvb.subtitle":".sub","text/vnd.fly":".fly","text/vnd.fmi.flexstor":".flx","text/vnd.graphviz":".gv","text/vnd.in3d.3dml":".3dml","text/vnd.in3d.spot":".spot","text/vnd.sun.j2me.app-descriptor":".jad","text/vnd.wap.wml":".wml","text/vnd.wap.wmlscript":".wmls","text/x-asm":".s","text/x-c":".c","text/x-fortran":".f","text/x-java-source":".java","text/x-nfo":".nfo","text/x-opml":".opml","text/x-pascal":".p","text/x-python":".py","text/x-setext":".etx","text/x-sfv":".sfv","text/x-uuencode":".uu","text/x-vcalendar":".vcs","text/x-vcard":".vcf","video/3gpp":".3gp","video/3gpp2":".3g2","video/h261":".h261","video/h263":".h263","video/h264":".h264","video/jpeg":".jpgv","video/jpm":".jpm","video/mj2":".mj2","video/mp2t":".ts","video/mp4":".mp4","video/mpeg":".mpeg","video/ogg":".ogv","video/quicktime":".mov","video/vnd.dece.hd":".uvh","video/vnd.dece.mobile":".uvm","video/vnd.dece.pd":".uvp","video/vnd.dece.sd":".uvs","video/vnd.dece.video":".uvv","video/vnd.dvb.file":".dvb","video/vnd.fvt":".fvt","video/vnd.mpegurl":".mxu","video/vnd.ms-playready.media.pyv":".pyv","video/vnd.uvvu.mp4":".uvu","video/vnd.vivo":".viv","video/webm":".webm","video/x-dv":".dv","video/x-f4v":".f4v","video/x-fli":".fli","video/x-flv":".flv","video/x-m4v":".m4v","video/x-matroska":".mkv","video/x-mng":".mng","video/x-ms-asf":".asf","video/x-ms-vob":".vob","video/x-ms-wm":".wm","video/x-ms-wmv":".wmv","video/x-ms-wmx":".wmx","video/x-ms-wvx":".wvx","video/x-msvideo":".avi","video/x-sgi-movie":".movie","video/x-smv":".smv","x-conference/x-cooltalk":".ice"}
+
+def read_download_filename(request):
+ from urllib.parse import urlsplit, unquote
+ import posixpath
+ url = urlsplit(request['source'])
+ filename = unquote(posixpath.basename(url.path.rstrip('/'))) or url.netloc.rsplit('@', 1)[-1]
+ headers = {key.lower(): value for key, value in request['headers']}
+ # CPython 3.9 cgi.parse_header rules, including last duplicate wins.
+ remaining = ';' + headers.get('content-disposition', '')
+ parameters = []
+ while remaining[:1] == ';':
+  remaining = remaining[1:]
+  end = remaining.find(';')
+  while end > 0 and (remaining.count('"', 0, end) - remaining.count('\\"', 0, end)) % 2:
+   end = remaining.find(';', end + 1)
+  if end < 0: end = len(remaining)
+  parameters.append(remaining[:end].strip())
+  remaining = remaining[end:]
+ selected = None
+ for parameter in parameters[1:]:
+  if '=' not in parameter: continue
+  key, value = parameter.split('=', 1)
+  if key.strip().lower() != 'filename': continue
+  value = value.strip()
+  if len(value) >= 2 and value[0] == value[-1] == '"':
+   value = value[1:-1].replace('\\\\', '\\').replace('\\"', '"')
+  selected = posixpath.basename(value) if value else ''
+ filename = selected or filename
+ ext = posixpath.splitext(filename)[1]
+ if not ext:
+  ext = MIME_PREFERENCES.get(headers.get('content-type', '').lower())
+  if ext: filename += ext
+ if not ext and request['source'] != request['responseUrl']:
+  ext = posixpath.splitext(request['responseUrl'])[1]
+  if ext: filename += ext
+ return filename
+`)();
+
 // packages/safe-bash-command-python/src/build-backend.ts
 import { toByteSource as toByteSource5 } from "../../safe-bash-contracts/index.js";
 function createPythonBuildBackend(options) {
   if (!options.createExecutor || !options.environment || options.provisioning) throw new TypeError("Python build hooks require an asynchronous executor and explicit environment");
   const capabilities = /* @__PURE__ */ new WeakMap();
-  const environment = options.environment;
+  const environment = options.environment, legacy = /* @__PURE__ */ new WeakSet();
   const command = createPythonExecutorCommands({ ...options, environment: { ...environment, async prepare(context) {
-    return { ...await environment.prepare(context), bootstrap: true };
+    return { ...await environment.prepare(context), bootstrap: true, ...context.args && legacy.has(context.args) ? { bootstrapPackages: ["setuptools"] } : {} };
   } }, createCapabilities(context) {
     const provided = options.createCapabilities?.(context) ?? {};
     if (provided.python_build) throw new Error("Python build capability is reserved");
@@ -1129,12 +1180,20 @@ function createPythonBuildBackend(options) {
     context.signal.throwIfAborted();
     const { maxBytes } = context;
     if (maxBytes !== Infinity && (!Number.isSafeInteger(maxBytes) || maxBytes < 0)) throw new RangeError("Invalid Python build metadata limit");
-    if (!input || !["read_build_system", "check_build_requirements", "get_requires_for_build_wheel", "build_wheel"].includes(input.hook) || typeof input.source !== "string" || !input.source) throw new TypeError("Invalid Python build hook request");
-    if (input.hook === "check_build_requirements") {
+    if (!input || !["read_source_origin", "read_download_filename", "read_editable_requirement", "get_requires_for_legacy_wheel", "read_source_requirement", "read_build_system", "check_build_requirements", "get_requires_for_build_wheel", "build_wheel", "build_legacy_wheel"].includes(input.hook) || typeof input.source !== "string" || !input.source) throw new TypeError("Invalid Python build hook request");
+    if (input.hook === "read_editable_requirement" && input.requirementLine !== void 0 && typeof input.requirementLine !== "boolean") throw new TypeError("Invalid editable requirement line");
+    if (input.hook === "read_source_origin") {
+      if (typeof input.directory !== "boolean") throw new TypeError("Invalid Python source origin");
+    } else if (input.hook === "read_download_filename") {
+      if (typeof input.responseUrl !== "string" || !Array.isArray(input.headers) || input.headers.some((pair) => !Array.isArray(pair) || pair.length !== 2 || pair.some((value) => typeof value !== "string"))) throw new TypeError("Invalid Python download metadata");
+    } else if (input.hook === "build_legacy_wheel") {
+      if (typeof input.wheelDirectory !== "string" || !input.wheelDirectory || input.editable !== void 0 && typeof input.editable !== "boolean") throw new TypeError("Invalid Python legacy wheel directory");
+    } else if (input.hook === "check_build_requirements") {
       if ([input.requirements, input.installed].some((values) => !Array.isArray(values) || values.some((value) => typeof value !== "string"))) throw new TypeError("Invalid Python build requirements request");
     } else if (input.hook === "read_build_system") {
+      if (input.installation !== void 0 && !["directory", "archive"].includes(input.installation)) throw new TypeError("Invalid Python source installation");
       if (input.name !== void 0 && typeof input.name !== "string" || input.usePep517 !== void 0 && typeof input.usePep517 !== "boolean") throw new TypeError("Invalid Python build system request");
-    } else {
+    } else if (input.hook !== "read_source_requirement" && input.hook !== "read_editable_requirement" && input.hook !== "get_requires_for_legacy_wheel") {
       if (typeof input.backend !== "string" || !input.backend || input.backendPath !== void 0 && (!Array.isArray(input.backendPath) || input.backendPath.some((path) => typeof path !== "string")) || input.hook === "build_wheel" && (typeof input.wheelDirectory !== "string" || !input.wheelDirectory || input.metadataDirectory !== void 0 && typeof input.metadataDirectory !== "string")) throw new TypeError("Invalid Python build hook request");
       if (input.configSettings !== void 0 && (!input.configSettings || typeof input.configSettings !== "object" || Array.isArray(input.configSettings) || Object.values(input.configSettings).some((value) => typeof value !== "string" && (!Array.isArray(value) || value.some((item) => typeof item !== "string"))))) throw new TypeError("Invalid Python build configuration");
     }
@@ -1142,6 +1201,7 @@ function createPythonBuildBackend(options) {
     let done = false, size = 0, failure;
     const chunks = [];
     const invocation = { ...context, command: "python", args: ["-c", pythonBuildBackendProgram], stdin: toByteSource5("") };
+    if (request.hook === "build_legacy_wheel" || request.hook === "get_requires_for_legacy_wheel") legacy.add(invocation.args);
     capabilities.set(invocation.args, { async call(value) {
       try {
         context.signal.throwIfAborted();
@@ -1150,7 +1210,7 @@ function createPythonBuildBackend(options) {
         if (message.op === "request") return request;
         if (message.op === "error") {
           if (typeof message.type !== "string" || typeof message.message !== "string") throw new TypeError("Invalid Python build failure");
-          failure ??= Object.assign(new Error(message.message), { name: message.type });
+          failure ??= Object.assign(message.type === "InstallationError" ? new PythonInstallationError(message.message) : new Error(message.message), { name: message.type });
           done = true;
           return null;
         }
@@ -1176,7 +1236,12 @@ function createPythonBuildBackend(options) {
       if (result.exitCode) throw new Error(`Python build interpreter exited with status ${result.exitCode}`);
       if (!done) throw new Error("Python build interpreter returned no result");
       const value = JSON.parse(chunks.join(""));
-      if (request.hook === "check_build_requirements") {
+      if (request.hook === "read_source_origin" || request.hook === "read_download_filename") {
+        if (typeof value !== "string") throw new TypeError("Invalid Python download filename");
+      } else if (request.hook === "read_source_requirement" || request.hook === "read_editable_requirement") {
+        const result2 = value;
+        if (result2 !== null && (!result2 || typeof result2.name !== "string" || typeof result2.url !== "string" || typeof result2.active !== "boolean" || result2.marker !== null && typeof result2.marker !== "string" || !Array.isArray(result2.extras) || result2.extras.some((extra) => typeof extra !== "string"))) throw new TypeError("Invalid Python source requirement");
+      } else if (request.hook === "check_build_requirements") {
         const result2 = value;
         if (!result2 || !Array.isArray(result2.missing) || result2.missing.some((value2) => typeof value2 !== "string") || !Array.isArray(result2.conflicting) || result2.conflicting.some((pair) => !Array.isArray(pair) || pair.length !== 2 || pair.some((value2) => typeof value2 !== "string"))) throw new TypeError("Invalid Python build requirement status");
       } else if (request.hook === "read_build_system") {
@@ -1185,21 +1250,26 @@ function createPythonBuildBackend(options) {
           const details = value;
           if (typeof details.backend !== "string" || !details.backend || ["requires", "check", "backendPath"].some((key) => !Array.isArray(details[key]) || details[key].some((item) => typeof item !== "string"))) throw new TypeError("Invalid Python build system");
         }
-      } else if (request.hook === "build_wheel") {
+      } else if (request.hook === "build_wheel" || request.hook === "build_legacy_wheel") {
         if (typeof value !== "string" || !value.endsWith(".whl") || value.includes("/") || value.includes("\\") || value.includes("\0")) throw new TypeError("Invalid Python build wheel filename");
       } else if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) throw new TypeError("Invalid Python build requirements");
       return value;
     } finally {
       capabilities.delete(invocation.args);
+      legacy.delete(invocation.args);
     }
   };
 }
 var pythonBuildBackendProgram = /* @__PURE__ */ (() => String.raw`
 import importlib, json, os, sys, safe_host
+${pythonDownloadFilenameProgram}
 
 def send(op, **fields):
  return safe_host.call('python_build', dict(op=op, **fields))
 
+
+${pythonSourceOriginProgram}
+
 def parse_build_requirement(value):
  from urllib.parse import urlparse, urlunparse
  from micropip._vendored.packaging.src.packaging.requirements import Requirement, InvalidRequirement
@@ -1234,6 +1304,8 @@ def read_build_system(request):
  source = request['source']
  filename = os.path.join(source, 'pyproject.toml')
  has_project, has_setup = os.path.isfile(filename), os.path.isfile(os.path.join(source, 'setup.py'))
+ if request.get('installation') == 'directory' and not has_project and not has_setup:
+  raise InstallationError("Directory {!r} is not installable. Neither 'setup.py' nor 'pyproject.toml' found.".format(request.get('name', source)))
  system = None
  if has_project:
   limit = request['maxBytes']
@@ -1248,7 +1320,10 @@ def read_build_system(request):
   if selected is False: raise InstallationError('Disabling PEP 517 processing is invalid: project specifies a build backend of {} in pyproject.toml'.format(system['build-backend']))
   selected = True
  elif selected is None: selected = has_project
- if not selected: return None
+ if not selected:
+  if request.get('installation') and not os.path.exists(os.path.join(source, 'setup.py')):
+   raise InstallationError('File "setup.py" not found for legacy project {}.'.format(request.get('name', source)))
+  return None
  defaults = ['setuptools>=40.8.0', 'wheel']
  if system is None: system = {'requires': defaults, 'build-backend': 'setuptools.build_meta:__legacy__'}
  def invalid(reason):
@@ -1263,8 +1338,75 @@ def read_build_system(request):
  backend = system.get('build-backend')
  return dict(requires=requirements, backend=backend if backend is not None else 'setuptools.build_meta:__legacy__', check=defaults if backend is None else [], backendPath=system.get('backend-path', []))
 
+def build_legacy_wheel(request):
+ source = os.path.realpath(request['source'])
+ directory = os.path.abspath(request['wheelDirectory'])
+ filename = os.path.join(source, 'setup.py')
+ os.chdir(source)
+ sys.path.insert(0, '')
+ sys.argv = [filename, 'bdist_wheel', '-d', directory]
+ namespace = dict(__name__='__main__', __file__=filename)
+ try:
+  exec("import io, os, sys, setuptools, tokenize\nsys.argv[0] = __file__\nf = getattr(tokenize, 'open', open)(__file__) if os.path.exists(__file__) else io.StringIO('from setuptools import setup; setup()')\ncode = f.read().replace('\\r\\n', '\\n')\nf.close()\nexec(compile(code, __file__, 'exec'))", namespace)
+ except SystemExit as error:
+  if error.code not in (None, 0): raise
+ first = None
+ with os.scandir(directory) as entries:
+  for entry in entries:
+   if first is None or entry.name < first: first = entry.name
+ if first is None: raise RuntimeError('Legacy wheel build created no files')
+ return first
+
+def read_source_requirement(request):
+ from micropip._vendored.packaging.src.packaging.requirements import InvalidRequirement
+ try: requirement = parse_build_requirement(request['source'])
+ except InvalidRequirement: return None
+ if not requirement.url: return None
+ marker = requirement.marker
+ return dict(name=requirement.name, extras=sorted({'_'.join(part for part in extra.lower().split('_') if part) for extra in requirement.extras}), url=requirement.url, marker=str(marker) if marker else None, active=not marker or marker.evaluate({'extra': ''}))
+
+def read_editable_requirement(request):
+ from pathlib import Path
+ from micropip._vendored.packaging.src.packaging.requirements import Requirement
+ class InstallationError(Exception): pass
+ source, extras = request['source'], None
+ if request.get('requirementLine'):
+  import shlex, optparse
+  class OptionParsingError(Exception): pass
+  class Parser(optparse.OptionParser):
+   def exit(self, status=0, message=None): raise OptionParsingError(message)
+  parser = Parser(add_help_option=False)
+  parser.add_option('-e', '--editable', action='append', dest='editables')
+  options, _ = parser.parse_args(shlex.split(source))
+  if not options.editables: raise InstallationError('Editable requirement line requires -e')
+  source = options.editables[0]
+ start = source.rfind('[')
+ if start > 0 and source.endswith(']') and start < len(source) - 2 and ']' not in source[start + 1:-1]:
+  source, extras = source[:start], source[start:]
+ if os.path.isdir(source):
+  if not any(os.path.exists(os.path.join(source, name)) for name in ('setup.py', 'setup.cfg')):
+   message = 'File "setup.py" or "setup.cfg" not found. Directory cannot be installed in editable mode: {}'.format(os.path.abspath(source))
+   if os.path.isfile(os.path.join(source, 'pyproject.toml')): message += '\n(A "pyproject.toml" file was found, but editable mode currently requires a setuptools-based build.)'
+   raise InstallationError(message)
+  source = Path(os.path.abspath(source)).as_uri()
+ if not source.lower().startswith('file:'): raise InstallationError('Editable source requires a local directory')
+ name = ''
+ for index, character in enumerate(source):
+  if character in '#&' and source.startswith('egg=', index + 1):
+   name = source[index + 5:].split('&', 1)[0]
+   break
+ return dict(name=name, url=source, extras=sorted(Requirement('placeholder' + extras.lower()).extras) if extras else [], marker=None, active=True)
+
 def main():
  request = send('request')
+ if request['hook'] == 'get_requires_for_legacy_wheel': request.update(hook='get_requires_for_build_wheel', backend='setuptools.build_meta:__legacy__')
+ if request['hook'] == 'read_source_origin': return read_source_origin(request)
+ if request['hook'] == 'read_download_filename': return read_download_filename(request)
+ if request['hook'] == 'read_source_requirement': return read_source_requirement(request)
+ if request['hook'] == 'read_editable_requirement': return read_editable_requirement(request)
+ if request['hook'] == 'build_legacy_wheel':
+  if not request.get('editable'): return build_legacy_wheel(request)
+  request.update(hook='build_wheel', backend='setuptools.build_meta:__legacy__')
  if request['hook'] == 'read_build_system': return read_build_system(request)
  if request['hook'] == 'check_build_requirements': return check_build_requirements(request)
  source = os.path.realpath(request['source'])
@@ -1290,7 +1432,8 @@ def main():
   except AttributeError: result = []
   else: result = hook(settings)
  else:
-  result = backend.build_wheel(wheel_directory, settings, metadata_directory)
+  if request.get('editable'): result = backend.build_editable(wheel_directory, {'editable_mode': 'compat'}, metadata_directory)
+  else: result = backend.build_wheel(wheel_directory, settings, metadata_directory)
  return result
 
 try:
@@ -1312,7 +1455,7 @@ function createPythonBuildDependencies(options) {
     const context = { ...caller };
     context.signal.throwIfAborted();
     const request = structuredClone(input), { source, buildSystem, configSettings } = request;
-    if (typeof source !== "string" || !source || request.name !== void 0 && typeof request.name !== "string" || !buildSystem || typeof buildSystem.backend !== "string" || !buildSystem.backend || [buildSystem.requires, buildSystem.check, buildSystem.backendPath].some((values) => !Array.isArray(values) || values.some((value) => typeof value !== "string"))) throw new TypeError("Invalid Python build dependency request");
+    if (typeof source !== "string" || !source || request.name !== void 0 && typeof request.name !== "string" || buildSystem !== null && (!buildSystem || typeof buildSystem.backend !== "string" || !buildSystem.backend || [buildSystem.requires, buildSystem.check, buildSystem.backendPath].some((values) => !Array.isArray(values) || values.some((value) => typeof value !== "string")))) throw new TypeError("Invalid Python build dependency request");
     if (configSettings !== void 0 && (!configSettings || typeof configSettings !== "object" || Array.isArray(configSettings) || Object.values(configSettings).some((value) => typeof value !== "string" && (!Array.isArray(value) || value.some((item) => typeof item !== "string"))))) throw new TypeError("Invalid Python build configuration");
     if (context.maxBytes !== Infinity && (!Number.isSafeInteger(context.maxBytes) || context.maxBytes < 0)) throw new RangeError("Invalid Python build metadata limit");
     const install = async (requirements2) => {
@@ -1335,10 +1478,12 @@ function createPythonBuildDependencies(options) {
       if (status.conflicting.length) throw Object.assign(new Error("Some build dependencies for " + (request.name ?? source) + " conflict with " + against + ": " + [...status.conflicting].sort(([a, b], [c, d]) => a < c ? -1 : a > c ? 1 : b < d ? -1 : b > d ? 1 : 0).map(([installed2, wanted]) => installed2 + " is incompatible with " + wanted).join(", ") + "."), { name: "InstallationError" });
       return status.missing;
     };
-    await install(buildSystem.requires);
-    const missing = await check(buildSystem.check, "PEP 517/518 supported requirements");
-    if (missing.length) await context.stderr.write(new TextEncoder().encode("Missing build requirements in pyproject.toml for " + (request.name ?? source) + ".\nThe project does not specify a build backend, and pip cannot fall back to setuptools without " + missing.map((value) => "'" + value + "'").join(" and ") + ".\n"));
-    const requirements = await hook({ hook: "get_requires_for_build_wheel", source, backend: buildSystem.backend, backendPath: buildSystem.backendPath, ...configSettings === void 0 ? {} : { configSettings } }, context);
+    if (buildSystem) {
+      await install(buildSystem.requires);
+      const missing = await check(buildSystem.check, "PEP 517/518 supported requirements");
+      if (missing.length) await context.stderr.write(new TextEncoder().encode("Missing build requirements in pyproject.toml for " + (request.name ?? source) + ".\nThe project does not specify a build backend, and pip cannot fall back to setuptools without " + missing.map((value) => "'" + value + "'").join(" and ") + ".\n"));
+    }
+    const requirements = await hook(buildSystem ? { hook: "get_requires_for_build_wheel", source, backend: buildSystem.backend, backendPath: buildSystem.backendPath, ...configSettings === void 0 ? {} : { configSettings } } : { hook: "get_requires_for_legacy_wheel", source }, context);
     await install(await check(requirements, "the backend dependencies"));
   };
 }
@@ -1803,92 +1948,262 @@ del _install_safe_llm_import
   }
 }
 
-// packages/safe-bash-command-python/src/build-wheel.ts
+// packages/safe-bash-command-python/src/source-origin.ts
 import { FsError as FsError3 } from "../../safe-bash-contracts/index.js";
-import { resolvePath as resolvePath2, basename } from "../../safe-bash-contracts/path.js";
-async function publishPythonBuildWheel(source, directory, maxBytes, context) {
-  const { fs, signal } = context, settings = { signal };
-  signal.throwIfAborted();
-  if (maxBytes !== Infinity && (!Number.isSafeInteger(maxBytes) || maxBytes < 0)) throw new RangeError("Invalid Python wheel size limit");
-  const filename = basename(source);
-  if (!filename.endsWith(".whl") || filename.includes("\\") || filename.includes("\0")) throw new TypeError("Invalid Python build wheel filename");
-  const root = await fs.realpath(resolvePath2(context.cwd, directory), settings);
-  const caps = await fs.capabilitiesFor?.(root, settings) ?? fs.capabilities;
-  if (!fs.confineExtraction || !fs.prepareDirectory || !caps.retainedStagingWrite || !caps.retainedStagingCleanup || !caps.retainedRead || !caps.atomicFileStaging) throw new Error("Python wheel publication requires confined retained atomic staging");
-  const artifact = await openPythonPackageFile(context, resolvePath2(context.cwd, source), maxBytes);
-  if (!artifact) throw new Error("Python wheel publication requires retained source reads");
-  let reading;
-  try {
-    const confined = await fs.confineExtraction([root], settings);
-    const destination = new Proxy(confined, { get(target, key) {
-      const owner = key === "openReadFile" ? fs : target, value = Reflect.get(owner, key);
-      return typeof value === "function" ? value.bind(owner) : value;
-    } });
-    const parent = await destination.stat(root, settings), path = resolvePath2(root, artifact.key);
-    try {
-      await destination.prepareDirectory(path, { parent, expected: null, mode: 448, signal });
-    } catch (error) {
-      if (!(error instanceof FsError3) || !["EEXIST", "EAGAIN"].includes(error.code)) throw error;
+import { resolvePath as resolvePath2, dirname, basename } from "../../safe-bash-contracts/path.js";
+function withPythonSourceOrigins(environment, directory, maxBytes) {
+  const origins = /* @__PURE__ */ new Map(), encoder2 = new TextEncoder();
+  return {
+    ...environment,
+    async dispatch(operation, args, context) {
+      const result = await environment.dispatch(operation, args, context), session = String(args[0]);
+      if (operation === "package-open") {
+        origins.delete(session);
+        const url = new URL(String(args[1]));
+        if (url.protocol === "file:" && url.hash.startsWith("#python-source=")) {
+          const parent = dirname(decodeURIComponent(url.pathname));
+          if (basename(parent) !== result.key) return result;
+          let root;
+          try {
+            root = await context.fs.realpath(resolvePath2(context.cwd, directory), { signal: context.signal });
+          } catch (error) {
+            if (error instanceof FsError3 && error.code === "ENOENT") return result;
+            throw error;
+          }
+          if (dirname(parent) !== root) return result;
+          const origin = decodeURIComponent(url.hash.slice("#python-source=".length));
+          if (encoder2.encode(origin).length > maxBytes) throw new RangeError("Python source origin exceeds maxMetadataBytes");
+          origins.set(session, { key: result.key, origin });
+        }
+      } else if (operation === "package-retain") {
+        const origin = origins.get(session);
+        origins.delete(session);
+        if (origin !== void 0) return { ...result, metadata: origin.origin === "null" ? {} : { "direct_url.json": origin.origin } };
+      } else if (operation === "package-close" && origins.get(session)?.key === String(args[1])) origins.delete(session);
+      return result;
+    },
+    finish(start) {
+      origins.delete(start.session);
+      return environment.finish(start);
+    },
+    async dispose() {
+      try {
+        await environment.dispose();
+      } finally {
+        origins.clear();
+      }
     }
-    if ((await destination.lstat(path, settings)).type !== "directory") throw new Error("Python wheel publication directory changed");
-    const output = resolvePath2(path, filename);
-    const body = async function* () {
-      for (let offset = 0; offset < artifact.size; ) {
-        const bytes = await (reading = artifact.read(offset, 65536));
-        offset += bytes.length;
-        yield bytes;
+  };
+}
+
+// packages/safe-bash-command-python/src/source-environment.ts
+import { compareIdentity as compareIdentity2 } from "@poe-platform/safe-fs/core";
+import { FsError as FsError4, toByteSource as toByteSource7 } from "../../safe-bash-contracts/index.js";
+import { resolvePath as resolvePath4 } from "../../safe-bash-contracts/path.js";
+
+// packages/safe-bash-command-python/src/source-download.ts
+import { dirname as dirname2, resolvePath as resolvePath3 } from "../../safe-bash-contracts/path.js";
+import { sha224, sha256, sha384, sha512 } from "@noble/hashes/sha2.js";
+import { sha1, md5 } from "@noble/hashes/legacy.js";
+async function* verifiedBytes(source, expected, maxBytes, signal) {
+  const checksum = expected ? { sha1, sha224, sha384, sha256, sha512, md5 }[expected[0]].create() : void 0;
+  let count = 0;
+  try {
+    for await (const bytes of source) {
+      signal.throwIfAborted();
+      if (!(bytes instanceof Uint8Array)) throw new TypeError("Python package body must yield bytes");
+      if (bytes.length > maxBytes - count) throw new Error("Package download exceeds maxDownloadBytes");
+      count += bytes.length;
+      for (let offset = 0; offset < bytes.length; offset += 65536) {
+        signal.throwIfAborted();
+        const chunk = bytes.subarray(offset, offset + 65536);
+        checksum?.update(chunk);
+        yield chunk;
       }
-    };
-    const published = await stagePythonPackage({ ...context, fs: destination }, path, body(), maxBytes, () => {
-    }, (key) => {
-      if (key !== artifact.key) throw new Error("Built Python wheel integrity mismatch");
-    }, () => output);
-    if (!published) throw new Error("Python wheel publication requires retained atomic staging");
+    }
+    if (checksum && Array.from(checksum.digest(), (byte) => byte.toString(16).padStart(2, "0")).join("") !== expected[1]) throw new Error("Python source archive integrity mismatch: " + expected[0]);
+  } finally {
+    checksum?.destroy();
+  }
+}
+async function downloadPythonSourceArchive(url, path, options, context) {
+  const { fs, signal } = context, cacheDirectory = resolvePath3(context.cwd, options.cacheDirectory ?? dirname2(path));
+  const caps = await fs.capabilitiesFor?.(cacheDirectory, { signal }) ?? fs.capabilities;
+  if (!caps.retainedStagingWrite || !caps.retainedStagingCleanup || !caps.retainedRead || !caps.atomicFileStaging || !fs.createStagedFile || !fs.openReadFile || !fs.publishStagedFile || !fs.confineExtraction) throw new Error("Remote Python sources require retained caller storage");
+  const output = await fs.confineExtraction([dirname2(path)], { signal });
+  if (!output.writeStream) throw new Error("Remote Python sources require streaming writes");
+  const expected = pythonPackageUrlHash(url.href), supplied = options.transport, maxBytes = options.maxDownloadBytes ?? Infinity;
+  const transport = supplied && expected ? Object.assign(async (request) => {
+    const response = await supplied(request);
+    return response.status >= 200 && response.status < 300 ? {
+      status: response.status,
+      statusText: response.statusText,
+      headers: response.headers,
+      ...response.httpVersion === void 0 ? {} : { httpVersion: response.httpVersion },
+      ...response.contentDecoded === void 0 ? {} : { contentDecoded: response.contentDecoded },
+      body: verifiedBytes(response.body, expected, maxBytes, signal),
+      dispose: response.dispose.bind(response)
+    } : response;
+  }, supplied.supportsPrivateNetworkDeny ? { supportsPrivateNetworkDeny: true } : {}) : supplied;
+  const environment = createPythonBuildEnvironment({ ...options, ...transport ? { transport } : {}, cacheDirectory });
+  try {
+    const start = await environment.prepare({ ...context, requirements: [], requirementFiles: [] });
     try {
-      return { url: "file://" + output.split("/").map(encodeURIComponent).join("/"), digest: published.key, size: published.size };
+      const address = new URL(url);
+      address.hash = "";
+      const receipt = await environment.dispatch("package-open", [start.session, address.href], context);
+      let consumed = false;
+      const bytes = verifiedBytes((async function* () {
+        for (let offset = 0; offset < receipt.size; ) {
+          const chunk = await environment.dispatch("package-read", [start.session, receipt.key, offset, Math.min(65536, receipt.size - offset)], context);
+          if (!chunk.length) throw new Error("Remote Python source ended early");
+          offset += chunk.length;
+          yield Uint8Array.from(chunk);
+        }
+        consumed = true;
+      })(), expected, maxBytes, signal);
+      try {
+        await output.writeStream(path, bytes, { flag: "wx", mode: 384, signal });
+        if (!consumed) throw new Error("Remote Python source write ended early");
+      } finally {
+        await bytes.return(void 0);
+      }
+      return { url: receipt.url, headers: receipt.headers };
     } finally {
-      await published.close();
+      await environment.finish(start);
     }
+  } finally {
+    await environment.dispose();
+  }
+}
+async function snapshotPythonSourceArchive(source, path, url, maxBytes, context) {
+  const { fs, signal } = context;
+  if (!fs.writeStream) throw new Error("Local Python sources require streaming writes");
+  const file = await openPythonPackageFile(context, source, maxBytes);
+  if (!file) throw new Error("Local Python sources require retained reads");
+  const bytes = verifiedBytes((async function* () {
+    for (let offset = 0; offset < file.size; ) {
+      const chunk = await file.read(offset, Math.min(65536, file.size - offset));
+      offset += chunk.length;
+      yield chunk;
+    }
+  })(), pythonPackageUrlHash(url), maxBytes, signal);
+  let complete = false;
+  try {
+    await fs.writeStream(path, (async function* () {
+      yield* bytes;
+      complete = true;
+    })(), { flag: "wx", mode: 384, signal });
+    if (!complete) throw new Error("Local Python source write ended early");
   } finally {
     try {
-      await reading?.catch(() => {
-      });
+      await bytes.return(void 0);
     } finally {
-      await artifact.close();
+      await file.close();
     }
   }
 }
 
 // packages/safe-bash-command-python/src/source-environment.ts
-import { compareIdentity as compareIdentity2 } from "@poe-platform/safe-fs/core";
-import { FsError as FsError4, toByteSource as toByteSource7 } from "../../safe-bash-contracts/index.js";
-import { resolvePath as resolvePath3 } from "../../safe-bash-contracts/path.js";
 var serial2 = 0;
+var archiveSuffix = (path) => [".zip", ".tar", ".tar.gz", ".tgz", ".tar.bz2", ".tbz", ".tar.xz", ".txz"].find((suffix) => path.toLowerCase().endsWith(suffix));
+var wheelLink = (url) => {
+  let path = url.pathname;
+  while (path.endsWith("/")) path = path.slice(0, -1);
+  const parts = (path.slice(path.lastIndexOf("/") + 1) || url.host).split("%");
+  let name = parts.shift();
+  for (const part of parts) {
+    const hex = part.slice(0, 2).toLowerCase();
+    name += hex.length === 2 && [...hex].every((value) => "0123456789abcdef".includes(value)) ? String.fromCharCode(Number.parseInt(hex, 16)) + part.slice(2) : "%" + part;
+  }
+  name = name.slice(name.lastIndexOf("/") + 1);
+  return name.endsWith(".whl") && name.slice(0, -4).split(".").some(Boolean);
+};
 function createPythonSourcePackageEnvironment(options, build) {
   if (options.prepareRequirements || !build.python.createExecutor || !build.directory) throw new TypeError("Source packages require an asynchronous build executor and caller storage");
-  const prepareRequirement = async (requirement, context) => {
-    const { fs, signal } = context, settings = { signal };
-    let source = requirement;
-    if (source.startsWith("file:")) {
+  const prepareRequirement = async (requirement, context, editable = false) => {
+    const { fs, signal } = context, settings = { signal }, requirementLine = requirement.startsWith("-");
+    editable ||= requirementLine;
+    let source = requirement, named = null;
+    let remote;
+    const at = requirement.indexOf("@");
+    let namedSource = false;
+    if (at >= 0 && !requirement.startsWith("file:")) {
+      const tail = requirement.slice(at + 1).trimStart();
+      let end = 0;
+      while (end < tail.length && ![" ", "	", "\r", "\n"].includes(tail[end])) end++;
+      try {
+        const url = new URL(tail.slice(0, end));
+        namedSource = url.protocol === "file:" || ["http:", "https:"].includes(url.protocol) && !wheelLink(url);
+      } catch {
+      }
+    }
+    const editableExtras = editable && requirement.endsWith("]") && requirement.lastIndexOf("[") > 0;
+    if (namedSource || editableExtras || requirementLine) {
+      if (!context.stdout || !context.stderr || !context.env) throw new TypeError("Source requirement parsing requires command output and environment context");
+      const environment2 = createPythonBuildEnvironment(options);
+      const parsing = { ...context, env: context.env, stdout: context.stdout, stderr: context.stderr, maxBytes: options.maxMetadataBytes ?? Infinity };
+      Reflect.deleteProperty(parsing, "editable");
+      try {
+        named = await createPythonBuildBackend({ ...build.python, environment: environment2 })({ hook: editableExtras || requirementLine ? "read_editable_requirement" : "read_source_requirement", source: requirement, ...requirementLine ? { requirementLine } : {} }, parsing);
+      } finally {
+        await environment2.dispose();
+      }
+      if (named) {
+        if (!named.active) return requirement;
+        source = named.url;
+      }
+    }
+    const originalLink = source.slice(0, 5).toLowerCase() === "file:" || source.startsWith("https://") || source.startsWith("http://") ? source : void 0;
+    let subdirectory;
+    if (source.startsWith("file:") || source.startsWith("https://") || source.startsWith("http://")) {
+      for (let index = 0; index < source.length; index++) if ((source[index] === "#" || source[index] === "&") && source.startsWith("subdirectory=", index + 1)) {
+        const start = index + 1 + "subdirectory=".length, end = source.indexOf("&", start);
+        subdirectory = source.slice(start, end < 0 ? void 0 : end);
+        break;
+      }
+    }
+    if (source.slice(0, 5).toLowerCase() === "file:") {
       const url = new URL(source);
-      if (url.host && url.host !== "localhost") return requirement;
+      if (url.host && url.host !== "localhost") {
+        if (editable) throw new Error("Editable source requires a local directory");
+        return requirement;
+      }
       source = decodeURIComponent(url.pathname);
-    } else if (source.includes("://")) return requirement;
-    source = resolvePath3(context.cwd, source);
-    try {
-      if ((await fs.stat(source, settings)).type !== "directory") return requirement;
-    } catch (error) {
-      if (error instanceof FsError4 && error.code === "ENOENT") return requirement;
-      throw error;
+    } else if (source.startsWith("https://") || source.startsWith("http://")) remote = new URL(source);
+    else if (source.includes("://")) {
+      if (editable) throw new Error("Editable source requires a local directory");
+      return requirement;
     }
+    if (editable && remote) throw new Error("Editable source requires a local directory");
+    const suffix = archiveSuffix(remote?.pathname ?? source);
+    let archived = !!remote && !wheelLink(remote);
+    if (remote) {
+      if (!archived) return requirement;
+    } else {
+      source = resolvePath4(context.cwd, source);
+      try {
+        const stat = await fs.stat(source, settings);
+        archived = stat.type === "file" && !!suffix;
+        if (editable && stat.type !== "directory") throw new Error("Editable source requires a local directory");
+        if (stat.type !== "directory" && !archived) return requirement;
+      } catch (error) {
+        if (error instanceof FsError4 && error.code === "ENOENT") {
+          if (editable) throw new Error("Editable source requires an existing local directory");
+          return requirement;
+        }
+        throw error;
+      }
+    }
+    const originSource = originalLink ?? source;
     if (!context.stdout || !context.stderr || !context.env) throw new TypeError("Source package preparation requires command output and environment context");
     if (!fs.prepareDirectory || !fs.removeTreeConditional || !fs.confineExtraction) throw new Error("Source packages require conditional caller storage");
-    const root = await fs.realpath(resolvePath3(context.cwd, build.directory), settings), parent = await fs.stat(root, settings);
+    const root = await fs.realpath(resolvePath4(context.cwd, build.directory), settings), parent = await fs.stat(root, settings);
     const caps = await fs.capabilitiesFor?.(root, settings) ?? fs.capabilities;
     if (!caps.atomicTreeRemoval) throw new Error("Source packages require conditional tree cleanup");
     let path = "", owned;
     for (let attempt = 0; attempt < 16; attempt++) {
-      path = resolvePath3(root, ".python-build-" + ++serial2);
+      path = resolvePath4(root, ".python-build-" + ++serial2);
       try {
         owned = await fs.prepareDirectory(path, { parent, expected: null, mode: 448, signal });
         break;
@@ -1920,17 +2235,45 @@ function createPythonSourcePackageEnvironment(options, build) {
         return typeof value === "function" ? value.bind(owner) : value;
       } });
       const command = { ...context, env: context.env, stdout: context.stdout, stderr: context.stderr, command: "python", args: [], stdin: toByteSource7("") };
-      const snapshot = await createPythonSourceSnapshot(source, path, { ...command, fs: staging });
-      const wheelDirectory = resolvePath3(path, "wheels");
-      await confined.mkdir(wheelDirectory, settings);
+      Reflect.deleteProperty(command, "editable");
       const configuration = { ...build.python, environment }, hook = createPythonBuildBackend(configuration), hookContext = { ...command, maxBytes: options.maxMetadataBytes ?? Infinity };
-      const buildSystem = await hook({ hook: "read_build_system", source: snapshot.path }, hookContext);
-      if (!buildSystem) throw new Error("Legacy setup.py source installation is not yet available");
-      await createPythonBuildDependencies(configuration)({ source: snapshot.path, buildSystem }, hookContext);
-      const filename = await hook({ hook: "build_wheel", source: snapshot.path, backend: buildSystem.backend, backendPath: buildSystem.backendPath, wheelDirectory }, hookContext);
-      const published = await publishPythonBuildWheel(resolvePath3(wheelDirectory, filename), root, options.maxDownloadBytes ?? Infinity, context);
+      let prepared;
+      if (archived) {
+        prepared = resolvePath4(path, "source");
+        await confined.mkdir(prepared, settings);
+        if (!build.extractArchive) throw new Error("Source archives require an extraction capability");
+        let metadata;
+        if (remote) {
+          source = resolvePath4(path, "archive");
+          const response = await downloadPythonSourceArchive(remote, source, options, command);
+          const filename2 = await hook({ hook: "read_download_filename", source: remote.href, responseUrl: response.url, headers: response.headers }, hookContext);
+          const headers = new Map(response.headers.map(([key, value]) => [key.toLowerCase(), value]));
+          metadata = { filename: filename2, ...headers.has("content-type") ? { contentType: headers.get("content-type") } : {} };
+        }
+        if (!remote && originalLink && pythonPackageUrlHash(originalLink)) {
+          const snapshot = resolvePath4(path, "archive" + suffix);
+          await snapshotPythonSourceArchive(source, snapshot, originalLink, options.maxDownloadBytes ?? Infinity, { ...command, fs: staging });
+          source = snapshot;
+        }
+        await build.extractArchive(source, prepared, options.maxDownloadBytes ?? Infinity, { ...command, fs: staging }, metadata);
+      } else prepared = editable ? await fs.realpath(source, settings) : (await createPythonSourceSnapshot(source, path, { ...command, fs: staging })).path;
+      if (subdirectory) {
+        const selected = resolvePath4(prepared, subdirectory);
+        if (selected !== prepared && !selected.startsWith(prepared + "/")) throw new Error("Source subdirectory escapes the build tree");
+        const root2 = await fs.realpath(prepared, settings), actual = await fs.realpath(selected, settings);
+        if (actual !== root2 && !actual.startsWith(root2 + "/")) throw new Error("Source subdirectory escapes the build tree");
+        prepared = actual;
+      }
+      const wheelDirectory = resolvePath4(path, "wheels");
+      await confined.mkdir(wheelDirectory, settings);
+      const buildSystem = await hook({ hook: "read_build_system", source: prepared, name: requirement, installation: archived ? "archive" : "directory" }, hookContext);
+      await createPythonBuildDependencies(configuration)({ source: prepared, buildSystem }, hookContext);
+      const filename = await hook(editable ? { hook: "build_legacy_wheel", source: prepared, wheelDirectory, editable: true } : buildSystem ? { hook: "build_wheel", source: prepared, backend: buildSystem.backend, backendPath: buildSystem.backendPath, wheelDirectory } : { hook: "build_legacy_wheel", source: prepared, wheelDirectory }, hookContext);
+      const published = await publishPythonBuildWheel(resolvePath4(wheelDirectory, filename), root, options.maxDownloadBytes ?? Infinity, context);
+      const origin = buildSystem && !editable ? await hook({ hook: "read_source_origin", source: originSource, directory: !archived }, hookContext) : void 0;
+      const url = published.url + "#python-source=" + encodeURIComponent(origin ?? "null");
       await cleanup();
-      return published.url;
+      return named ? (named.name || filename.slice(0, filename.indexOf("-"))) + (named.extras.length ? "[" + named.extras.join(",") + "]" : "") + " @ " + url + (named.marker ? " ; " + named.marker : "") : url;
     } catch (error) {
       try {
         await cleanup();
@@ -1941,14 +2284,16 @@ function createPythonSourcePackageEnvironment(options, build) {
       throw error;
     }
   };
-  return createPythonPackageEnvironment({ ...options, async prepareRequirements(requirements, context) {
+  return withPythonSourceOrigins(createPythonPackageEnvironment({ ...options, async prepareRequirements(requirements, context) {
     const resolved = [];
+    for (const requirement of /* @__PURE__ */ new Set([...options.editable ?? [], ...context.editable ?? []])) resolved.push(await prepareRequirement(requirement, context, true));
     for (const requirement of new Set(requirements)) resolved.push(await prepareRequirement(requirement, context));
     return resolved;
-  } });
+  } }), build.directory, options.maxMetadataBytes ?? Infinity);
 }
 
 // packages/safe-bash-command-python/src/executor.ts
+var encoder = new TextEncoder();
 var PythonInputChunkError = class extends RangeError {
 };
 function createPythonExecutorCommands(options) {
@@ -1970,7 +2315,7 @@ function createPythonExecutorCommands(options) {
   const environment = options.environment ?? createPythonPackageEnvironment(options.provisioning);
   const execute = async (context) => {
     if (pythonShellDispatchActive(context.executionScope)) {
-      await writeBytes(context.stderr, new TextEncoder().encode("python: nested Python execution is unavailable while the parent interpreter is suspended\n"), context.signal);
+      await writeBytes(context.stderr, encoder.encode("python: nested Python execution is unavailable while the parent interpreter is suspended\n"), context.signal);
       return { exitCode: 1 };
     }
     let installation;
@@ -1979,17 +2324,17 @@ function createPythonExecutorCommands(options) {
       installation = invocation.module?.name === "pip" ? parsePythonInstallation(invocation.module.args) : void 0;
     } catch (error) {
       if (!(error instanceof PythonInvocationError)) throw error;
-      await writeBytes(context.stderr, new TextEncoder().encode("python: " + error.message + "\n"), context.signal);
+      await writeBytes(context.stderr, encoder.encode("python: " + error.message + "\n"), context.signal);
       return { exitCode: 2 };
     }
     if (installation?.help) {
-      await writeBytes(context.stdout, new TextEncoder().encode(pythonInstallationHelp), context.signal);
+      await writeBytes(context.stdout, encoder.encode(pythonInstallationHelp), context.signal);
       return { exitCode: 0 };
     }
     context.signal.throwIfAborted();
     if (activeWorkers >= maxConcurrentWorkers) {
       const failure = reportPythonFailure("capacity", void 0, options.onDiagnostic);
-      await writeBytes(context.stderr, new TextEncoder().encode("python: " + failure.message + "\n"), context.signal);
+      await writeBytes(context.stderr, encoder.encode("python: " + failure.message + "\n"), context.signal);
       return { exitCode: 1 };
     }
     const controller = new AbortController();
@@ -2077,7 +2422,7 @@ function createPythonExecutorCommands(options) {
         if (!filesystemDiagnostics.has(category)) {
           filesystemDiagnostics.add(category);
           const failure = reportPythonFailure(category, error, options.onDiagnostic);
-          await writeBytes(stderrOperation.output, new TextEncoder().encode("python: " + failure.message + "\n"), signal);
+          await writeBytes(stderrOperation.output, encoder.encode("python: " + failure.message + "\n"), signal);
         }
       };
       const dispatch = async (request) => {
@@ -2353,9 +2698,9 @@ function createPythonExecutorCommands(options) {
         });
       }
     } catch (reason) {
-      if (!signal.aborted && reason instanceof PythonInputChunkError) {
+      if (!signal.aborted && (reason instanceof PythonInputChunkError || reason instanceof PythonInstallationError)) {
         try {
-          await writeBytes(stderrOperation.output, new TextEncoder().encode("python: " + reason.message + "\n"), signal);
+          await writeBytes(stderrOperation.output, encoder.encode("python: " + reason.message + "\n"), signal);
         } catch (error) {
           primary = { reason: error };
         }
@@ -2377,7 +2722,7 @@ function createPythonExecutorCommands(options) {
     if (primary) {
       if (!(primary.reason instanceof PythonFailure)) throw primary.reason;
       const failure = primary.reason;
-      await writeBytes(context.stderr, new TextEncoder().encode("python: " + failure.message + "\n"), context.signal);
+      await writeBytes(context.stderr, encoder.encode("python: " + failure.message + "\n"), context.signal);
       return { exitCode: 1 };
     }
     return { exitCode: result };
@@ -2411,7 +2756,6 @@ export {
   createPythonSourceSnapshot,
   pythonLlmPackages,
   installPythonLlmPackages,
-  publishPythonBuildWheel,
   createPythonSourcePackageEnvironment,
   createPythonExecutorCommands,
   pythonExecutorCommands