@poe-platform/safe-bash 0.1.822 → 0.1.824

package/dist/safe-bash-command-playwright-cli/playwright/storage-capabilities.js

@@ -1,15 +1,15 @@
 import {
   playwrightStorageAbilities
-} from "../../safe-bash/command-chunks/chunk-HCJWEB6P.js";
+} from "../../safe-bash/command-chunks/chunk-U6IEK2CI.js";
+import "../../safe-bash/command-chunks/chunk-SRXARACJ.js";
+import "../../safe-bash/command-chunks/chunk-BPVCKKYK.js";
+import "../../safe-bash/command-chunks/chunk-YMZQFL3O.js";
 import "../../safe-bash/command-chunks/chunk-MI4J3AIL.js";
 import "../../safe-bash/command-chunks/chunk-Q7JQPHFP.js";
 import "../../safe-bash/command-chunks/chunk-DI2GPUM4.js";
 import "../../safe-bash/command-chunks/chunk-SSIG3FO3.js";
-import "../../safe-bash/command-chunks/chunk-QZNPYTJX.js";
-import "../../safe-bash/command-chunks/chunk-3TP4SSPS.js";
-import "../../safe-bash/command-chunks/chunk-YMZQFL3O.js";
-import "../../safe-bash/command-chunks/chunk-BPVCKKYK.js";
 import "../../safe-bash/command-chunks/chunk-I6ICC6AG.js";
+import "../../safe-bash/command-chunks/chunk-QZNPYTJX.js";
 import "../../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   playwrightStorageAbilities

package/dist/safe-bash-command-playwright-cli/playwright/tracing-capabilities.js

@@ -8,8 +8,8 @@ import "../../safe-bash/command-chunks/chunk-MI4J3AIL.js";
 import "../../safe-bash/command-chunks/chunk-Q7JQPHFP.js";
 import "../../safe-bash/command-chunks/chunk-DI2GPUM4.js";
 import "../../safe-bash/command-chunks/chunk-SSIG3FO3.js";
-import "../../safe-bash/command-chunks/chunk-QZNPYTJX.js";
 import "../../safe-bash/command-chunks/chunk-I6ICC6AG.js";
+import "../../safe-bash/command-chunks/chunk-QZNPYTJX.js";
 import "../../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   flushPlaywrightTrace,

package/dist/safe-bash-command-playwright-cli/playwright/webmcp-capabilities.js

@@ -6,8 +6,8 @@ import "../../safe-bash/command-chunks/chunk-MI4J3AIL.js";
 import "../../safe-bash/command-chunks/chunk-Q7JQPHFP.js";
 import "../../safe-bash/command-chunks/chunk-DI2GPUM4.js";
 import "../../safe-bash/command-chunks/chunk-SSIG3FO3.js";
-import "../../safe-bash/command-chunks/chunk-QZNPYTJX.js";
 import "../../safe-bash/command-chunks/chunk-I6ICC6AG.js";
+import "../../safe-bash/command-chunks/chunk-QZNPYTJX.js";
 import "../../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   playwrightWebMCPAbilities

package/dist/safe-bash-command-python/build-backend.d.ts

