@poe-platform/safe-bash 0.1.821 → 0.1.823

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

@@ -3,19 +3,19 @@ import {
   createLlmCommands,
   llmCommands,
   llmReferenceVersion
-} from "../safe-bash/command-chunks/chunk-RKAL5VFP.js";
-import "../safe-bash/command-chunks/chunk-MCUDSE4H.js";
-import "../safe-bash/command-chunks/chunk-WOT2YXBT.js";
-import "../safe-bash/command-chunks/chunk-BZLLQWRK.js";
+} from "../safe-bash/command-chunks/chunk-PLVFJ6FF.js";
+import "../safe-bash/command-chunks/chunk-EWECMOQ5.js";
+import "../safe-bash/command-chunks/chunk-7ZQVMPSB.js";
+import "../safe-bash/command-chunks/chunk-E5CDHXFA.js";
 import "../safe-bash/command-chunks/chunk-SENLC5KK.js";
 import "../safe-bash/command-chunks/chunk-3PO534WJ.js";
 import "../safe-bash/command-chunks/chunk-B74LVFAN.js";
 import "../safe-bash/command-chunks/chunk-GDH7OVYK.js";
-import "../safe-bash/command-chunks/chunk-GQV5RWMN.js";
+import "../safe-bash/command-chunks/chunk-ZFXHSFTU.js";
 import "../safe-bash/command-chunks/chunk-CKQ5SXOO.js";
 import "../safe-bash/command-chunks/chunk-B6NAEWHC.js";
 import "../safe-bash/command-chunks/chunk-E47FFS5M.js";
-import "../safe-bash/command-chunks/chunk-QX3WKBLI.js";
+import "../safe-bash/command-chunks/chunk-36FV6BAG.js";
 import "../safe-bash/command-chunks/chunk-GNPPPYDF.js";
 import "../safe-bash/command-chunks/chunk-VMA3NJXU.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

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

@@ -1,6 +1,7 @@
 import type { CommandContext, FileSystem } from "../safe-bash-contracts/index.js";
 import type { LlmInputSource } from './types.js';
 import type { LlmFragmentInputSource } from './fragments.js';
