@poe-platform/safe-bash 0.1.822 → 0.1.824

package/dist/safe-bash/shell/runtime.js

@@ -1421,11 +1421,20 @@ export class BudgetedPipeStageSink {
         }
     }
     writeSync(chunk) {
-        this.budget.assertPipelineInput(chunk.byteLength);
-        this.budget.bytes += chunk.byteLength;
+        if (!this.canWriteSync(chunk.byteLength))
+            return false;
+        this.signal.throwIfAborted();
+        if (!(chunk instanceof Uint8Array))
+            throw new TypeError("Shell output must be Uint8Array");
+        const budget = this.budget;
+        if (chunk.byteLength > budget.limits.maxOutputBytes - budget.bytes)
+            budget.fail("maxOutputBytes");
+        budget.assertPipelineInput(chunk.byteLength);
+        budget.bytes += chunk.byteLength;
         this.writable.write(chunk);
         if (chunk.byteLength && this.written)
             this.written.add(this.index);
+        return true;
     }
     write(chunk) {
         try {

package/dist/safe-bash/shell/sync-extra-evaluators.js

@@ -318,6 +318,9 @@ import { text as awkValueText, compare as awkCompare, inputValue as awkInputValu
 import { shellValueByteLength } from "../contracts/value.js";
 import { stateMonitor } from "./arrays/state.js";
 import { Budget, Runtime } from "./runtime.js";
+function canWriteBuiltinOutput(budget, pipe, byteLength) {
+    return (!pipe || pipe.canWriteSync(byteLength)) && (budget.bytes + byteLength <= budget.maxOutputBytesSmi || byteLength <= budget.limits.maxOutputBytes - budget.bytes);
+}
 const createFmtEngine = (...args) => syncCommandEvaluators.createFmtEngine(...args);
 const parseFmtArguments = (...args) => syncCommandEvaluators.parseFmtArguments(...args);
 const evalSyncCal = (...args) => syncCommandEvaluators.evalSyncCal?.(...args);
@@ -489,12 +492,14 @@ function initializeSyncPrototypes() {
         },
     });
     Object.assign(BudgetedPipeStageSink.prototype, {
-        canWriteSync() {
+        canWriteSync(byteLength = 0) {
             if (this.signal.aborted)
                 return false;
             const w = this.writable;
             const pipe = w._pipe;
-            return Boolean(w.open && pipe && !pipe.failed && !pipe.signal?.aborted && pipe.readerReferences && (!pipe.writes || pipe.writes.size === 0) && (pipe.availableBytes ?? 0) < (pipe.highWaterMark ?? 0));
+            const avail = pipe?.availableBytes ?? 0;
+            const hwm = pipe?.highWaterMark ?? 0;
+            return Boolean(w.open && pipe && !pipe.failed && !pipe.signal?.aborted && pipe.readerReferences && (!pipe.writes || pipe.writes.size === 0) && (byteLength > 0 ? avail + byteLength <= hwm : avail < hwm));
         },
     });
 }
@@ -12159,7 +12164,7 @@ const syncExtraRuntimeMethods = {
                         if (disc.status !== 0 || fastSyncSink || fastPipeSink || syncOut) {
                             const encoded = disc.status === 0 ? (encodeRedirectTextWithNewlineToScratch(disc.text) ?? fastSharedTextEncoder.encode(`${disc.text}\n`)) : undefined;
                             const byteLength = encoded ? encoded.byteLength : 0;
-                            if (byteLength === 0 || this.budget.bytes + byteLength <= this.budget.maxOutputBytesSmi || byteLength <= this.budget.limits.maxOutputBytes - this.budget.bytes) {
+                            if (byteLength === 0 || (canWriteBuiltinOutput(this.budget, fastPipeSink, byteLength))) {
                                 if (rawState.extensions && !rawState.extensions.eventDepth)
                                     publishCommandSpelling(rawState, commandSpelling(command));
                                 const restEpoch = monitor.chargeInternal(syncRestorationCharge, syncRestorationTickets).epoch;
@@ -12200,7 +12205,7 @@ const syncExtraRuntimeMethods = {
                 if (fastSyncSink || fastPipeSink || syncOut) {
                     const encoded = encodeRedirectTextWithNewlineToScratch(rawState.cwd) ?? fastSharedTextEncoder.encode(`${rawState.cwd}\n`);
                     const byteLength = encoded.byteLength;
-                    if (this.budget.bytes + byteLength <= this.budget.maxOutputBytesSmi || byteLength <= this.budget.limits.maxOutputBytes - this.budget.bytes) {
+                    if (canWriteBuiltinOutput(this.budget, fastPipeSink, byteLength)) {
                         if (rawState.extensions && !rawState.extensions.eventDepth)
                             publishCommandSpelling(rawState, commandSpelling(command));
                         const restEpoch = monitor.chargeInternal(syncRestorationCharge, syncRestorationTickets).epoch;
@@ -12282,7 +12287,7 @@ const syncExtraRuntimeMethods = {
                     if (outText !== undefined) {
                         const encoded = encodeRedirectTextWithNewlineToScratch(outText) ?? fastSharedTextEncoder.encode(`${outText}\n`);
                         const byteLength = encoded.byteLength;
-                        if (this.budget.bytes + byteLength <= this.budget.maxOutputBytesSmi || byteLength <= this.budget.limits.maxOutputBytes - this.budget.bytes) {
+                        if (canWriteBuiltinOutput(this.budget, fastPipeSink, byteLength)) {
                             if (rawState.extensions && !rawState.extensions.eventDepth)
                                 publishCommandSpelling(rawState, commandSpelling(command));
                             const restEpoch = monitor.chargeInternal(syncRestorationCharge, syncRestorationTickets).epoch;
@@ -12401,7 +12406,7 @@ const syncExtraRuntimeMethods = {
                     if (preEncoded !== undefined || formatted !== undefined) {
                         const encoded = preEncoded ?? encodeRedirectTextToScratch(formatted);
                         const byteLength = encoded.byteLength;
-                        if (this.budget.bytes + byteLength <= this.budget.maxOutputBytesSmi || byteLength <= this.budget.limits.maxOutputBytes - this.budget.bytes) {
+                        if (canWriteBuiltinOutput(this.budget, fastPipeSink, byteLength)) {
                             const restEpoch = monitor.chargeInternal(syncRestorationCharge, syncRestorationTickets).epoch;
                             this.budget.tick();
                             if (fastSyncSink) {
@@ -19272,7 +19277,7 @@ const syncExtraRuntimeMethods = {
         }
         const chunk = fastSharedTextEncoder.encode(this._syncStdoutBatch);
         this._syncStdoutBatch = "";
-        if ((io.stdout instanceof BudgetedSyncSink && io.stdout.write === BudgetedSyncSink.prototype.write) || (io.stdout instanceof Capture && io.stdout.write === Capture.prototype.write)) {
+        if ((io.stdout instanceof BudgetedSyncSink && io.stdout.write === BudgetedSyncSink.prototype.write) || (io.stdout instanceof Capture && io.stdout.write === Capture.prototype.write) || (io.stdout instanceof BudgetedPipeStageSink && io.stdout.write === BudgetedPipeStageSink.prototype.write && io.stdout.canWriteSync(chunk.byteLength))) {
             if (io.stdout.budget !== this.budget) {
                 if (chunk.byteLength > this.budget.limits.maxOutputBytes - this.budget.bytes)
                     this.budget.fail("maxOutputBytes");
@@ -19280,11 +19285,6 @@ const syncExtraRuntimeMethods = {
             }
             io.stdout.writeSync(chunk);
         }
-        else if (io.stdout instanceof BudgetedPipeStageSink && io.stdout.canWriteSync()) {
-            if (chunk.byteLength > this.budget.limits.maxOutputBytes - this.budget.bytes)
-                this.budget.fail("maxOutputBytes");
-            io.stdout.writeSync(chunk);
-        }
         else {
             if (budgetedSinks.get(io.stdout)?.budget !== this.budget) {
                 if (chunk.byteLength > this.budget.limits.maxOutputBytes - this.budget.bytes)

package/dist/safe-bash/shell-entry.browser.js

@@ -2,14 +2,14 @@ import {
   cloudflareWorkerLimits,
   mapfileExtension,
   readExtension
-} from "./chunks/chunk-67QE3JLU.js";
+} from "./chunks/chunk-TZRVK3NU.js";
 import "./chunks/chunk-GI7OALXO.js";
 import {
   Shell,
   ShellLimitError,
   ShellSyntaxError,
   parseShell
-} from "./chunks/chunk-IRJS54AA.js";
+} from "./chunks/chunk-VWLQDZFF.js";
 import "./chunks/chunk-N4CQ5E3G.js";
 import "./chunks/chunk-EDJBO2HZ.js";
 import "./chunks/chunk-IMOFLK26.js";

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

@@ -2241,6 +2241,47 @@ function createExiftoolCommand(options = {}) {
           resources.admit("retained", text.length * 5);
           await writeBytes(error ? stderr.output : stdout.output, new TextEncoder().encode(text), context.signal);
         };
+        if (context.args.length === 1 && ["--help", "-help", "-?"].includes(context.args[0])) {
+          await output(`Usage: exiftool [OPTIONS] [-TAG...] FILE...
+       exiftool --help | -help | -?
+
+Inspect and edit the supported metadata subset in virtual files.
+Standalone help reads no files and never invokes host ExifTool.
+
+Examples:
+  exiftool -j image.png
+  exiftool -n -s3 -ImageWidth image.png
+  exiftool -Title=Example image.png
+  exiftool -Title= -overwrite_original image.png
+  exiftool -j -- --help
+
+Formats:
+  PNG: dimensions, text metadata and timestamps; admitted tag writes.
+  JPEG: dimensions, selected EXIF tags and comments; admitted tag writes.
+  PDF: selected Info metadata reads/writes; no -all= or redaction.
+  WebP, DOCX, PPTX, XLSX, ODT, EPUB: limited metadata inspection only.
+  This is not full upstream format or tag compatibility.
+
+Options:
+  -j, -json       JSON extraction; -csv for CSV extraction
+  -TAG           Select an admitted tag; -TAG=VALUE writes, -TAG= deletes
+  -n, -s3        Numeric conversion, values-only output
+  -overwrite_original  Replace without creating the default FILE_original backup
+  --             Remaining arguments are literal file names
+  -              Read stdin once (extraction only)
+  -@ FILE        Read arguments from a virtual UTF-8 file
+  -ver, --version  Report the reference ExifTool version
+
+Limits:
+  No host files, user config code, directory scanning or stay_open protocol.
+  Unsupported flags, tags and editing operations are refused.
+  SDK limits bound cumulative input, decoded, retained and output bytes,
+  work, arguments, files and argument-file depth; quotas default to unlimited.
+  Configure maxInputBytes, maxOutputBytes, maxWork and other limits through
+  exiftoolCommands({ limits }); cancellation and output budgets apply to help.
+`);
+          return { exitCode: 0 };
+        }
         if (context.args.length === 1 && (context.args[0] === "-ver" || context.args[0] === "--version")) {
           await output(exiftoolRegistry.source.version + "\n");
           return { exitCode: 0 };

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

@@ -2,27 +2,30 @@ import {
   decodeLlmText,
   indentLlmText,
   withEmbeddingJsonDocument
-} from "../safe-bash/command-chunks/chunk-I7MEH76L.js";
+} from "../safe-bash/command-chunks/chunk-UYNJF5QN.js";
 import {
   acquireEmbeddingInput,
+  commandArguments,
   createLlmConfiguration,
   embeddingCommand,
-  embeddingText
-} from "../safe-bash/command-chunks/chunk-WOT2YXBT.js";
+  embeddingText,
+  hasUnpairedSurrogate,
+  pythonSurrogateId
+} from "../safe-bash/command-chunks/chunk-7ZQVMPSB.js";
 import {
   createLlmSpool,
   fileSource,
   floatText,
   isPythonPrintable
-} from "../safe-bash/command-chunks/chunk-BZLLQWRK.js";
+} from "../safe-bash/command-chunks/chunk-E5CDHXFA.js";
 import {
   tokenInteger
 } from "../safe-bash/command-chunks/chunk-GDH7OVYK.js";
-import "../safe-bash/command-chunks/chunk-GQV5RWMN.js";
+import "../safe-bash/command-chunks/chunk-ZFXHSFTU.js";
 import {
   sourceBytes,
   waitForSource
-} from "../safe-bash/command-chunks/chunk-QX3WKBLI.js";
+} from "../safe-bash/command-chunks/chunk-36FV6BAG.js";
 import {
   jsonValue
 } from "../safe-bash/command-chunks/chunk-GNPPPYDF.js";
@@ -164,16 +167,6 @@ import { FsError } from "../safe-bash-contracts/index.js";
 import { md5 as md52 } from "../safe-bash-checksum-engine/md5.js";
 import { withSqliteStatement as withSqliteStatement3 } from "../safe-bash-sqlite-engine/storage.js";
 
-// packages/safe-bash-command-llm/src/python-unicode.ts
-function hasUnpairedSurrogate(value) {
-  for (const char of value) {
-    const point = char.codePointAt(0);
-    if (point >= 55296 && point <= 57343) return true;
-  }
-  return false;
-}
-var pythonSurrogateId = /* @__PURE__ */ Symbol("pythonSurrogateId");
-
 // packages/safe-bash-command-llm/src/collections-write.ts
 import { sqliteRecord as sqliteRecord2, withSqliteStatement as withSqliteStatement2 } from "../safe-bash-sqlite-engine/storage.js";
 var blob2 = (size, bytes) => ({ type: "blob", size, bytes });
@@ -1303,7 +1296,7 @@ async function withEmbeddingFileGlob(options, source, operation) {
 
 // packages/safe-bash-command-llm/src/import-files.ts
 import { FsError as FsError9 } from "../safe-bash-contracts/index.js";
-import { PythonTextDecoder, PythonTextDecodeError, PythonIso2022PendingError } from "../safe-bash-csv-engine/text-decoder.js";
+import { PythonTextDecoder, PythonTextDecodeError, PythonIso2022PendingError, PythonUtf7EncodingError } from "../safe-bash-csv-engine/text-decoder.js";
 async function withFileEmbeddingEntries(options, files, operation) {
   const { fs, directory, signal } = options, maxBytes = options.maxInputBytes ?? Infinity;
   if (maxBytes !== Infinity && (!Number.isSafeInteger(maxBytes) || maxBytes < 0)) throw new RangeError("Invalid embedding input byte limit");
@@ -1315,6 +1308,7 @@ async function withFileEmbeddingEntries(options, files, operation) {
       const stat = await fs.stat(file.path, { signal });
       if (stat.type === "directory") continue;
       const input = await fileSource({ fs, path: file.path, signal, maxBytes, expectedStat: stat });
+      let selectedEncodingError;
       let raw, selected, failed2 = false, retire;
       try {
         raw = await createLlmSpool(fs, directory, signal, "input");
@@ -1328,7 +1322,7 @@ async function withFileEmbeddingEntries(options, files, operation) {
         else if (options.binary) selected = await createLlmSpool(fs, directory, signal, "input");
         else for (const encoding of options.encodings?.length ? options.encodings : ["utf-8", "latin-1"]) {
           const decoder = new PythonTextDecoder(encoding), candidate = await createLlmSpool(fs, directory, signal, "input");
-          let accepted = false, failedAttempt = false;
+          let accepted = false, failedAttempt = false, encodingError;
           try {
             const decoded = { async *[Symbol.asyncIterator]() {
               for await (const bytes of raw.replay()) for (let offset = 0; offset < bytes.length; offset += 4096) {
@@ -1347,7 +1341,10 @@ async function withFileEmbeddingEntries(options, files, operation) {
           } catch (error) {
             failedAttempt = true;
             signal.throwIfAborted();
-            if (!(error instanceof PythonTextDecodeError) && !(error instanceof PythonIso2022PendingError)) throw error;
+            if (error instanceof PythonUtf7EncodingError) {
+              accepted = true;
+              encodingError = error;
+            } else if (!(error instanceof PythonTextDecodeError) && !(error instanceof PythonIso2022PendingError)) throw error;
             failedAttempt = false;
           } finally {
             if (!accepted) try {
@@ -1357,6 +1354,7 @@ async function withFileEmbeddingEntries(options, files, operation) {
             }
           }
           if (accepted) {
+            selectedEncodingError = encodingError;
             const previous = selected;
             selected = candidate;
             await previous?.close();
@@ -1366,6 +1364,7 @@ async function withFileEmbeddingEntries(options, files, operation) {
           await options.undecodable?.(file.displayPath ?? file.path);
           continue;
         }
+        if (selectedEncodingError) throw selectedEncodingError;
         const retained = selected;
         let closed = false, consumed = false;
         retire = () => {
@@ -1776,58 +1775,18 @@ function createLlmCollectionCommands(options) {
         throw error;
       }
     });
-    if (tokens[0] === "--help" || tokens[0] === "-h") {
-      await emit(groupHelp);
-      return 0;
-    }
-    let command = "list", start = tokens[0] === "--" ? 1 : 0;
-    if (tokens[start] && Object.hasOwn(usages, tokens[start])) {
-      command = tokens[start];
-      start++;
-    }
+    const parsed = await commandArguments("collections", tokens, ["list", "delete", "path"], emit, diagnostic, step, void 0, (name) => name === "collections" ? groupHelp : help2[name.slice(12)]);
+    if (typeof parsed === "number") return parsed;
+    const { command, operands, values } = parsed;
+    const database = values.get("--database")?.at(-1), json = values.has("--json");
     const fail = async (message, code = 1, usage3 = false) => {
-      await diagnostic((usage3 ? usages[command] + `Try 'llm collections ${command} -h' for help.
+      await diagnostic((usage3 ? `Usage: llm collections ${command} [OPTIONS]${command === "delete" ? " COLLECTION" : ""}
+Try 'llm collections ${command} -h' for help.
 
 ` : "") + `Error: ${message}
 `);
       return code;
     };
-    let database, json = false, ended = false, wantsHelp = false;
-    const operands = [];
-    for (let index = start; index < tokens.length; index++) {
-      await step();
-      const token = tokens[index];
-      if (!ended && token === "--") {
-        ended = true;
-        continue;
-      }
-      if (ended || !token.startsWith("-") || token === "-") {
-        operands.push(token);
-        continue;
-      }
-      const equals = token.indexOf("="), long = token.startsWith("--");
-      for (let cursor = long ? 0 : 1; cursor < token.length; cursor++) {
-        const flag = long ? token.slice(0, equals < 0 ? void 0 : equals) : "-" + token[cursor];
-        if (flag === "--help" || flag === "-h" || flag === "--json" && command === "list") {
-          if (long && equals >= 0) return fail(`Option '${flag}' does not take a value.`, 2);
-          if (flag === "--json") json = true;
-          else wantsHelp = true;
-          if (long) break;
-          continue;
-        }
-        if (command === "path" || flag !== "-d" && flag !== "--database") return fail(`No such option: ${flag}`, 2, true);
-        database = (long ? equals < 0 ? void 0 : token.slice(equals + 1) : token.slice(cursor + 1) || void 0) ?? tokens[++index];
-        if (database === void 0) return fail(`Option '${flag}' requires an argument.`, 2);
-        break;
-      }
-    }
-    if (wantsHelp) {
-      await emit(help2[command]);
-      return 0;
-    }
-    if (command === "delete" && !operands.length) return fail("Missing argument 'COLLECTION'.", 2, true);
-    const extra = operands.slice(command === "delete" ? 1 : 0);
-    if (extra.length) return fail(`Got unexpected extra argument${extra.length === 1 ? "" : "s"} (${extra.join(" ")})`, 2, true);
     const config = createLlmConfiguration(context, maxConfigurationBytes);
     if (command === "path") {
       await emit(config.directory + "/embeddings.db\n");

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;