@@ -0,0 +1,93 @@
+import { type CommandContext } from "../safe-bash-contracts/index.js";
+import { type PythonCommandsOptions, type PythonPackageEnvironment } from './executor.js';
+export type PythonBuildHookRequest = {
+    readonly source: string;
+    readonly backend: string;
+    readonly backendPath?: readonly string[];
+    readonly configSettings?: Readonly<Record<string, string | readonly string[]>>;
+} & ({
+    readonly hook: 'get_requires_for_build_wheel';
+} | {
+    readonly hook: 'build_wheel';
+    readonly wheelDirectory: string;
+    readonly metadataDirectory?: string;
+});
+export interface PythonLegacyRequirementsRequest {
+    readonly hook: 'get_requires_for_legacy_wheel';
+    readonly source: string;
+}
+export interface PythonLegacyBuildRequest {
+    readonly hook: 'build_legacy_wheel';
+    /** Build a native setuptools compatibility-mode editable wheel. */
+    readonly editable?: boolean;
+    readonly source: string;
+    readonly wheelDirectory: string;
+}
+export interface PythonBuildSystemRequest {
+    readonly hook: 'read_build_system';
+    readonly source: string;
+    readonly name?: string;
+    readonly usePep517?: boolean;
+    /** Apply pip installation admission in addition to low-level backend selection. */
+    readonly installation?: 'directory' | 'archive';
+}
+export interface PythonBuildSystemDetails {
+    readonly requires: readonly string[];
+    readonly backend: string;
+    readonly check: readonly string[];
+    readonly backendPath: readonly string[];
+}
+export interface PythonBuildRequirementsRequest {
+    readonly hook: 'check_build_requirements';
+    readonly source: string;
+    readonly requirements: readonly string[];
+    /** Distribution names from the build environment's installed manifest. */
+    readonly installed: readonly string[];
+}
+export interface PythonBuildRequirementsStatus {
+    readonly conflicting: readonly (readonly [installed: string, wanted: string])[];
+    readonly missing: readonly string[];
+}
+export interface PythonSourceOriginRequest {
+    readonly hook: 'read_source_origin';
+    readonly source: string;
+    readonly directory: boolean;
+}
+export interface PythonDownloadFilenameRequest {
+    readonly hook: 'read_download_filename';
+    readonly source: string;
+    readonly responseUrl: string;
+    readonly headers: readonly (readonly [string, string])[];
+}
+export interface PythonSourceRequirementRequest {
+    readonly hook: 'read_source_requirement';
+    readonly source: string;
+}
+export interface PythonEditableRequirementRequest {
+    readonly hook: 'read_editable_requirement';
+    readonly source: string;
+    /** Parse a requirements-file option line before resolving the editable source. */
+    readonly requirementLine?: boolean;
+}
+export interface PythonSourceRequirement {
+    /** Empty when an editable source has no explicit egg name. */
+    readonly name: string;
+    readonly extras: readonly string[];
+    readonly url: string;
+    readonly marker: string | null;
+    readonly active: boolean;
+}
+type BuildRequest = PythonSourceOriginRequest | PythonDownloadFilenameRequest | PythonEditableRequirementRequest | PythonLegacyRequirementsRequest | PythonSourceRequirementRequest | PythonLegacyBuildRequest | PythonBuildHookRequest | PythonBuildSystemRequest | PythonBuildRequirementsRequest;
+type BuildResult<T extends BuildRequest> = T extends PythonDownloadFilenameRequest | PythonSourceOriginRequest ? string : T extends PythonSourceRequirementRequest | PythonEditableRequirementRequest ? PythonSourceRequirement | null : T extends PythonBuildSystemRequest ? PythonBuildSystemDetails | null : T extends PythonBuildRequirementsRequest ? PythonBuildRequirementsStatus : T extends {
+    readonly hook: 'build_wheel' | 'build_legacy_wheel';
+} ? string : string[];
+export interface PythonBuildHookContext extends Pick<CommandContext, 'fs' | 'cwd' | 'env' | 'signal' | 'stdout' | 'stderr'> {
+    /** Total UTF-8 result metadata allowance; wheel bytes stay in caller storage. */
+    readonly maxBytes: number;
+}
+/** Run PEP 517 hooks against a caller-prepared source tree and package environment. */
+export declare function createPythonBuildBackend(options: PythonCommandsOptions & {
+    readonly environment: PythonPackageEnvironment;
+}): <T extends BuildRequest>(input: T, context: PythonBuildHookContext) => Promise<BuildResult<T>>;
+export declare const pythonBuildBackendProgram: string;
+export {};

package/dist/safe-bash-command-python/build-dependencies.d.ts

