pi-braid-providers 1.0.4 → 1.0.6

package/README.md

@@ -1,5 +1,11 @@
 # pi-braid-providers
 
+```bash
+pi install npm:pi-braid-providers
+```
+
+One command, no clone, no build: `pi install` registers the package with pi and installs it under pi's npm directory.
+
 Additional LLM providers for `pi-coding-agent`, built on a generalized **API key ring** for multi-key rotation and self-healing.
 
 The `providers` workspace registers providers into pi at session start. The key-ring machinery that both the agent loop and direct extension LLM calls use ships here; the provider itself is the **`agent-zero`** setup: the multi-vendor gateway that proxies Venice's models, configured from a catalog file resolved at runtime.
@@ -51,6 +57,12 @@ Or register the workspace in `~/.pi/agent/settings.json`:
 }
 ```
 
+## Pre-send payload guard
+
+| Setting                              | Default | Effect                                                                                                                                                                                                                                   | Read cadence                                    |
+| ------------------------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| `braid.context.presendGuard.enabled` | `true`  | When enabled, if an estimated request exceeds 90% of a known model context window, oversized strings that can be flushed are written losslessly to disk and replaced by stubs. `false` skips the guard; unknown windows are not guessed. | Re-read at use time for every provider request. |
+
 ## What this does not do
 
 - It does not ship a provider catalog. The `agent-zero` model list and gateway URL are read from a
@@ -193,13 +205,13 @@ external consumer imports the package, never the other way round.
 
 `formatRingHealth(routes, freshness)` and `summarizeRouteHealth(routes, freshness)`
 turn a report into the `ring_health` tool's text and its `details` payload.
-Both take the death window the caller resolved
-(`braid.providers.probeFreshnessMs`, the same value the router's death gate is
-built with) and mark a recorded death `(expired)` when that gate would no
-longer act on it: an age at or past the window, a death with no recorded time,
-or any death while the window is switched off. The age rule is the gate's own
-predicate (`deathInForce` in `virtual-router.ts`), so the surface and the
-router cannot disagree about which deaths act.
+
+- `braid.providers.probeFreshnessMs` (default `900000` ms, 15 minutes) controls
+  how long a recorded unavailable probe or shape-death result can steer routing.
+  `0` or less disables probe steering. The ring-health renderers receive the
+  same resolved window and mark a death `(expired)` when the router's
+  `deathInForce` predicate would no longer act on it, its timestamp is absent,
+  or the window is off.
 
 ## Disabling the provider
 

package/build-info.json

@@ -0,0 +1,9 @@
+{
+  "name": "pi-braid-providers",
+  "version": "1.0.6",
+  "sha": "752d2e6e9b45037a8ebcc17f3d6f90c905b2c71c",
+  "shaShort": "752d2e6",
+  "branch": "detached",
+  "dirty": false,
+  "packedAt": "2026-10-19T11:29:20.919Z"
+}

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "pi-braid-providers",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "LLM provider for pi-coding-agent: Venice models via the agent-zero gateway, with a multi-key ring",
   "type": "module",
   "files": [
     "*.ts",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "build-info.json"
   ],
+  "exports": {
+    ".": "./index.ts"
+  },
   "keywords": [
     "pi-package",
     "pi",
@@ -27,6 +31,8 @@
     "typecheck": "tsc --noEmit",
     "test": "node test/provider-race.test.mjs && node test/route-table.test.mjs && node test/probe.test.mjs && node test/route-state.test.mjs && node test/ring-health.test.mjs && node test/rotation-engine.test.mjs && node test/route-failback.test.mjs && node test/providers-log.test.mjs && node test/key-ring-log.test.mjs && node test/key-ring-feedback.test.mjs && node test/key-ring-exhausted.test.mjs && node test/key-ring-hammer.test.mjs && node test/key-ring-cas-veto.test.mjs && node test/key-ring-selfheal.test.mjs && node test/ring-provider.test.mjs && node test/fallback-policy.test.mjs && node test/presend-guard.test.mjs && node test/venice-catalog.test.mjs && node test/waf-sanitize.test.mjs && node test/venice-direct-route.test.mjs && node test/venice-catalog-gen.test.mjs && node test/venice-catalog-cost.test.mjs && node test/route-walk-classes.test.mjs && node test/waf-repeat-rotation.test.mjs && node test/waf-marker-retryability.test.mjs && node test/route-usable.test.mjs && node test/virtual-router.test.mjs && node test/outage-watch.test.mjs && node test/failure-translation.test.mjs && node test/state-paths.test.mjs",
     "publish:local": "node ../core/scripts/publish-local.mjs providers",
+    "prepack": "node ../core/scripts/pack-provenance.mjs write",
+    "postpack": "node ../core/scripts/pack-provenance.mjs remove",
     "clean": "rm -rf node_modules package-lock.json",
     "reinstall": "npm run clean && npm install"
   },
@@ -35,8 +41,8 @@
     "@earendil-works/pi-ai": "^1.2.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*"
+    "@earendil-works/pi-ai": "^1.2.0",
+    "@earendil-works/pi-coding-agent": "^1.2.0"
   },
   "author": "kifirkin",
   "license": "MIT",