+import { type LlmLoaderProvider } from './loader-provider.js';
 export type LlmLoadedFragment = {
     readonly type: 'text';
     readonly source: LlmFragmentInputSource;
@@ -10,7 +11,7 @@ export type LlmLoadedFragment = {
     readonly mimeType: string;
     readonly id?: string;
 };
-export interface LlmFragmentLoaderContext {
+export interface LlmFragmentLoaderContext extends Partial<Omit<CommandContext, 'fs' | 'cwd' | 'signal'>> {
     readonly fs: FileSystem;
     readonly cwd: string;
     readonly signal: AbortSignal;
@@ -26,4 +27,4 @@ export declare function getLlmFragmentPrefix(reference: string): string | undefi
 /** Preserve registration order and the reference's collision suffixes. */
 export declare function createLlmFragmentLoaders(entries: Iterable<readonly [string, LlmFragmentLoader]>): ReadonlyMap<string, LlmFragmentLoader>;
 /** Resolve an injected loader without ambient plugin imports or history. */
-export declare function loadLlmPluginFragments(reference: string, loaders: ReadonlyMap<string, LlmFragmentLoader>, context: LlmFragmentLoaderContext, allowAttachments?: boolean): AsyncGenerator<LlmLoadedFragment>;
+export declare function loadLlmPluginFragments(reference: string, loaders: ReadonlyMap<string, LlmFragmentLoader>, context: LlmFragmentLoaderContext, allowAttachments?: boolean, provider?: Pick<LlmLoaderProvider, 'fragments'>): AsyncGenerator<LlmLoadedFragment>;

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

@@ -1,4 +1,5 @@
 export { serializeLlmTokenUsage } from "./usage.js";
+export { LlmLoaderLookupError, type LlmLoaderProvider, type LlmDiscoveredLoaders, type LlmLoaderDiscoveryContext } from './loader-provider.js';
 export { createLlmToolRegistry, selectLlmTools, type LlmRegisteredTool, type LlmToolLoader, type LlmToolboxDescription, type LlmPluginQuery, type LlmPluginInfo } from './tool-registry.js';
 export { executeLlmToolCalls, LlmCancelToolCall, type LlmToolContext, type LlmToolOutput, type LlmExecutableTool, type LlmToolExecutionResult, type LlmToolExecutionOptions } from './tool-execution.js';
 export type { LlmTool, LlmToolCall, LlmMessage } from "./types.js";
@@ -6,13 +7,13 @@ export { createLlmInputBudget, type LlmInputLimits } from "./input-budget.js";
 export * from "./provider-serialization.js";
 export { llmReferenceVersion, createLlmCommand, createLlmCommands, llmCommands } from "./command.js";
 export { createLlmService, type LlmService, type LlmServiceOptions, type LlmServiceModel, type LlmStreamEvent, type LlmServiceRequest, type LlmServiceSourceRequest } from "./service.js";
-export type { LlmInputSource, LlmSourceRequest, LlmAttachment, LlmSourceAttachment, LlmModelOption, LlmOption, LlmCapability, LlmResponseMetadata, LlmEmbeddingRequest, LlmEmbeddingSourceRequest, LlmEmbeddingResponse, LlmLimits, LlmCommandsOptions, LlmProvider, LlmModel, LlmRequest } from "./types.js";
+export type { LlmPackageManager, LlmInputSource, LlmSourceRequest, LlmAttachment, LlmSourceAttachment, LlmModelOption, LlmOption, LlmCapability, LlmResponseMetadata, LlmEmbeddingRequest, LlmEmbeddingSourceRequest, LlmEmbeddingResponse, LlmLimits, LlmCommandsOptions, LlmProvider, LlmModel, LlmRequest } from "./types.js";
 export { serializeOpenAiChatRequest, type OpenAiChatSourceRequest, createOpenAiProvider, type OpenAiModel, type OpenAiProviderOptions } from "./openai.js";
 export { createElevenLabsProvider, type ElevenLabsModel, type ElevenLabsProviderOptions } from "./elevenlabs.js";
 export type { LlmProviderLimits } from "./providers/shared.js";
 export { createLlmConfiguration, type LlmConfiguration } from "./configuration.js";
 export { validateModelOptions } from "./model-options.js";
-export { createLlmTemplateStore, evaluateLlmTemplate, llmTemplateUsesInput, validateLlmTemplateParameters, type LlmTemplate, type LlmTemplateLoader, type TemplateLoaderOptions } from "./templates.js";
+export { createLlmTemplateStore, evaluateLlmTemplate, llmTemplateUsesInput, validateLlmTemplateParameters, type LlmTemplate, type LlmTemplateLoader, type LlmTemplateLoaderContext, type TemplateLoaderOptions } from "./templates.js";
 export { templateYaml } from "./template-yaml.js";
 export { findExtractedRange } from "./extract-range.js";
 export { parseLlmSchemaDsl } from "./schemas.js";

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

@@ -10,14 +10,15 @@ import {
   chatJson,
   createOpenAiProvider,
   openAiChatOptions
-} from "../safe-bash/command-chunks/chunk-IAHYG67O.js";
+} from "../safe-bash/command-chunks/chunk-V5ZBRM5R.js";
 import {
   jsonString
-} from "../safe-bash/command-chunks/chunk-CJIFJ45R.js";
+} from "../safe-bash/command-chunks/chunk-QBCEAYQT.js";
 import "../safe-bash/command-chunks/chunk-UN2RIRCD.js";
 import "../safe-bash/command-chunks/chunk-HLRLMFMS.js";
 import {
   LlmCancelToolCall,
+  LlmLoaderLookupError,
   createLlmCommand,
   createLlmCommands,
   createLlmFragmentLoaders,
@@ -43,14 +44,14 @@ import {
   serializeLlmTokenUsage,
   streamLlmToolChain,
   validateLlmTemplateParameters
-} from "../safe-bash/command-chunks/chunk-RKAL5VFP.js";
-import "../safe-bash/command-chunks/chunk-MCUDSE4H.js";
+} from "../safe-bash/command-chunks/chunk-PLVFJ6FF.js";
+import "../safe-bash/command-chunks/chunk-EWECMOQ5.js";
 import {
   createLlmConfiguration
-} from "../safe-bash/command-chunks/chunk-WOT2YXBT.js";
+} from "../safe-bash/command-chunks/chunk-7ZQVMPSB.js";
 import {
   createLlmSpool
-} from "../safe-bash/command-chunks/chunk-BZLLQWRK.js";
+} from "../safe-bash/command-chunks/chunk-E5CDHXFA.js";
 import {
   createLlmService,
   validateModelOptions
@@ -62,13 +63,13 @@ import {
 import "../safe-bash/command-chunks/chunk-GDH7OVYK.js";
 import {
   base64Stream
-} from "../safe-bash/command-chunks/chunk-GQV5RWMN.js";
+} from "../safe-bash/command-chunks/chunk-ZFXHSFTU.js";
 import "../safe-bash/command-chunks/chunk-CKQ5SXOO.js";
 import {
   resolveUrlAttachment
 } from "../safe-bash/command-chunks/chunk-B6NAEWHC.js";
 import "../safe-bash/command-chunks/chunk-E47FFS5M.js";
-import "../safe-bash/command-chunks/chunk-QX3WKBLI.js";
+import "../safe-bash/command-chunks/chunk-36FV6BAG.js";
 import {
   jsonValue
 } from "../safe-bash/command-chunks/chunk-GNPPPYDF.js";
@@ -76,6 +77,7 @@ import "../safe-bash/command-chunks/chunk-VMA3NJXU.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   LlmCancelToolCall,
+  LlmLoaderLookupError,
   createElevenLabsProvider,
   createLlmCommand,
   createLlmCommands,

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

@@ -0,0 +1,25 @@
+import type { LlmFragmentLoader, LlmFragmentLoaderContext } from './fragment-loaders.js';
+import type { LlmTemplateLoader } from './templates.js';
+export interface LlmDiscoveredLoaders {
+    readonly fragmentLoaders: ReadonlyMap<string, LlmFragmentLoader>;
+    readonly templateLoaders: ReadonlyMap<string, LlmTemplateLoader>;
+}
+export interface LlmLoaderDiscoveryContext extends LlmFragmentLoaderContext {
+    readonly kind?: 'fragments' | 'templates';
+    /** Charge metadata before retention, in addition to maxBytes admission. */
+    readonly admitBytes?: ((size: number) => void) | undefined;
+}
+export interface LlmLoaderProvider {
+    discover(context: LlmLoaderDiscoveryContext): Promise<LlmDiscoveredLoaders>;
+    /** Resolve lazily; discovery must not run again before executing a loader. */
+    fragments(prefix: string): LlmFragmentLoader | undefined;
+    templates(prefix: string): LlmTemplateLoader | undefined;
+}
+/** Lookup failures precede loader execution and retain their native diagnostic. */
+export declare class LlmLoaderLookupError extends Error {
+}
+export declare function discoverLlmLoaders(loaders: ReadonlyMap<string, {
+    readonly description?: string;
+}> | undefined, context: LlmLoaderDiscoveryContext, provider?: LlmLoaderProvider): Promise<ReadonlyMap<string, {
+    readonly description?: string;
+}>>;

package/dist/safe-bash-command-llm/openai-sse.js

@@ -1,9 +1,9 @@
 import {
   openAiChat
-} from "../safe-bash/command-chunks/chunk-CJIFJ45R.js";
+} from "../safe-bash/command-chunks/chunk-QBCEAYQT.js";
 import "../safe-bash/command-chunks/chunk-UN2RIRCD.js";
 import "../safe-bash/command-chunks/chunk-E47FFS5M.js";