@@ -0,0 +1,13 @@
+import { type PythonCommandsOptions, type PythonPackageEnvironment } from './executor.js';
+import { type PythonBuildHookContext, type PythonBuildSystemDetails } from './build-backend.js';
+export interface PythonBuildDependenciesRequest {
+    readonly source: string;
+    readonly name?: string;
+    /** null selects native legacy setuptools requirement discovery. */
+    readonly buildSystem: PythonBuildSystemDetails | null;
+    readonly configSettings?: Readonly<Record<string, string | readonly string[]>>;
+}
+/** Install declared then missing backend requirements in an explicit build environment. */
+export declare function createPythonBuildDependencies(options: Omit<PythonCommandsOptions, 'packages' | 'requirements' | 'packageProfile' | 'provisioning'> & {
+    readonly environment: PythonPackageEnvironment;
+}): (input: PythonBuildDependenciesRequest, caller: PythonBuildHookContext) => Promise<void>;

package/dist/safe-bash-command-python/build-environment.d.ts

@@ -0,0 +1,3 @@
+import { type PythonPackageEnvironment, type PythonPackageOptions } from './provisioning.js';
+/** Fresh build dependency state with the caller's explicit artifact and network authority. */
+export declare function createPythonBuildEnvironment(options?: PythonPackageOptions): PythonPackageEnvironment;

package/dist/safe-bash-command-python/build-wheel.d.ts

@@ -0,0 +1,8 @@
+import type { PythonPackageContext } from './provisioning.js';
+export interface PythonBuiltWheel {
+    readonly url: string;
+    readonly digest: string;
+    readonly size: number;
+}
+/** Publish a build result in caller-owned storage, independently of build cleanup. */
+export declare function publishPythonBuildWheel(source: string, directory: string, maxBytes: number, context: PythonPackageContext): Promise<PythonBuiltWheel>;

package/dist/safe-bash-command-python/executor.d.ts

@@ -4,7 +4,11 @@ import { type PythonDiagnosticObserver } from './diagnostics.js';
 import { createPythonHostBridge, type PythonHostCapability, type PythonHostBridgeOptions } from './host-capabilities.js';
 export * from './host-capabilities.js';
 export { createPythonShellCapability } from './shell-capability.js';
