@bivelio/savings-layer 0.4.24 → 0.4.26

package/docs/terminales/opencode.md

@@ -1,15 +1,40 @@
 # opencode a través del gateway
 
-**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §3 [V]. opencode enruta por
-**archivo de configuración**, no por variable de entorno, y su capa
-`packages/llm` añade `/messages` al `baseURL`: por eso aquí el URL lleva `/v1`.
+**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §3 [V] y
+`docs/investigacion/2026-09-27/agentes-de-codigo.md` (código de
+`anomalyco/opencode` v1.18.32, 2026-09-27). opencode enruta por **configuración**,
+y su capa de protocolo añade `/messages` a `https://api.anthropic.com/v1` por
+defecto: por eso aquí el URL lleva `/v1` [V].
 
 ## Qué necesitas
 
 - `opencode` instalado, proveedor `anthropic` con tu **API key** de Anthropic.
 - `bvsala` instalado, `BIVELIO_SERVICE_KEY` exportada y una licencia BiVelio activa (la recoge el gateway con la clave; ver [README](README.md)).
 
-## Config de usuario: `~/.config/opencode/opencode.json`
+## Envoltorio: `bvsala opencode [args…]`
+
+```bash
+export BIVELIO_SERVICE_KEY=bvk_…
+bvsala opencode
+```
+
+opencode acepta la configuración entera en la variable `OPENCODE_CONFIG_CONTENT`
+y la fusiona **por encima** de la global y de la de proyecto (`config.ts`: se
+carga después de `opencode.json` global, del de proyecto y de `.opencode/`; solo
+la config de cuenta remota y la gestionada por la empresa van después) [V]. El
+envoltorio arranca un gateway efímero y lanza `opencode` con esa variable
+apuntando `provider.anthropic.options.baseURL` a `http://127.0.0.1:<puerto>/v1`.
+**No escribe nada en disco** y todo muere al salir.
+
+- Si ya exportas tu propio `OPENCODE_CONFIG_CONTENT`, el envoltorio lo
+  **fusiona**: solo cambia `provider.anthropic.options.baseURL`; tu clave, tus
+  modelos y lo demás siguen igual. Si no es un objeto JSON (por ejemplo, JSONC
+  con comentarios), se niega antes de arrancar y no repite su valor.
+- Solo pasa por el gateway el proveedor `anthropic`. Los demás proveedores
+  (OpenAI, OpenCode Zen, OpenRouter…) van directos y no se miden.
+- Al salir imprime cuántas peticiones midió y cuáles reenvió sin medir, y por qué.
+
+## Manual: `~/.config/opencode/opencode.json`
 
 ```json
 {
@@ -27,11 +52,6 @@
 [V]. El `opencode.json` de proyecto pisa al global: si tienes uno en el repo,
 ahí es donde manda.
 
-No hay envoltorio `bvsala opencode`: el enrutado es config de usuario. El
-`bvsala doctor --write opencode` previsto en S3 hará un merge JSON conservador
-de este bloque (con copia `.bak`) en tu config de usuario, nunca en archivos
-del repo.
-
 ### Alternativa [V]: `baseURL` desde variable de entorno
 
 ```json
@@ -56,10 +76,12 @@ opencode
 
 - **Sin `/v1`** → opencode pide `http://127.0.0.1:8402/messages` → `[gateway] POST /messages → 404`.
 - **Barra final** (`…/v1/`) → no.
-- **Config de proyecto** con otro `baseURL` pisando al global sin que lo sepas.
+- **Config de proyecto** con otro `baseURL` pisando al global sin que lo sepas
+  (con el envoltorio no pasa: su variable manda sobre los dos).
 - **Gateway apagado con la config escrita**: opencode falla hasta que arranques
   `bvsala gateway` de nuevo. La config es persistente; el gateway, no. (La
-  variante `{env:…}` sin exportar la variable también falla, por vacío.)
+  variante `{env:…}` sin exportar la variable también falla, por vacío.) El
+  envoltorio no tiene esta trampa.
 
 ## Nota BYOK
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bivelio/savings-layer",
-  "version": "0.4.24",
+  "version": "0.4.26",
   "description": "The savings layer for your LLM bill: a library inside your code that lets through only what has to be paid for and returns a SavingsReport per call, measured with your provider's own meter and kept apart from estimates. Commercial license, paid per seat, commission only on measured savings. Your prompts never leave your infrastructure.",
   "keywords": [
     "llm",
@@ -15,6 +15,10 @@
     "email": "support@bivelio.com",
     "url": "https://savings.bivelio.com"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BiVelio/bivelio-savings-layer.git"
+  },
   "license": "SEE LICENSE IN LICENSE",
   "author": "BiVelio Inc.",
   "type": "module",