-import "../safe-bash/command-chunks/chunk-QX3WKBLI.js";
+import "../safe-bash/command-chunks/chunk-36FV6BAG.js";
 import "../safe-bash/command-chunks/chunk-GNPPPYDF.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {

package/dist/safe-bash-command-llm/openai.js

@@ -1,17 +1,17 @@
 import {
   chatJson,
   createOpenAiProvider
-} from "../safe-bash/command-chunks/chunk-IAHYG67O.js";
-import "../safe-bash/command-chunks/chunk-CJIFJ45R.js";
+} from "../safe-bash/command-chunks/chunk-V5ZBRM5R.js";
+import "../safe-bash/command-chunks/chunk-QBCEAYQT.js";
 import "../safe-bash/command-chunks/chunk-UN2RIRCD.js";
 import "../safe-bash/command-chunks/chunk-HLRLMFMS.js";
 import "../safe-bash/command-chunks/chunk-B74LVFAN.js";
 import "../safe-bash/command-chunks/chunk-GDH7OVYK.js";
-import "../safe-bash/command-chunks/chunk-GQV5RWMN.js";
+import "../safe-bash/command-chunks/chunk-ZFXHSFTU.js";
 import "../safe-bash/command-chunks/chunk-CKQ5SXOO.js";
 import "../safe-bash/command-chunks/chunk-B6NAEWHC.js";
 import "../safe-bash/command-chunks/chunk-E47FFS5M.js";