-export { createPythonLlmToolLoader } from './llm-functions-loader.js';
+export { createPythonLlmPackageManager } from './llm-package-manager.js';
+export { createPythonLlmTemplateLoader } from './llm-template-loader.js';
+export { createPythonLlmLoaderDiscovery, createPythonLlmLoaderProvider, type PythonLlmDiscoveredLoaders, type PythonLlmLoaderDiscoveryContext } from './llm-loader-discovery.js';
+export { createPythonLlmFragmentLoader } from './llm-fragment-loader.js';
+export { createPythonLlmToolLoader, type PythonLlmToolLoaderOptions } from './llm-functions-loader.js';
 export { createPythonLlmCapability, type PythonLlmCapabilityOptions } from './llm-capability.js';
 /** A dedicated interpreter worker. The service event loop must never block. */
 export interface PythonWorkerEndpoint {
@@ -75,7 +79,11 @@ export declare function createPythonExecutorCommands(options: PythonCommandsOpti
 /** Explicit executor registration excludes the default artifact renderer. */
 export declare function pythonExecutorCommands(options: PythonCommandsOptions): VirtualShellPlugin;
 export { createPythonPackageEnvironment, pythonDocumentPackages } from './provisioning.js';
-export type { PythonPackageOptions, PythonPackageCache, PythonPackageProgress, PythonPackageStart, PythonPackageContext, PythonPackageEnvironment, PythonPackagePrepareContext } from './provisioning.js';
+export { createPythonBuildEnvironment } from './build-environment.js';
+export { createPythonBuildDependencies, type PythonBuildDependenciesRequest } from './build-dependencies.js';
+export { createPythonSourceSnapshot, type PythonSourceSnapshot } from './source-snapshot.js';
+export { createPythonBuildBackend, type PythonBuildHookRequest, type PythonSourceRequirementRequest, type PythonEditableRequirementRequest, type PythonSourceRequirement, type PythonLegacyBuildRequest, type PythonLegacyRequirementsRequest, type PythonBuildHookContext, type PythonBuildSystemRequest, type PythonBuildSystemDetails, type PythonBuildRequirementsRequest, type PythonBuildRequirementsStatus } from './build-backend.js';
+export type { PythonPackageInstallOptions, PythonPackageOptions, PythonPackageCache, PythonPackageProgress, PythonPackageStart, PythonPackageContext, PythonPackageEnvironment, PythonPackagePrepareContext } from './provisioning.js';
 export { PythonPackageConflictError, createPythonPackageManifestStore } from './manifest.js';
 export type { PythonPackageManifest, PythonPackageManifestStore } from './manifest.js';
 export { createPythonPackageCache } from './cache.js';
@@ -91,3 +99,5 @@ export { PythonFailure, inspectPythonCapabilities } from './diagnostics.js';
 export type { PythonFailureCategory, PythonDiagnostic, PythonDiagnosticObserver, PythonFileSystemRequirement, PythonCapabilityOptions, PythonCapabilityReport } from './diagnostics.js';
 export { pythonLlmPackages, installPythonLlmPackages } from './llm-packages.js';
 export type { PythonLlmPackageAsset } from './llm-packages.js';
+export { publishPythonBuildWheel, type PythonBuiltWheel } from './build-wheel.js';
+export { createPythonSourcePackageEnvironment, type PythonSourceBuildOptions } from './source-environment.js';

package/dist/safe-bash-command-python/executor.js

@@ -1,28 +1,40 @@
 import {
+  createPythonBuildBackend,
+  createPythonBuildDependencies,
+  createPythonBuildEnvironment,
   createPythonExecutorCommands,
+  createPythonLlmFragmentLoader,
+  createPythonLlmLoaderDiscovery,
+  createPythonLlmLoaderProvider,
+  createPythonLlmPackageManager,
+  createPythonLlmTemplateLoader,
   createPythonLlmToolLoader,
+  createPythonSourcePackageEnvironment,
+  createPythonSourceSnapshot,
   installPythonLlmPackages,
+  publishPythonBuildWheel,
   pythonExecutorCommands,
   pythonLlmPackages
-} from "../safe-bash/command-chunks/chunk-RHXV2KG5.js";
+} from "../safe-bash/command-chunks/chunk-NNGWTDVJ.js";
 import {
   PythonPackageConflictError,
   createPythonPackageCache,
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,
   pythonDocumentPackages
-} from "../safe-bash/command-chunks/chunk-R4NPYXQX.js";
+} from "../safe-bash/command-chunks/chunk-IKBTII7C.js";
 import {
   createPythonShellCapability
 } from "../safe-bash/command-chunks/chunk-NHAG4DWL.js";
+import "../safe-bash/command-chunks/chunk-NXCJNPL3.js";
 import {
   createPythonJspiAssets
 } from "../safe-bash/command-chunks/chunk-IOZTDDNT.js";
 import {
   createPythonJspiExecutor
-} from "../safe-bash/command-chunks/chunk-4Q3HP33O.js";
+} from "../safe-bash/command-chunks/chunk-NW3S6T6R.js";
 import "../safe-bash/command-chunks/chunk-FXWKMNX2.js";
