@poe-platform/safe-bash 0.1.713 → 0.1.714

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +20 -0
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -315,6 +315,26 @@ Use the [typed options and linked family interfaces](src/plugins/index.ts) for
315
315
  their individual limits and hooks, including clocks and schedulers. Family budgets
316
316
  are separate from shell limits; `replace` applies across the entire bundle.
317
317
 
318
+ The package root exports `createBoundedRegexProvider`, `BoundedRegexProvider`,
319
+ and `BoundedRegexProviderOptions`. `agentCommands()` uses this provider by default;
320
+ pass `regexExecutor` to configure its resource limits explicitly:
321
+
322
+ ```ts
323
+ import { agentCommands, createBoundedRegexProvider } from "@poe-platform/safe-bash";
324
+
325
+ shell.use(
326
+ agentCommands({
327
+ regexExecutor: createBoundedRegexProvider({ maxWorkers: 1, maxInputBytes: 65_536 }),
328
+ regex: { maxWorkers: 1 }
329
+ })
330
+ );
331
+ ```
332
+
333
+ Provider limits bound pattern/input/result bytes, matches, work, allocations,
334
+ states, and active workers. `regex` configures executor queue and timeout limits.
335
+ The default provider runs cooperatively; it does not provide native-worker or
336
+ process-memory isolation. No internal-module import is needed.
337
+
318
338
  ### Environment variables
319
339
 
320
340
  There are no package-specific runtime environment switches. Supply these through
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@poe-platform/safe-bash",
3
- "version": "0.1.713",
3
+ "version": "0.1.714",
4
4
  "description": "Extensible virtual shell with pluggable filesystems and streaming commands",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -382,7 +382,7 @@
382
382
  "access": "public"
383
383
  },
384
384
  "dependencies": {
385
- "@poe-platform/safe-fs": "0.1.713",
385
+ "@poe-platform/safe-fs": "0.1.714",
386
386
  "pako": "3.0.1",
387
387
  "@types/node": "^25.2.2",
388
388
  "@noble/hashes": "2.4.0",