-import "../safe-bash/command-chunks/chunk-QX3WKBLI.js";
+import "../safe-bash/command-chunks/chunk-36FV6BAG.js";
 import "../safe-bash/command-chunks/chunk-GNPPPYDF.js";
 import "../safe-bash/command-chunks/chunk-VMA3NJXU.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

package/dist/safe-bash-command-llm/providers/index.js

@@ -9,21 +9,21 @@ import {
   chatJson,
   createOpenAiProvider,
   openAiChatOptions
-} from "../../safe-bash/command-chunks/chunk-IAHYG67O.js";
+} from "../../safe-bash/command-chunks/chunk-V5ZBRM5R.js";
 import {
   jsonString
-} from "../../safe-bash/command-chunks/chunk-CJIFJ45R.js";
+} from "../../safe-bash/command-chunks/chunk-QBCEAYQT.js";
 import "../../safe-bash/command-chunks/chunk-UN2RIRCD.js";
 import "../../safe-bash/command-chunks/chunk-HLRLMFMS.js";
 import "../../safe-bash/command-chunks/chunk-B74LVFAN.js";
 import "../../safe-bash/command-chunks/chunk-GDH7OVYK.js";
 import {
   base64Stream
-} from "../../safe-bash/command-chunks/chunk-GQV5RWMN.js";
+} from "../../safe-bash/command-chunks/chunk-ZFXHSFTU.js";
 import "../../safe-bash/command-chunks/chunk-CKQ5SXOO.js";
 import "../../safe-bash/command-chunks/chunk-B6NAEWHC.js";
 import "../../safe-bash/command-chunks/chunk-E47FFS5M.js";
-import "../../safe-bash/command-chunks/chunk-QX3WKBLI.js";
+import "../../safe-bash/command-chunks/chunk-36FV6BAG.js";
 import {
   jsonValue
 } from "../../safe-bash/command-chunks/chunk-GNPPPYDF.js";

package/dist/safe-bash-command-llm/providers/openai.js

@@ -2,17 +2,17 @@ import "../../safe-bash/command-chunks/chunk-MUUY3FZC.js";
 import {
   chatJson,
   createOpenAiProvider
-} from "../../safe-bash/command-chunks/chunk-IAHYG67O.js";
-import "../../safe-bash/command-chunks/chunk-CJIFJ45R.js";
+} from "../../safe-bash/command-chunks/chunk-V5ZBRM5R.js";
+import "../../safe-bash/command-chunks/chunk-QBCEAYQT.js";
 import "../../safe-bash/command-chunks/chunk-UN2RIRCD.js";
 import "../../safe-bash/command-chunks/chunk-HLRLMFMS.js";
 import "../../safe-bash/command-chunks/chunk-B74LVFAN.js";
 import "../../safe-bash/command-chunks/chunk-GDH7OVYK.js";