-import "../safe-bash/command-chunks/chunk-5EFNQ6FY.js";
+import "../safe-bash/command-chunks/chunk-3EBQOZET.js";
 import {
   createPythonJspiNativeCall,
   createPythonJspiStatResult,
@@ -53,6 +65,9 @@ import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   PythonFailure,
   PythonPackageConflictError,
+  createPythonBuildBackend,
+  createPythonBuildDependencies,
+  createPythonBuildEnvironment,
   createPythonExecutorCommands,
   createPythonExecutorPool,
   createPythonHostBridge,
@@ -62,14 +77,22 @@ export {
   createPythonJspiStatResult,
   createPythonJspiTrampoline,
   createPythonLlmCapability,
+  createPythonLlmFragmentLoader,
+  createPythonLlmLoaderDiscovery,
+  createPythonLlmLoaderProvider,
+  createPythonLlmPackageManager,
+  createPythonLlmTemplateLoader,
   createPythonLlmToolLoader,
   createPythonPackageCache,
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,
   createPythonShellCapability,
+  createPythonSourcePackageEnvironment,
+  createPythonSourceSnapshot,
   inspectPythonCapabilities,
   installPythonLlmDependencies,
   installPythonLlmPackages,
+  publishPythonBuildWheel,
   pythonDocumentPackages,
   pythonExecutorCommands,
   pythonHostFailureCode,

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

@@ -1,28 +1,40 @@
 import {
+  createPythonBuildBackend,
+  createPythonBuildDependencies,
+  createPythonBuildEnvironment,
   createPythonExecutorCommands,
+  createPythonLlmFragmentLoader,
+  createPythonLlmLoaderDiscovery,
+  createPythonLlmLoaderProvider,
+  createPythonLlmPackageManager,
+  createPythonLlmTemplateLoader,
   createPythonLlmToolLoader,
+  createPythonSourcePackageEnvironment,
+  createPythonSourceSnapshot,
   installPythonLlmPackages,
+  publishPythonBuildWheel,
   pythonExecutorCommands,
   pythonLlmPackages
-} from "../safe-bash/command-chunks/chunk-RHXV2KG5.js";
+} from "../safe-bash/command-chunks/chunk-NNGWTDVJ.js";
 import {
   PythonPackageConflictError,
   createPythonPackageCache,
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,
   pythonDocumentPackages
-} from "../safe-bash/command-chunks/chunk-R4NPYXQX.js";
+} from "../safe-bash/command-chunks/chunk-IKBTII7C.js";
 import {
   createPythonShellCapability
 } from "../safe-bash/command-chunks/chunk-NHAG4DWL.js";
+import "../safe-bash/command-chunks/chunk-NXCJNPL3.js";
 import {
   createPythonJspiAssets
 } from "../safe-bash/command-chunks/chunk-IOZTDDNT.js";
 import {
   createPythonJspiExecutor
-} from "../safe-bash/command-chunks/chunk-4Q3HP33O.js";
+} from "../safe-bash/command-chunks/chunk-NW3S6T6R.js";
 import "../safe-bash/command-chunks/chunk-FXWKMNX2.js";