@@ -27,6 +31,26 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./ai-sdk": {
+      "types": "./dist/adapters/ai-sdk.d.ts",
+      "import": "./dist/adapters/ai-sdk.js",
+      "default": "./dist/adapters/ai-sdk.js"
+    },
+    "./mastra": {
+      "types": "./dist/adapters/mastra.d.ts",
+      "import": "./dist/adapters/mastra.js",
+      "default": "./dist/adapters/mastra.js"
+    },
+    "./langchain": {
+      "types": "./dist/adapters/langchain.d.ts",
+      "import": "./dist/adapters/langchain.js",
+      "default": "./dist/adapters/langchain.js"
+    },
+    "./anthropic-sdk": {
+      "types": "./dist/adapters/anthropic-sdk.d.ts",
+      "import": "./dist/adapters/anthropic-sdk.js",
+      "default": "./dist/adapters/anthropic-sdk.js"
+    },
     "./package.json": "./package.json"
   },
   "bin": {
@@ -52,13 +76,23 @@
     "build:all": "pnpm run build:packages && pnpm run build:services && pnpm run build",
     "typecheck": "tsc --noEmit",
     "typecheck:packages": "pnpm -r --filter=./packages/* --filter=./services/* typecheck",
-    "typecheck:all": "pnpm run typecheck && pnpm run typecheck:packages",
+    "typecheck:all": "pnpm run typecheck && pnpm run typecheck:packages && pnpm run typecheck:ejemplos",
+    "typecheck:ejemplos": "tsc -p examples/stacks/tsconfig.json",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
     "example:basic": "BVSALA_DEV_OPEN=1 tsx examples/basic/index.ts",
     "example:handoff": "BVSALA_DEV_OPEN=1 tsx examples/multi-agent/handoff.ts",
     "example:serialization": "BVSALA_DEV_OPEN=1 tsx examples/serialization/format-selector.ts",
+    "example:otel": "BVSALA_DEV_OPEN=1 tsx examples/exporters/otel.ts",
+    "example:focus": "BVSALA_DEV_OPEN=1 tsx examples/exporters/focus.ts",
+    "example:nextjs": "BVSALA_DEV_OPEN=1 tsx examples/stacks/nextjs/run.ts",
+    "example:express": "BVSALA_DEV_OPEN=1 tsx examples/stacks/express/server.ts",
+    "example:ai-sdk": "BVSALA_DEV_OPEN=1 tsx examples/stacks/ai-sdk/bivelio-check.ts",
+    "example:mastra": "BVSALA_DEV_OPEN=1 tsx examples/stacks/mastra/bivelio-check.ts",
+    "example:langchain": "BVSALA_DEV_OPEN=1 tsx examples/stacks/langchain/bivelio-check.ts",
+    "example:anthropic-sdk": "BVSALA_DEV_OPEN=1 tsx examples/stacks/anthropic-sdk/bivelio-check.ts",
+    "init:ejemplos": "tsx scripts/ejemplos-de-init.ts",
     "example:licensed": "tsx examples/licensing/licensed.ts",
     "license:demo": "tsx examples/licensing/demo.ts",
     "example:revocation": "tsx examples/licensing/revocation.ts",
@@ -72,10 +106,13 @@
     "web:dev": "node apps/web/serve.mjs",
     "prepublishOnly": "pnpm run build",
     "ab:publish": "tsx benchmarks/publish.ts",
+    "ab:sonda": "BVSALA_DEV_OPEN=1 tsx --env-file-if-exists=.env.bench benchmarks/sonda-del-banco.ts",
+    "medicion:reproducir": "node apps/web/public/measure/reproduce.mjs",
     "verja:calibrar": "tsx corpus/calibrar-la-verja.ts",
     "corpus:arnes": "tsx corpus/arnes/informe.ts",
     "corpus:auditar": "tsx corpus/auditoria/auditar.ts",
     "sombra:corpus": "tsx benchmarks/sombra-corpus.ts",
+    "compactacion:banco": "tsx benchmarks/compactacion-de-cola/banco.ts",
     "sombra:diales": "tsx --env-file-if-exists=.env.bench benchmarks/sombra-diales.ts",
     "anillo1": "tsx --env-file-if-exists=.env.bench benchmarks/anillo1/arnes.ts",
     "anillo2": "tsx benchmarks/anillo2/arnes.ts",
@@ -84,25 +121,72 @@
     "salida": "tsx --env-file-if-exists=.env.bench benchmarks/salida/arnes.ts",
     "salida:anatomia": "tsx benchmarks/salida/anatomia.ts",
     "salida:por-clase": "tsx benchmarks/salida/por-clase.ts",
+    "esfuerzo": "tsx --env-file-if-exists=.env.bench benchmarks/esfuerzo/banco.ts",
     "luz-verde": "bash scripts/luz-verde.sh",
-    "sonda:sdk": "BVSALA_DEV_OPEN=1 tsx --env-file-if-exists=.env.bench benchmarks/sdk/sonda.ts"
+    "sonda:sdk": "BVSALA_DEV_OPEN=1 tsx --env-file-if-exists=.env.bench benchmarks/sdk/sonda.ts",
+    "sbom:tarball": "tsx scripts/sbom.ts",
+    "cache-semantica": "BVSALA_DEV_OPEN=1 tsx benchmarks/cache-semantica/arnes.ts",
+    "cache-semantica:publicar": "tsx benchmarks/cache-semantica/publicar.ts",
+    "latencia:gateways": "tsx benchmarks/latencia-gateways/arnes.ts",
+    "vigia:conexiones": "tsx benchmarks/latencia-gateways/vigia-conexiones.ts",
+    "cache-semantica:calibrada": "BVSALA_DEV_OPEN=1 tsx benchmarks/cache-semantica/calibrada.ts",
+    "cache-semantica:simulacion": "tsx benchmarks/cache-semantica/simulacion.ts"
   },
   "devDependencies": {
     "@noble/curves": "^2.2.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/sdk-trace-base": "^2.11.0",
     "@types/node": "^22.10.2",
     "gpt-tokenizer": "^3.4.0",
+    "hyparquet": "^1.31.2",
     "tsup": "^8.3.5",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^2.1.8",
+    "@ai-sdk/anthropic": "4.0.65",
+    "@ai-sdk/openai": "4.0.78",
+    "@anthropic-ai/sdk": "0.128.0",
+    "@langchain/core": "1.2.13",
+    "@langchain/openai": "1.6.0",
+    "@mastra/core": "1.71.0",
+    "ai": "7.0.118",
+    "ai-v6": "npm:ai@6.0.293",
+    "@types/express": "5.0.6",
+    "express": "5.2.1",
+    "langchain": "1.5.14",
+    "zod": "4.6.5"
   },
   "packageManager": "pnpm@10.17.1",
   "peerDependencies": {
-    "gpt-tokenizer": "^3"
+    "@opentelemetry/api": "^1.9.0",
+    "gpt-tokenizer": "^3",
+    "@anthropic-ai/sdk": ">=0.103.0 <1",
+    "@langchain/core": ">=1.1.0 <2",
+    "@mastra/core": ">=1.68.0 <2",
+    "ai": "^6.0.0 || ^7.0.0",
+    "langchain": ">=1.1.0 <2"
   },
   "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    },
     "gpt-tokenizer": {
       "optional": true
+    },
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "@langchain/core": {
+      "optional": true
+    },
+    "@mastra/core": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    },
+    "langchain": {
+      "optional": true
     }
   }
 }