-import "../../safe-bash/command-chunks/chunk-GQV5RWMN.js";
+import "../../safe-bash/command-chunks/chunk-ZFXHSFTU.js";
 import "../../safe-bash/command-chunks/chunk-CKQ5SXOO.js";
 import "../../safe-bash/command-chunks/chunk-B6NAEWHC.js";
 import "../../safe-bash/command-chunks/chunk-E47FFS5M.js";
-import "../../safe-bash/command-chunks/chunk-QX3WKBLI.js";
+import "../../safe-bash/command-chunks/chunk-36FV6BAG.js";
 import "../../safe-bash/command-chunks/chunk-GNPPPYDF.js";
 import "../../safe-bash/command-chunks/chunk-VMA3NJXU.js";
 import "../../safe-bash/command-chunks/chunk-65DS4IOB.js";

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

@@ -2,3 +2,5 @@
 export declare function hasUnpairedSurrogate(value: string): boolean;
 /** Internal provenance for Python IDs that cannot be represented by a JS string. */
 export declare const pythonSurrogateId: unique symbol;
+/** Python sorts strings by Unicode code points, including supplementary planes. */
+export declare function unicodeOrder(left: string, right: string): number;

package/dist/safe-bash-command-llm/templates.d.ts

@@ -1,3 +1,4 @@
+import { type LlmLoaderProvider } from './loader-provider.js';
 import { type CommandContext } from "../safe-bash-contracts/index.js";
 export interface LlmTemplate {
     name: string;
@@ -26,14 +27,18 @@ export declare function evaluateLlmTemplate(value: LlmTemplate, input: string, p
     prompt: string;
     system?: string;
 };
-export type LlmTemplateLoader = ((remainder: string, signal: AbortSignal) => Promise<LlmTemplate> | LlmTemplate) & {
+export type LlmTemplateLoaderContext = LlmTemplateStoreContext & {
+    readonly maxBytes: number;
+};
+export type LlmTemplateLoader = ((remainder: string, signal: AbortSignal, context?: LlmTemplateLoaderContext) => Promise<LlmTemplate> | LlmTemplate) & {
     readonly description?: string;
 };
 export interface TemplateLoaderOptions {
+    readonly provider?: LlmLoaderProvider | undefined;
     readonly maxRemoteBytes: number;
     readonly maxBytes?: number;
     readonly admitBytes?: (size: number) => void;
-    readonly loaders?: ReadonlyMap<string, LlmTemplateLoader>;
+    readonly loaders?: ReadonlyMap<string, LlmTemplateLoader> | undefined;
 }
 export type LlmTemplateStoreContext = Pick<CommandContext, "fs" | "cwd" | "env" | "signal"> & Partial<Omit<CommandContext, "fs" | "cwd" | "env" | "signal">> & {
     readonly fetch?: typeof globalThis.fetch | undefined;

package/dist/safe-bash-command-llm/types.d.ts

@@ -1,6 +1,6 @@
 import type { LlmFragmentLoader } from "./fragment-loaders.js";
 import type { LlmRegisteredTool, LlmToolLoader } from "./tool-registry.js";
-import type { ByteSource } from "../safe-bash-contracts/index.js";
+import type { ByteSource, CommandContext, CommandResult } from "../safe-bash-contracts/index.js";
 import type { LlmService } from "./service.js";
 import type { LlmTemplateLoader } from "./templates.js";
 import type { LlmCollectionCommands } from './collections-command-types.js';
@@ -129,7 +129,13 @@ export interface LlmLimits {
     readonly maxBufferedInputBytes?: number;
     readonly maxOutputBytes: number;
 }
+export type LlmPackageManager = (request: {
+    readonly context: CommandContext;
+    readonly args: readonly string[];
+}) => Promise<CommandResult>;
 export interface LlmCommandsOptions {
+    readonly loaderProvider?: import('./loader-provider.js').LlmLoaderProvider;
+    readonly managePackages?: LlmPackageManager;
     readonly collections?: LlmCollectionCommands;
     readonly limits?: Partial<LlmLimits>;
     readonly service?: LlmService;

package/dist/safe-bash-command-mcp/index.browser.js

@@ -6198,6 +6198,9 @@ var HttpTransport = class {
     const modern = isObjectRecord2(metadata) && typeof metadata["io.modelcontextprotocol/protocolVersion"] === "string";
     if (modern) this.modernMode = true;
     if (parsed.type === "request" && parsed.message.method === "initialize") {
+      const superseded = [...this.modernRequests.values()];
+      this.modernRequests.clear();
+      for (const controller2 of superseded) controller2.abort();
       this.modernMode = false;
       this.initializationRequestId = parsed.message.id;
       this.legacyProtocolVersion = MCP_PROTOCOL_VERSION;

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

@@ -13809,6 +13809,9 @@ var HttpTransport = class {
     const modern = isObjectRecord5(metadata) && typeof metadata["io.modelcontextprotocol/protocolVersion"] === "string";
     if (modern) this.modernMode = true;
     if (parsed.type === "request" && parsed.message.method === "initialize") {
+      const superseded = [...this.modernRequests.values()];
+      this.modernRequests.clear();
+      for (const controller2 of superseded) controller2.abort();
       this.modernMode = false;
       this.initializationRequestId = parsed.message.id;
       this.legacyProtocolVersion = MCP_PROTOCOL_VERSION;

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

@@ -1,12 +1,12 @@
 import {
   patchCommand
-} from "../safe-bash/command-chunks/chunk-SLD5A7IL.js";
+} from "../safe-bash/command-chunks/chunk-OU5UEUZN.js";
 import "../safe-bash/command-chunks/chunk-6GCK2KSL.js";
 import "../safe-bash/command-chunks/chunk-2C4QMQQD.js";
 import "../safe-bash/command-chunks/chunk-OQNX2OOS.js";
 import "../safe-bash/command-chunks/chunk-5XUWGUGN.js";
 import "../safe-bash/command-chunks/chunk-AJEQUVDN.js";
-import "../safe-bash/command-chunks/chunk-RTUDDAAY.js";
+import "../safe-bash/command-chunks/chunk-O3KFOFJM.js";
 import "../safe-bash/command-chunks/chunk-KASXIRKD.js";
 import "../safe-bash/command-chunks/chunk-KHUT7BB5.js";
 import {

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

@@ -1,6 +1,6 @@
 import {
   PatchPublication
-} from "../safe-bash/command-chunks/chunk-RTUDDAAY.js";
+} from "../safe-bash/command-chunks/chunk-O3KFOFJM.js";
 import "../safe-bash/command-chunks/chunk-KASXIRKD.js";
 import "../safe-bash/command-chunks/chunk-KHUT7BB5.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

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

@@ -1,12 +1,12 @@
 import {
   patchCommand
-} from "../safe-bash/command-chunks/chunk-SLD5A7IL.js";
+} from "../safe-bash/command-chunks/chunk-OU5UEUZN.js";
 import "../safe-bash/command-chunks/chunk-6GCK2KSL.js";
 import "../safe-bash/command-chunks/chunk-2C4QMQQD.js";
 import "../safe-bash/command-chunks/chunk-OQNX2OOS.js";
 import "../safe-bash/command-chunks/chunk-5XUWGUGN.js";
 import "../safe-bash/command-chunks/chunk-AJEQUVDN.js";
-import "../safe-bash/command-chunks/chunk-RTUDDAAY.js";
+import "../safe-bash/command-chunks/chunk-O3KFOFJM.js";
 import "../safe-bash/command-chunks/chunk-KASXIRKD.js";
 import "../safe-bash/command-chunks/chunk-KHUT7BB5.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

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

@@ -0,0 +1,51 @@
+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 PythonBuildSystemRequest {
+    readonly hook: 'read_build_system';
+    readonly source: string;
+    readonly name?: string;
+    readonly usePep517?: boolean;
+}
+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[];
+}
+type BuildRequest = PythonBuildHookRequest | PythonBuildSystemRequest | PythonBuildRequirementsRequest;
+type BuildResult<T extends BuildRequest> = T extends PythonBuildSystemRequest ? PythonBuildSystemDetails | null : T extends PythonBuildRequirementsRequest ? PythonBuildRequirementsStatus : T extends {
+    readonly hook: 'build_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,12 @@
+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;
+    readonly buildSystem: PythonBuildSystemDetails;
+    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 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,17 +1,28 @@
 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-EO3RYGUZ.js";
 import {
   PythonPackageConflictError,
   createPythonPackageCache,
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,
   pythonDocumentPackages
-} from "../safe-bash/command-chunks/chunk-R4NPYXQX.js";
+} from "../safe-bash/command-chunks/chunk-WDTWJFPK.js";
 import {
   createPythonShellCapability
 } from "../safe-bash/command-chunks/chunk-NHAG4DWL.js";
@@ -20,9 +31,9 @@ import {
 } from "../safe-bash/command-chunks/chunk-IOZTDDNT.js";
 import {
   createPythonJspiExecutor
-} from "../safe-bash/command-chunks/chunk-4Q3HP33O.js";
+} from "../safe-bash/command-chunks/chunk-RGKHTSUY.js";
 import "../safe-bash/command-chunks/chunk-FXWKMNX2.js";
-import "../safe-bash/command-chunks/chunk-5EFNQ6FY.js";
+import "../safe-bash/command-chunks/chunk-64HIOP7Q.js";
 import {
   createPythonJspiNativeCall,
   createPythonJspiStatResult,
@@ -53,6 +64,9 @@ import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   PythonFailure,
   PythonPackageConflictError,
+  createPythonBuildBackend,
+  createPythonBuildDependencies,
+  createPythonBuildEnvironment,
   createPythonExecutorCommands,
   createPythonExecutorPool,
   createPythonHostBridge,
@@ -62,14 +76,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,17 +1,28 @@
 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-EO3RYGUZ.js";
 import {
   PythonPackageConflictError,
   createPythonPackageCache,
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,
   pythonDocumentPackages
-} from "../safe-bash/command-chunks/chunk-R4NPYXQX.js";
+} from "../safe-bash/command-chunks/chunk-WDTWJFPK.js";
 import {
   createPythonShellCapability
 } from "../safe-bash/command-chunks/chunk-NHAG4DWL.js";
@@ -20,9 +31,9 @@ import {
 } from "../safe-bash/command-chunks/chunk-IOZTDDNT.js";
 import {
   createPythonJspiExecutor
-} from "../safe-bash/command-chunks/chunk-4Q3HP33O.js";
+} from "../safe-bash/command-chunks/chunk-RGKHTSUY.js";
 import "../safe-bash/command-chunks/chunk-FXWKMNX2.js";
-import "../safe-bash/command-chunks/chunk-5EFNQ6FY.js";
+import "../safe-bash/command-chunks/chunk-64HIOP7Q.js";
 import {
   createPythonJspiNativeCall,
   createPythonJspiStatResult,
@@ -422,6 +433,9 @@ function pythonCommands(options) {
 export {
   PythonFailure,
   PythonPackageConflictError,
+  createPythonBuildBackend,
+  createPythonBuildDependencies,
+  createPythonBuildEnvironment,
   createPythonCommands,
   createPythonExecutorCommands,
   createPythonExecutorPool,
@@ -432,14 +446,22 @@ export {
   createPythonJspiStatResult,
   createPythonJspiTrampoline,
   createPythonLlmCapability,
+  createPythonLlmFragmentLoader,
+  createPythonLlmLoaderDiscovery,
+  createPythonLlmLoaderProvider,
+  createPythonLlmPackageManager,
+  createPythonLlmTemplateLoader,
   createPythonLlmToolLoader,
   createPythonPackageCache,
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,
   createPythonShellCapability,
+  createPythonSourcePackageEnvironment,
+  createPythonSourceSnapshot,
   inspectPythonCapabilities,
   installPythonLlmDependencies,
   installPythonLlmPackages,
+  publishPythonBuildWheel,
   pythonCommands,
   pythonDocumentPackages,
   pythonExecutorCommands,