-import "../safe-bash/command-chunks/chunk-5EFNQ6FY.js";
+import "../safe-bash/command-chunks/chunk-3EBQOZET.js";
 import {
   createPythonJspiNativeCall,
   createPythonJspiStatResult,
@@ -422,6 +434,9 @@ function pythonCommands(options) {
 export {
   PythonFailure,
   PythonPackageConflictError,
+  createPythonBuildBackend,
+  createPythonBuildDependencies,
+  createPythonBuildEnvironment,
   createPythonCommands,
   createPythonExecutorCommands,
   createPythonExecutorPool,
@@ -432,14 +447,22 @@ export {
   createPythonJspiStatResult,
   createPythonJspiTrampoline,
   createPythonLlmCapability,
+  createPythonLlmFragmentLoader,
+  createPythonLlmLoaderDiscovery,
+  createPythonLlmLoaderProvider,
+  createPythonLlmPackageManager,
+  createPythonLlmTemplateLoader,
   createPythonLlmToolLoader,
   createPythonPackageCache,
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,
   createPythonShellCapability,
+  createPythonSourcePackageEnvironment,
+  createPythonSourceSnapshot,
   inspectPythonCapabilities,
   installPythonLlmDependencies,
   installPythonLlmPackages,
+  publishPythonBuildWheel,
   pythonCommands,
   pythonDocumentPackages,
   pythonExecutorCommands,

package/dist/safe-bash-command-python/jspi.js

@@ -1,8 +1,8 @@
 import {
   createPythonJspiExecutor
-} from "../safe-bash/command-chunks/chunk-4Q3HP33O.js";
+} from "../safe-bash/command-chunks/chunk-NW3S6T6R.js";
 import "../safe-bash/command-chunks/chunk-FXWKMNX2.js";
-import "../safe-bash/command-chunks/chunk-5EFNQ6FY.js";
+import "../safe-bash/command-chunks/chunk-3EBQOZET.js";
 import "../safe-bash/command-chunks/chunk-P56KGNW7.js";
 import "../safe-bash/command-chunks/chunk-NK3FRG5O.js";
 import "../safe-bash/command-chunks/chunk-XNJGNDFW.js";

package/dist/safe-bash-command-python/llm-assets-node.js

@@ -91,7 +91,7 @@ export async function readPythonLlmAssets(directory) {
             maxTotalBytes: distribution.expandedBytes, maxBufferedFileBytes: distribution.expandedBytes * 3,
             maxMembers: 10000, maxPathBytes: 1024, maxDepth: 32, maxPaxBytes: 65536,
             maxTextBytes: distribution.expandedBytes };
-        const archive = await readZipArchive(bytes, limits, signal);
+        const archive = await readZipArchive(bytes, limits, signal, { allowUnreferencedData: true });
         for (const native of distribution.nativeModules) {
             const entry = archive.entries.find(entry => entry.name === native.path);
             if (!entry || entry.directory || entry.symlink || entry.size !== native.bytes)

package/dist/safe-bash-command-python/llm-fragment-loader.d.ts

@@ -0,0 +1,6 @@
+import { type LlmFragmentLoader } from "../safe-bash-command-llm/index.js";
+import type { PythonLlmToolLoaderOptions } from './llm-functions-loader.js';
+/** Each explicitly authorized native loader invocation owns its interpreter.
+ * Results are staged one at a time in caller storage and borrowed until next(). */
+export declare function createPythonLlmFragmentLoader(options: PythonLlmToolLoaderOptions, prefix: string): LlmFragmentLoader;
+export declare const pythonLlmFragmentProgram: string;

package/dist/safe-bash-command-python/llm-functions-loader.d.ts

@@ -1,5 +1,9 @@
 import { type LlmToolLoader } from "../safe-bash-command-llm/index.js";
 import { type PythonCommandsOptions } from './executor.js';
+export interface PythonLlmToolLoaderOptions extends PythonCommandsOptions {
+    /** Explicit installed distributions whose tooling hooks the host authorizes. */
+    readonly plugins?: readonly string[];
+}
 /** Reuse one configured interpreter per load, retaining only caller-backed tool
  * payloads. The session must outlive consumption of its borrowed results. */
-export declare function createPythonLlmToolLoader(options: PythonCommandsOptions): LlmToolLoader;
+export declare function createPythonLlmToolLoader(options: PythonLlmToolLoaderOptions): LlmToolLoader;

package/dist/safe-bash-command-python/llm-loader-discovery.d.ts

@@ -0,0 +1,13 @@
+import type { LlmFragmentLoader, LlmLoaderDiscoveryContext, LlmLoaderProvider, LlmTemplateLoader } from "../safe-bash-command-llm/index.js";
+import type { PythonLlmToolLoaderOptions } from './llm-functions-loader.js';
+export interface PythonLlmDiscoveredLoaders {
+    readonly fragmentLoaders: ReadonlyMap<string, LlmFragmentLoader>;
+    readonly templateLoaders: ReadonlyMap<string, LlmTemplateLoader>;
+}
+export type PythonLlmLoaderDiscoveryContext = LlmLoaderDiscoveryContext;
+/** Discover at listing time and resolve prefixes without an extra native hook pass. */
+export declare function createPythonLlmLoaderProvider(options: PythonLlmToolLoaderOptions): LlmLoaderProvider;
+/** Discover native prefixes only from explicitly authorized installed plugins.
+ * Invoke again after changing the environment; no ambient registry is retained. */
+export declare function createPythonLlmLoaderDiscovery(options: PythonLlmToolLoaderOptions): (context: PythonLlmLoaderDiscoveryContext) => Promise<PythonLlmDiscoveredLoaders>;
+export declare const pythonLlmLoaderDiscoveryProgram: string;

package/dist/safe-bash-command-python/llm-package-manager.d.ts

@@ -0,0 +1,7 @@
+import type { LlmPackageManager } from "../safe-bash-command-llm/index.js";
+import { type PythonCommandsOptions, type PythonPackageEnvironment } from './executor.js';
+/** Parse with the pinned LLM CLI, then retire it before mutating the shared
+ * caller-owned package environment in a separate interpreter. */
+export declare function createPythonLlmPackageManager(options: PythonCommandsOptions & {
+    environment: PythonPackageEnvironment;
+}): LlmPackageManager;

package/dist/safe-bash-command-python/llm-template-loader.d.ts

@@ -0,0 +1,6 @@
+import type { LlmTemplateLoader } from "../safe-bash-command-llm/index.js";
+import type { PythonLlmToolLoaderOptions } from './llm-functions-loader.js';
+/** Execute an explicitly authorized native loader within the caller's remaining
+ * template materialization allowance. Native JSON travels in bounded windows. */
+export declare function createPythonLlmTemplateLoader(options: PythonLlmToolLoaderOptions, prefix: string): LlmTemplateLoader;
+export declare const pythonLlmTemplateProgram: string;

package/dist/safe-bash-command-python/manifest.d.ts

@@ -1,3 +1,20 @@
+/** Native distribution metadata and pip-compatible removal listings. */
+export type PythonPackageRecord = readonly [name: string, metadata: string, origin: string, remove: readonly string[], skip: readonly string[], directUrl?: string | null];
+/** Exact installed requirements; newer snapshots can uninstall without wheels. */
+export type PythonInstalledSnapshot = {
+    readonly version: 1;
+    readonly installed: readonly string[];
+} | {
+    readonly version: 2;
+    readonly installed: readonly string[];
+    readonly records: readonly PythonPackageRecord[];
+} | {
+    readonly version: 3;
+    readonly installed: readonly string[];
+    readonly records: readonly PythonPackageRecord[];
+};
+/** Accept legacy requirements and validated versioned installed snapshots. */
+export declare function readPackageManifest(value: unknown): readonly string[] | undefined;
 export interface PythonPackageManifest {
     readonly revision: string;
     readonly bytes: Uint8Array;

package/dist/safe-bash-command-python/provisioning.d.ts

@@ -1,6 +1,6 @@
 import type { FileSystem } from "../safe-bash-contracts/filesystem.js";
 import type { HttpTransport, NetworkAuthorizer } from "../safe-bash-network-engine/types.js";
-import { type PythonPackageManifestStore } from './manifest.js';
+import { type PythonPackageManifestStore, type PythonPackageRecord } from './manifest.js';
 import { type PythonPackageCache } from './cache.js';
 export type { PythonPackageCache } from './cache.js';
 export interface PythonPackageProgress {
@@ -9,7 +9,21 @@ export interface PythonPackageProgress {
     readonly bytes?: number;
     readonly totalBytes?: number;
 }
-export interface PythonPackageOptions {
+export interface PythonPackageInstallOptions {
+    /** Local source trees whose installed imports remain linked to caller storage. */
+    readonly editable?: readonly string[];
+    /** Include prerelease and development candidates during dependency resolution. */
+    readonly pre?: boolean;
+    /** Select the newest eligible requested roots, retaining satisfying dependencies. */
+    readonly upgrade?: boolean;
+    /** Reinstall the requested dependency graph even when installed versions satisfy it. */
+    readonly forceReinstall?: boolean;
+    /** Bypass artifact cache reads and writes; environment snapshots still persist. */
+    readonly noCache?: boolean;
+}
+export interface PythonPackageOptions extends PythonPackageInstallOptions {
+    /** Resolve sources and requirement-file option lines before installation; restored pins are unchanged. */
+    readonly prepareRequirements?: (requirements: readonly string[], context: PythonPackagePrepareContext) => Promise<readonly string[]>;
     readonly requirements?: readonly string[];
     readonly requirementFiles?: readonly string[];
     readonly profile?: 'documents';
@@ -29,9 +43,26 @@ export interface PythonPackageOptions {
     readonly maxCacheBytes?: number;
     readonly onProgress?: (event: PythonPackageProgress) => void;
 }
-export interface PythonPackageStart {
+export interface PythonPackageStart extends Omit<PythonPackageInstallOptions, 'noCache' | 'editable'> {
     readonly session: string;
+    /** Load installer tooling even when no application requirements are installed. */
+    readonly bootstrap?: boolean;
+    /** Additional native runtime tooling, excluded from application inventory. */
+    readonly bootstrapPackages?: readonly string[];
+    /** Combined requirements for compatibility with custom executors. */
     readonly requirements: readonly string[];
+    /** Legacy requirements need one dependency-resolution pass before migration. */
+    readonly legacy?: boolean;
+    /** Installed metadata used only by uninstall; application startup still restores code. */
+    readonly records?: readonly PythonPackageRecord[] | undefined;
+    /** Prior installation; only legacy manifests resolve dependencies during restore. */
+    readonly restore?: readonly string[];
+    /** New or host-configured requirements whose dependency closure is resolved. */
+    readonly requested?: readonly string[];
+    readonly uninstall?: {
+        readonly packages: readonly string[];
+        readonly yes: boolean;
+    };
     readonly offline: boolean;
 }
 export interface PythonPackageContext {
@@ -39,7 +70,8 @@ export interface PythonPackageContext {
     readonly cwd: string;
     readonly signal: AbortSignal;
 }
-export interface PythonPackagePrepareContext extends PythonPackageContext {
+export interface PythonPackagePrepareContext extends PythonPackageContext, PythonPackageInstallOptions, Partial<Pick<import("../safe-bash-contracts/index.js").CommandContext, 'env' | 'stdout' | 'stderr' | 'registerCleanup' | 'args'>> {
+    readonly uninstall?: PythonPackageStart['uninstall'];
     readonly requirements?: readonly string[];
     readonly requirementFiles?: readonly string[];
     readonly offline?: boolean;
@@ -47,7 +79,7 @@ export interface PythonPackagePrepareContext extends PythonPackageContext {
 export interface PythonPackageEnvironment {
     prepare(context: PythonPackagePrepareContext): Promise<PythonPackageStart>;
     dispatch(operation: string, args: unknown[], context: PythonPackageContext): Promise<unknown>;
-    finish(start: PythonPackageStart): void;
+    finish(start: PythonPackageStart): void | Promise<void>;
     dispose(): Promise<void>;
 }
 export declare const pythonDocumentPackages: readonly string[];

package/dist/safe-bash-command-python/provisioning.js

@@ -1,7 +1,8 @@
 import {
   createPythonPackageEnvironment,
   pythonDocumentPackages
-} from "../safe-bash/command-chunks/chunk-R4NPYXQX.js";
+} from "../safe-bash/command-chunks/chunk-IKBTII7C.js";
+import "../safe-bash/command-chunks/chunk-NXCJNPL3.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   createPythonPackageEnvironment,

package/dist/safe-bash-command-python/source-archive.d.ts

@@ -0,0 +1,4 @@
+import type { CommandContext } from "../safe-bash-contracts/index.js";
+import { type PythonSourceArchiveMetadata } from './source-zip.js';
+/** Optional source-archive host capability, using the existing ZIP and tar engines. */
+export declare function extractPythonSourceArchive(source: string, directory: string, maxBytes: number, context: CommandContext, metadata?: PythonSourceArchiveMetadata): Promise<void>;