@bivelio/savings-layer 0.4.4 → 0.4.6

package/README.md

@@ -33,6 +33,14 @@ charge a flat subscription, so there is no per‑token bill to cut. BV‑SALA is
 applications that call the API with their own key. The whole story, in plain words:
 **[Where does the saving install?](https://savings.bivelio.com/en/how-it-works)**
 
+**Claude Code, Codex CLI, Goose or Qwen Code with an API key?** The package also
+ships a local measuring gateway: `bvsala claude` (or `bvsala codex`, `bvsala
+goose`, `bvsala qwen`) launches the terminal through it and your real spend
+shows up in your dashboard, token by token — nothing to configure, nothing
+persisted. For opencode, Crush, Droid, Cline or Kilo Code, `bvsala doctor`
+prints the exact config block for each one you have installed. Today it
+measures; it does not optimize yet.
+
 ## Try it before you install
 
 Run the real optimizer **free in your browser** — pick an example or paste your own
@@ -60,7 +68,7 @@ export BIVELIO_SERVICE_KEY=…   # service-account key: auto-renewal + seat mete
 ```ts
 import { createSavingsLayer, OpenAICompatibleProvider } from "@bivelio/savings-layer";
 
-// Your provider. LLM traffic goes straight to it — BV-SALA never proxies it.
+// Your provider. LLM traffic goes straight to it — the SDK never proxies it.
 // Any OpenAI-compatible endpoint works: OpenAI, Azure, vLLM, SGLang, a gateway.
 const provider = new OpenAICompatibleProvider({
   baseUrl: "https://api.openai.com/v1",

package/dist/gateway/bin.js

@@ -1,31 +1,31 @@
 #!/usr/bin/env node
-import {spawn}from'child_process';import {createServer}from'http';import {randomUUID,createHash}from'crypto';var se=new Set;function y(t,e){se.has(t)||(se.add(t),console.warn(e));}var w=class{options;now;flushIntervalMs;maxBatch;maxBuffer;buffer=[];seatId;ci;timer;inflight=null;fallosSeguidos=0;constructor(e){this.options=e,this.now=e.now??(()=>Date.now()),this.flushIntervalMs=
-e.flushIntervalMs??15e3,this.maxBatch=e.maxBatch??50,this.maxBuffer=e.maxBuffer??1e3,this.ci=e.ci??false;}setSeat(e,n){e&&(this.seatId=e),this.ci=n;}record(e){this.buffer.push({report:e,at:this.now()}),this.
+import {spawn}from'child_process';import {existsSync,readFileSync}from'fs';import {homedir}from'os';import {join,delimiter}from'path';import {createServer}from'http';import {randomUUID,createHash}from'crypto';import*as T from'zlib';var be=new Set;function w(e,t){be.has(e)||(be.add(e),console.warn(t));}var I=class{options;now;flushIntervalMs;maxBatch;maxBuffer;buffer=[];seatId;ci;timer;inflight=null;fallosSeguidos=0;constructor(t){this.options=t,this.now=t.now??(()=>Date.now()),this.flushIntervalMs=
+t.flushIntervalMs??15e3,this.maxBatch=t.maxBatch??50,this.maxBuffer=t.maxBuffer??1e3,this.ci=t.ci??false;}setSeat(t,n){t&&(this.seatId=t),this.ci=n;}record(t){this.buffer.push({report:t,at:this.now()}),this.
 buffer.length>this.maxBuffer&&this.buffer.splice(0,this.buffer.length-this.maxBuffer),this.buffer.length>=this.maxBatch&&this.flush();}start(){this.timer||(this.timer=setInterval(()=>{this.flush();},this.
-flushIntervalMs),this.timer.unref?.());}stop(){this.timer&&(clearInterval(this.timer),this.timer=void 0),this.flush();}async stopAndDrain(e){this.timer&&(clearInterval(this.timer),this.timer=void 0);let n=e??
-Math.ceil(this.maxBuffer/this.maxBatch)+4,r=0;for(let o=0;o<n&&this.buffer.length>0;o++){let s=this.buffer.length;if(await this.flush(),r=this.buffer.length>=s?r+1:0,r>=2)break}}async flush(){if(this.
-inflight)return this.inflight;if(this.buffer.length!==0){this.inflight=this.hacerFlush();try{await this.inflight;}finally{this.inflight=null;}}}async hacerFlush(){let e=this.options.fetchImpl??globalThis.
-fetch;if(!e)return;let n=this.buffer.splice(0,this.maxBatch);try{let r=n.map(s=>this.toWire(s)),o=await e(this.options.url,{method:"POST",headers:{"content-type":"application/json",authorization:`Bear\
-er ${this.options.serviceAccountKey}`},body:JSON.stringify(r)});o.ok?this.fallosSeguidos=0:o.status>=500?(this.fallosSeguidos++,this.requeue(n),this.avisarDeFallo(`el servidor respondi\xF3 ${o.status}`)):
-o.status===401||o.status===403?(y(`metering-auth-${o.status}`,`[bv-sala] el env\xEDo de uso est\xE1 siendo rechazado con HTTP ${o.status} en ${this.options.url}. Revisa 'serviceAccountKey' (\xBFrotada? \xBF\
-revocada? \xBFde otra organizaci\xF3n?). Mientras no funcione NO se reporta uso: el panel dir\xE1 que no ve tr\xE1fico y los asientos facturables saldr\xE1n a cero.`),this.options.onAuthError?.(o.status)):
-(this.fallosSeguidos++,this.avisarDeFallo(o.status===404||o.status===405?`HTTP ${o.status}: la URL de env\xEDo parece equivocada`:`el servidor rechaz\xF3 el lote con HTTP ${o.status}`));}catch(r){this.
-fallosSeguidos++,this.requeue(n),this.avisarDeFallo(r instanceof Error?r.message:"error de red");}}avisarDeFallo(e){if(this.options.silenceWarnings)return;let n=this.fallosSeguidos;n<3||(n-3)%12!==0||console.
-warn(`[bv-sala] el env\xEDo de uso lleva ${n} intentos seguidos fallando contra ${this.options.url} (${e}). Las peticiones SIGUEN funcionando, pero el uso no est\xE1 llegando: el panel dir\xE1 que no ve tr\xE1\
-fico y los asientos facturables saldr\xE1n a cero. Comprueba 'meteringUrl' \u2014 por defecto es \`\${licenseServerUrl}/api/metering/usage\`.`);}requeue(e){this.buffer=[...e,...this.buffer],this.buffer.
-length>this.maxBuffer&&(this.buffer.length=this.maxBuffer);}toWire(e){let n=e.report;return {orgId:this.options.orgId??"self",...this.seatId?{seatId:this.seatId}:{},...this.ci?{ci:true}:{},requestId:n.requestId,
-model:n.model,at:e.at,avoidedLlm:n.calls.avoidedLlm,actualLlm:n.calls.actualLlm,baselineInputTokens:n.tokens.baselineInput,actualInputTokens:n.tokens.actualInput,eliminatedInputTokens:n.tokens.eliminatedInput,
+flushIntervalMs),this.timer.unref?.());}stop(){this.timer&&(clearInterval(this.timer),this.timer=void 0),this.flush();}async stopAndDrain(t){this.timer&&(clearInterval(this.timer),this.timer=void 0);let n=t??
+Math.ceil(this.maxBuffer/this.maxBatch)+4,o=0;for(let r=0;r<n&&this.buffer.length>0;r++){let s=this.buffer.length;if(await this.flush(),o=this.buffer.length>=s?o+1:0,o>=2)break}}async flush(){if(this.
+inflight)return this.inflight;if(this.buffer.length!==0){this.inflight=this.hacerFlush();try{await this.inflight;}finally{this.inflight=null;}}}async hacerFlush(){let t=this.options.fetchImpl??globalThis.
+fetch;if(!t)return;let n=this.buffer.splice(0,this.maxBatch);try{let o=n.map(s=>this.toWire(s)),r=await t(this.options.url,{method:"POST",headers:{"content-type":"application/json",authorization:`Bear\
+er ${this.options.serviceAccountKey}`},body:JSON.stringify(o)});r.ok?this.fallosSeguidos=0:r.status>=500?(this.fallosSeguidos++,this.requeue(n),this.avisarDeFallo(`el servidor respondi\xF3 ${r.status}`)):
+r.status===401||r.status===403?(w(`metering-auth-${r.status}`,`[bv-sala] el env\xEDo de uso est\xE1 siendo rechazado con HTTP ${r.status} en ${this.options.url}. Revisa 'serviceAccountKey' (\xBFrotada? \xBF\
+revocada? \xBFde otra organizaci\xF3n?). Mientras no funcione NO se reporta uso: el panel dir\xE1 que no ve tr\xE1fico y los asientos facturables saldr\xE1n a cero.`),this.options.onAuthError?.(r.status)):
+(this.fallosSeguidos++,this.avisarDeFallo(r.status===404||r.status===405?`HTTP ${r.status}: la URL de env\xEDo parece equivocada`:`el servidor rechaz\xF3 el lote con HTTP ${r.status}`));}catch(o){this.
+fallosSeguidos++,this.requeue(n),this.avisarDeFallo(o instanceof Error?o.message:"error de red");}}avisarDeFallo(t){if(this.options.silenceWarnings)return;let n=this.fallosSeguidos;n<3||(n-3)%12!==0||console.
+warn(`[bv-sala] el env\xEDo de uso lleva ${n} intentos seguidos fallando contra ${this.options.url} (${t}). Las peticiones SIGUEN funcionando, pero el uso no est\xE1 llegando: el panel dir\xE1 que no ve tr\xE1\
+fico y los asientos facturables saldr\xE1n a cero. Comprueba 'meteringUrl' \u2014 por defecto es \`\${licenseServerUrl}/api/metering/usage\`.`);}requeue(t){this.buffer=[...t,...this.buffer],this.buffer.
+length>this.maxBuffer&&(this.buffer.length=this.maxBuffer);}toWire(t){let n=t.report;return {orgId:this.options.orgId??"self",...this.seatId?{seatId:this.seatId}:{},...this.ci?{ci:true}:{},requestId:n.requestId,
+model:n.model,at:t.at,avoidedLlm:n.calls.avoidedLlm,actualLlm:n.calls.actualLlm,baselineInputTokens:n.tokens.baselineInput,actualInputTokens:n.tokens.actualInput,eliminatedInputTokens:n.tokens.eliminatedInput,
 compressedInputTokens:n.tokens.compressedInput,baselineOutputTokens:n.tokens.baselineOutput,actualOutputTokens:n.tokens.actualOutput,providerCachedInputTokens:n.tokens.providerCachedInput??0,cacheResult:n.
-cache.result,baselineCost:n.cost.baselineEstimate,actualCost:n.cost.actual,netSavings:n.cost.netSavings,...n.cost.basis?{basis:n.cost.basis}:{}}}};function O(){return globalThis.process}function we(t){if(/^[0-9a-f]{12}$/.test(t)||/^\d{1,3}(\.\d{1,3}){3}$/.test(t)||/^ip-\d{1,3}(-\d{1,3}){3}$/i.test(t))return  true;let e="[bcdfghjklmnpqrstvwxz2456789]";
-return new RegExp(`-${e}{8,10}-${e}{5}$`).test(t)}function Se(t){return !!(t.AWS_LAMBDA_FUNCTION_NAME??t.LAMBDA_TASK_ROOT??t.VERCEL??t.VERCEL_ENV??t.K_SERVICE??t.FUNCTION_TARGET??t.FUNCTIONS_WORKER_RUNTIME??
-t.NETLIFY)}async function Te(){if(O()?.execPath)try{let e=await import(["node","os"].join(":")),n=typeof e.hostname=="function"?e.hostname():"";return n.length>0?n:void 0}catch{return}}async function Ce(t,e=Te){
-if(t.KUBERNETES_SERVICE_HOST||Se(t))return;let n=t.HOSTNAME??t.COMPUTERNAME??await e();if(!(!n||we(n)))return n}async function Re(){let t=O();if(!t||!t.env)return;let e=t.env,n=await Ce(e),r=[t.platform,
-t.arch,t.execPath,n,e.USER??e.USERNAME??e.LOGNAME,e.HOME??e.USERPROFILE].filter(o=>typeof o=="string"&&o.length>0);return r.length?r.join("|"):void 0}var Ee=["CI","CONTINUOUS_INTEGRATION","GITHUB_ACTI\
-ONS","GITLAB_CI","CIRCLECI","TRAVIS","JENKINS_URL","BUILDKITE","TF_BUILD","TEAMCITY_VERSION","BITBUCKET_BUILD_NUMBER","CODEBUILD_BUILD_ID","HEROKU_TEST_RUN_ID","DRONE"];function D(){let t=O()?.env;if(!t)
-return  false;for(let e of Ee){let n=t[e];if(n&&n!=="false"&&n!=="0")return  true}return  false}async function Ie(t,e){let n=globalThis.crypto,r=new TextEncoder;if(n?.subtle)try{let i=await n.subtle.importKey("raw",
-r.encode(t),{name:"HMAC",hash:"SHA-256"},!1,["sign"]),c=await n.subtle.sign("HMAC",i,r.encode(e));return [...new Uint8Array(c)].map(u=>u.toString(16).padStart(2,"0")).join("")}catch{}let o=2166136261,s=`${t}\
-|${e}`;for(let i=0;i<s.length;i++)o^=s.charCodeAt(i),o=Math.imul(o,16777619);return (o>>>0).toString(16).padStart(8,"0")}async function A(t){let n=O()?.env?.BVSALA_SEAT_ID;if(n&&Pe.test(n))return n;let r=await Re();
-if(!r)return;let o=await Ie(t,r);if(o)return `m-${o.slice(0,32)}`}var Pe=/^[A-Za-z0-9._:/-]{1,128}$/;var U={"gpt-4.1":{inputPer1k:.002,outputPer1k:.008,cachedInputPer1k:5e-4},"gpt-4.1-mini":{inputPer1k:4e-4,outputPer1k:.0016,cachedInputPer1k:1e-4},"gpt-4.1-nano":{inputPer1k:1e-4,outputPer1k:4e-4,cachedInputPer1k:25e-6},
+cache.result,baselineCost:n.cost.baselineEstimate,actualCost:n.cost.actual,netSavings:n.cost.netSavings,...n.cost.basis?{basis:n.cost.basis}:{}}}};function B(){return globalThis.process}function Ue(e){if(/^[0-9a-f]{12}$/.test(e)||/^\d{1,3}(\.\d{1,3}){3}$/.test(e)||/^ip-\d{1,3}(-\d{1,3}){3}$/i.test(e))return  true;let t="[bcdfghjklmnpqrstvwxz2456789]";
+return new RegExp(`-${t}{8,10}-${t}{5}$`).test(e)}function qe(e){return !!(e.AWS_LAMBDA_FUNCTION_NAME??e.LAMBDA_TASK_ROOT??e.VERCEL??e.VERCEL_ENV??e.K_SERVICE??e.FUNCTION_TARGET??e.FUNCTIONS_WORKER_RUNTIME??
+e.NETLIFY)}async function Ke(){if(B()?.execPath)try{let t=await import(["node","os"].join(":")),n=typeof t.hostname=="function"?t.hostname():"";return n.length>0?n:void 0}catch{return}}async function He(e,t=Ke){
+if(e.KUBERNETES_SERVICE_HOST||qe(e))return;let n=e.HOSTNAME??e.COMPUTERNAME??await t();if(!(!n||Ue(n)))return n}async function Je(){let e=B();if(!e||!e.env)return;let t=e.env,n=await He(t),o=[e.platform,
+e.arch,e.execPath,n,t.USER??t.USERNAME??t.LOGNAME,t.HOME??t.USERPROFILE].filter(r=>typeof r=="string"&&r.length>0);return o.length?o.join("|"):void 0}var We=["CI","CONTINUOUS_INTEGRATION","GITHUB_ACTI\
+ONS","GITLAB_CI","CIRCLECI","TRAVIS","JENKINS_URL","BUILDKITE","TF_BUILD","TEAMCITY_VERSION","BITBUCKET_BUILD_NUMBER","CODEBUILD_BUILD_ID","HEROKU_TEST_RUN_ID","DRONE"];function V(){let e=B()?.env;if(!e)
+return  false;for(let t of We){let n=e[t];if(n&&n!=="false"&&n!=="0")return  true}return  false}async function Ge(e,t){let n=globalThis.crypto,o=new TextEncoder;if(n?.subtle)try{let i=await n.subtle.importKey("raw",
+o.encode(e),{name:"HMAC",hash:"SHA-256"},!1,["sign"]),a=await n.subtle.sign("HMAC",i,o.encode(t));return [...new Uint8Array(a)].map(l=>l.toString(16).padStart(2,"0")).join("")}catch{}let r=2166136261,s=`${e}\
+|${t}`;for(let i=0;i<s.length;i++)r^=s.charCodeAt(i),r=Math.imul(r,16777619);return (r>>>0).toString(16).padStart(8,"0")}async function F(e){let n=B()?.env?.BVSALA_SEAT_ID;if(n&&Ye.test(n))return n;let o=await Je();
+if(!o)return;let r=await Ge(e,o);if(r)return `m-${r.slice(0,32)}`}var Ye=/^[A-Za-z0-9._:/-]{1,128}$/;var Q={"gpt-4.1":{inputPer1k:.002,outputPer1k:.008,cachedInputPer1k:5e-4},"gpt-4.1-mini":{inputPer1k:4e-4,outputPer1k:.0016,cachedInputPer1k:1e-4},"gpt-4.1-nano":{inputPer1k:1e-4,outputPer1k:4e-4,cachedInputPer1k:25e-6},
 "gpt-4o":{inputPer1k:.0025,outputPer1k:.01,cachedInputPer1k:.00125},"gpt-4o-mini":{inputPer1k:15e-5,outputPer1k:6e-4,cachedInputPer1k:75e-6},"gpt-4-turbo":{inputPer1k:.01,outputPer1k:.03},"gpt-4":{inputPer1k:.03,
 outputPer1k:.06},"gpt-3.5-turbo":{inputPer1k:5e-4,outputPer1k:.0015},"gpt-5":{inputPer1k:.00125,outputPer1k:.01,cachedInputPer1k:125e-6},"gpt-5-codex":{inputPer1k:.00125,outputPer1k:.01,cachedInputPer1k:125e-6},
 "gpt-5-mini":{inputPer1k:25e-5,outputPer1k:.002,cachedInputPer1k:25e-6},"gpt-5-nano":{inputPer1k:5e-5,outputPer1k:4e-4,cachedInputPer1k:5e-6},"gpt-5.1-codex":{inputPer1k:.00125,outputPer1k:.01,cachedInputPer1k:125e-6},
@@ -41,68 +41,135 @@ able-5":{inputPer1k:.01,outputPer1k:.05,cachedInputPer1k:.001},"claude-sonnet-4"
 "claude-3-5-sonnet":{inputPer1k:.003,outputPer1k:.015,cachedInputPer1k:3e-4},"claude-3-5-haiku":{inputPer1k:8e-4,outputPer1k:.004,cachedInputPer1k:8e-5},"claude-3-opus":{inputPer1k:.015,outputPer1k:.075,
 cachedInputPer1k:.0015},"claude-3-haiku":{inputPer1k:25e-5,outputPer1k:.00125,cachedInputPer1k:3e-5},"gemini-3.7-flash":{inputPer1k:75e-5,outputPer1k:.00375,cachedInputPer1k:75e-6},"gemini-3.5-flash":{
 inputPer1k:.0015,outputPer1k:.009,cachedInputPer1k:15e-5},"gemini-3.5-flash-lite":{inputPer1k:3e-4,outputPer1k:.0025,cachedInputPer1k:3e-5},"gemini-3.1-pro-preview":{inputPer1k:.002,outputPer1k:.012,cachedInputPer1k:2e-4},
-"gemini-2.5-pro":{inputPer1k:.00125,outputPer1k:.01,cachedInputPer1k:125e-6},"gemini-2.5-flash":{inputPer1k:3e-4,outputPer1k:.0025,cachedInputPer1k:3e-5}};function ie(t,e,n){if(!n)return;let r=t[n];if(r)
-return r;let o=n.lastIndexOf("/"),s=o>=0?n.slice(o+1):n,i=t[s];if(i)return i;for(let c of e){if(!s.startsWith(c))continue;let u=s.charAt(c.length);if(u!==""&&u!=="-"&&u!=="."&&u!=="_")continue;let a=s.
-slice(c.length+1);if(!(/^\d/.test(a)&&!/^\d{4}/.test(a)))return t[c]}}function q(t){return Object.keys(t).sort((e,n)=>n.length-e.length)}var _e=q(U);function I(t){return ie(U,_e,t)}var P=class{resto="";uso=null;eventos={};observar(e){this.resto+=typeof e=="string"?e:e.toString("utf8");let n;for(;(n=this.resto.indexOf(`
+"gemini-2.5-pro":{inputPer1k:.00125,outputPer1k:.01,cachedInputPer1k:125e-6},"gemini-2.5-flash":{inputPer1k:3e-4,outputPer1k:.0025,cachedInputPer1k:3e-5}};function ve(e,t,n){if(!n)return;let o=e[n];if(o)
+return o;let r=n.lastIndexOf("/"),s=r>=0?n.slice(r+1):n,i=e[s];if(i)return i;for(let a of t){if(!s.startsWith(a))continue;let l=s.charAt(a.length);if(l!==""&&l!=="-"&&l!=="."&&l!=="_")continue;let p=s.
+slice(a.length+1);if(!(/^\d/.test(p)&&!/^\d{4}/.test(p)))return e[a]}}function X(e){return Object.keys(e).sort((t,n)=>n.length-t.length)}var Qe=X(Q);function M(e){return ve(Q,Qe,e)}var $=class{resto="";uso=null;eventos={};observar(t){this.resto+=typeof t=="string"?t:t.toString("utf8");let n;for(;(n=this.resto.indexOf(`
 
-`))>=0;){let r=this.resto.slice(0,n);this.resto=this.resto.slice(n+2);let o=/^event: (.+)$/m.exec(r)?.[1];if(o&&(this.eventos[o]=(this.eventos[o]??0)+1),o!=="message_start"&&o!=="message_delta")continue;
-let s=/^data: (.+)$/m.exec(r)?.[1];if(s)try{let i=JSON.parse(s),c=i.usage??i.message?.usage;if(c){let u=c.cache_creation||this.uso?.cache_creation?{...this.uso?.cache_creation,...c.cache_creation}:void 0;
-this.uso={...this.uso,...c,...u?{cache_creation:u}:{}};}}catch{}}}usage(){return this.uso}},Oe=1.25,De=2;function ae(t,e){let n=I(t);if(!n)return null;let r=e.input_tokens??0,o=e.output_tokens??0,s=e.cache_read_input_tokens??
-0,i=e.cache_creation,c=e.cache_creation_input_tokens??(i?.ephemeral_5m_input_tokens??0)+(i?.ephemeral_1h_input_tokens??0),u=Math.min(i?.ephemeral_1h_input_tokens??0,c),a=n.cachedInputPer1k??n.inputPer1k;
-return {costeUsd:r/1e3*n.inputPer1k+s/1e3*a+(c-u)/1e3*n.inputPer1k*Oe+u/1e3*n.inputPer1k*De+o/1e3*n.outputPer1k,precio:n,tokens:{entrada:r,salida:o,cacheLeida:s,cacheEscrita:c,cacheEscrita1h:u}}}function K(t){
-try{return JSON.parse(typeof t=="string"?t:t.toString("utf8")).usage??null}catch{return null}}function ce(t,e,n){return ue(t,e,n,false)}function le(t,e,n){return ue(t,e,n,true)}function ue(t,e,n,r){let o=n.
-tokens.entrada+n.tokens.cacheLeida+n.tokens.cacheEscrita;return {requestId:t,model:e,calls:r?{avoidedLlm:1,actualLlm:0}:{avoidedLlm:0,actualLlm:1},tokens:{baselineInput:o,actualInput:r?0:o,eliminatedInput:0,
-compressedInput:0,baselineOutput:n.tokens.salida,actualOutput:r?0:n.tokens.salida,providerCachedInput:r?0:n.tokens.cacheLeida},cache:{result:r?"singleflight":"miss"},cost:r?{baselineEstimate:n.costeUsd,
-actual:0,netSavings:1,basis:"estimated"}:{baselineEstimate:n.costeUsd,actual:n.costeUsd,netSavings:0,basis:"measured"}}}var J=5*1024*1024,Me=["authorization","x-api-key","anthropic-version","anthropic-beta"];function de(t,e,n,r=""){return createHash("sha256").update(t).update(`
-`).update(e).update(`
-`).update(r).update(`
-`).update(n).digest("hex")}function pe(t){return Me.map(e=>`${e}=${t(e)??""}`).join(`
-`)}var M=class{enVuelo=new Map;primarias=0;gemelas=0;registrar(e){if(this.enVuelo.has(e))return null;this.primarias+=1;let n,r=new Promise(c=>n=c);this.enVuelo.set(e,{promesa:r,resolver:n});let o=[],s=0,
-i=false;return {capturar:c=>{if(!i){if(s+=c.length,s>J){i=true,o.length=0;return}o.push(c);}},terminar:(c,u)=>{let a=!i&&c>=200&&c<300;this.enVuelo.get(e)?.resolver(a?{status:c,headers:u,chunks:o}:null),this.
-enVuelo.delete(e);},abortar:()=>{this.enVuelo.get(e)?.resolver(null),this.enVuelo.delete(e);}}}async esperar(e){let n=this.enVuelo.get(e);if(!n)return null;let r=await n.promesa;return r&&(this.gemelas+=
-1),r}tieneEnVuelo(e){return this.enVuelo.has(e)}};var je=["content-encoding","content-length","transfer-encoding"];async function me(t={}){let e=(t.upstream??"https://api.anthropic.com").replace(/\/+$/,""),n=t.fetchImpl??fetch,r=t.log??(a=>console.log(
-a)),o;if(t.serviceAccountKey){o=new w({url:t.meteringUrl??"https://savings.bivelio.com/api/metering/usage",serviceAccountKey:t.serviceAccountKey,...t.fetchImpl?{fetchImpl:t.fetchImpl}:{},onAuthError:l=>y(
-"gateway-ingest-auth",`[bvsala gateway] la ingesta de uso rechaza la credencial (${l}). El tr\xE1fico sigue fluyendo (avisar, nunca romper), pero este uso no est\xE1 llegando al panel. Revisa BIVELIO_SERVIC\
-E_KEY y el estado de la suscripci\xF3n en savings.bivelio.com.`)});let a=D();t.seatId?o.setSeat(t.seatId,a):A(t.serviceAccountKey).then(l=>o?.setSeat(l,a)).catch(()=>{}),o.start();}else y("gateway-sin-\
-clave","[bvsala gateway] sin BIVELIO_SERVICE_KEY: el gateway reenv\xEDa el tr\xE1fico pero NO mide. Consigue tu clave en savings.bivelio.com/dashboard/install para ver el gasto en tu panel.");let s=t.
-coalescer?new M:null,i=(a,l,m,h,b)=>{if(!o||!m)return;let d="";try{d=JSON.parse(l.toString("utf8")).model??"";}catch{}let p=d?ae(d,m):null;p?(o.record(h?le(a,d,p):ce(a,d,p)),r(`[gateway] POST ${b} ${h?
-"\xB7 COALESCIDA (llamada evitada)":""} \xB7 ${d} \xB7 $${p.costeUsd.toFixed(6)} (in ${p.tokens.entrada}, cache\u2191${p.tokens.cacheEscrita}${p.tokens.cacheEscrita1h?` (1h ${p.tokens.cacheEscrita1h})`:
-""} cache\u2193${p.tokens.cacheLeida}, out ${p.tokens.salida})`)):d&&y(`gateway-sin-precio:${d}`,`[bvsala gateway] el modelo "${d}" no est\xE1 en el cat\xE1logo de precios; su uso se reenv\xEDa pero no se mide\
-.`);},c=createServer(async(a,l)=>{let m=randomUUID(),h=new AbortController;l.on("close",()=>{l.writableEnded||h.abort();});let b=null,d=new URL(a.url??"/",e);try{let p=[];for await(let f of a)p.push(f);let k=Buffer.concat(
-p);d=new URL(a.url??"/",e);let C=s!==null&&a.method==="POST"&&k.length>0,z=pe(f=>{let g=a.headers[f];return Array.isArray(g)?g.join(", "):g}),R=C?de("POST",d.pathname+d.search,k,z):"";if(C)if(s.tieneEnVuelo(
-R)){let f=await s.esperar(R);if(f){l.writeHead(f.status,f.headers);let g=new P;for(let re of f.chunks)l.write(re),g.observar(re);l.end();let xe=g.usage()??(d.pathname==="/v1/messages"?K(Buffer.concat(
-f.chunks)):null);i(m,k,xe,!0,d.pathname);return}}else b=s.registrar(R);let ne={};for(let[f,g]of Object.entries(a.headers))f==="host"||f==="content-length"||g===void 0||(ne[f]=Array.isArray(g)?g.join("\
-, "):g);let v;try{v=await n(d,{method:a.method,headers:ne,body:["GET","HEAD"].includes(a.method??"")?void 0:k,redirect:"manual",signal:h.signal});}catch(f){b?.abortar(),l.headersSent||(l.writeHead(502,
-{"content-type":"application/json"}),l.end(JSON.stringify({error:"bvsala gateway: upstream unreachable",detail:String(f)}))),r(`[gateway] ${a.method} ${d.pathname} \u2192 upstream inalcanzable: ${String(
-f)}`);return}let B=Object.fromEntries(v.headers.entries());for(let f of je)delete B[f];l.writeHead(v.status,B);let F=(v.headers.get("content-type")??"").includes("text/event-stream"),V=F?new P:null,E=!F&&
-v.ok&&o!==void 0&&a.method==="POST"&&d.pathname==="/v1/messages"&&(v.headers.get("content-type")??"").includes("application/json")?[]:null,oe=0;if(v.body)for await(let f of v.body){let g=Buffer.from(f);
-l.write(g),V?.observar(g),E&&(oe+=g.length,oe>J?E=null:E.push(g)),b?.capturar(g);}l.end(),b?.terminar(v.status,B),V&&v.ok?i(m,k,V.usage(),!1,d.pathname):E?i(m,k,K(Buffer.concat(E)),!1,d.pathname):F||r(
-`[gateway] ${a.method} ${d.pathname} \u2192 ${v.status}`);}catch(p){if(b?.abortar(),h.signal.aborted)r(`[gateway] ${a.method} ${d.pathname} \u2192 el cliente abort\xF3; upstream cancelado`);else if(r(`\
-[gateway] ${a.method} ${d.pathname} \u2192 error sirviendo: ${String(p)}`),!l.headersSent){l.writeHead(502,{"content-type":"application/json"}),l.end(JSON.stringify({error:"bvsala gateway: stream inte\
-rrupted",detail:String(p)}));return}l.writableEnded||l.end();}});return await new Promise((a,l)=>{c.once("error",l),c.listen(t.puerto??8402,"127.0.0.1",()=>a());}),{puerto:c.address().port,cerrar:async()=>{
-await o?.stopAndDrain(),await new Promise(a=>c.close(()=>a()));}}}var H=class{id;exact=false;constructor(e="heuristic"){this.id=e;}count(e){if(e.length===0)return 0;let n=e.match(/[A-Za-z]+|\d+|\s+|[^\sA-Za-z\d]/g)??[],r=0;for(let o of n){let s=o[0];if(/\s/.test(s)){let i=(o.
-match(/\n/g)??[]).length;r+=i+Math.floor(Math.max(0,o.length-1)/2);}else /[A-Za-z]/.test(s)?r+=Math.max(1,Math.ceil(o.length/4)):/\d/.test(s)?r+=Math.max(1,Math.ceil(o.length/2)):r+=1;}return Math.max(r,
-Math.ceil(e.length/4))}},W=new H;var G=class{estimators=new Map;modelToTokenizer=new Map;fallbackId;constructor(e=W){this.fallbackId=e.id,this.estimators.set(e.id,e);}register(e){return this.estimators.set(e.id,e),this}mapModel(e,n){return this.
-modelToTokenizer.set(e,n),this}resolve(e){let n=e.tokenizer?this.estimators.get(e.tokenizer):void 0;if(n)return n;if(e.model){let r=this.modelToTokenizer.get(e.model);if(r){let o=this.estimators.get(r);
-if(o)return o}}return this.estimators.get(this.fallbackId)}count(e,n){return this.resolve(n).count(e)}};new G;new TextEncoder;new TextDecoder;new TextDecoder;var Ze={"gpt-4o-mini":{deltaTokens:-16,salidaDelBrazoA:72,contrato:"triage (6 fields, long enums)",pares:8},"gpt-4o":{deltaTokens:3,salidaDelBrazoA:75,contrato:"triage (6 fields, long enums)",pares:8}};
-q(Ze);var Z="0.4.4";var[,,x,...N]=process.argv;function tt(){console.log(`bvsala ${Z} \u2014 BiVelio Savings Layer
+`))>=0;){let o=this.resto.slice(0,n);this.resto=this.resto.slice(n+2);let r=/^event: (.+)$/m.exec(o)?.[1];if(r&&(this.eventos[r]=(this.eventos[r]??0)+1),r!=="message_start"&&r!=="message_delta")continue;
+let s=/^data: (.+)$/m.exec(o)?.[1];if(s)try{let i=JSON.parse(s),a=i.usage??i.message?.usage;if(a){let l=a.cache_creation||this.uso?.cache_creation?{...this.uso?.cache_creation,...a.cache_creation}:void 0;
+this.uso={...this.uso,...a,...l?{cache_creation:l}:{}};}}catch{}}}usage(){return this.uso}usageFinal(){return (this.eventos.message_delta??0)>0?this.uso:null}},U=class{resto="";uso=null;eventos={};observar(t){
+this.resto+=typeof t=="string"?t:t.toString("utf8");let n;for(;(n=this.resto.indexOf(`
+
+`))>=0;){let o=this.resto.slice(0,n);this.resto=this.resto.slice(n+2);let r=/^event: (.+)$/m.exec(o)?.[1];r&&(this.eventos[r]=(this.eventos[r]??0)+1);let s=/^data: (.+)$/m.exec(o)?.[1];if(s)try{let i=JSON.
+parse(s);if((r??i.type)!=="response.completed")continue;let a=i.response?.usage;a&&(this.uso=Xe(a));}catch{}}}usage(){return this.uso}usageFinal(){return this.uso}};function Xe(e){let t=Math.max(0,e.input_tokens??
+0),n=Math.min(Math.max(0,e.input_tokens_details?.cached_tokens??0),t),o=Math.min(Math.max(0,e.input_tokens_details?.cache_write_tokens??0),t-n);return {input_tokens:t-n-o,output_tokens:Math.max(0,e.output_tokens??
+0),cache_read_input_tokens:n,cache_creation_input_tokens:o}}var ye=1.25,Ze=2;function ke(e,t){let n=M(e);if(!n)return null;let o=t.input_tokens??0,r=t.output_tokens??0,s=t.cache_read_input_tokens??0,i=t.
+cache_creation,a=t.cache_creation_input_tokens??(i?.ephemeral_5m_input_tokens??0)+(i?.ephemeral_1h_input_tokens??0),l=Math.min(i?.ephemeral_1h_input_tokens??0,a),p=n.cachedInputPer1k??n.inputPer1k;return {
+costeUsd:o/1e3*n.inputPer1k+s/1e3*p+(a-l)/1e3*n.inputPer1k*tt(e)+l/1e3*n.inputPer1k*Ze+r/1e3*n.outputPer1k,precio:n,tokens:{entrada:o,salida:r,cacheLeida:s,cacheEscrita:a,cacheEscrita1h:l}}}function xe(e,t){
+try{let n=e,o={maxOutputLength:et};switch((t??"").trim().toLowerCase()){case "gzip":case "x-gzip":n=T.gunzipSync(e,o);break;case "deflate":n=T.inflateSync(e,o);break;case "br":n=T.brotliDecompressSync(e,o);
+break;case "zstd":{let s=T.zstdDecompressSync;if(typeof s!="function")return "";n=s(e,o);break}default:break}let r=JSON.parse(n.toString("utf8")).model;return typeof r=="string"?r:""}catch{return ""}}var et=5*
+1024*1024;function we(){return typeof T.zstdDecompressSync=="function"}function tt(e){let t=e.toLowerCase();return t.startsWith("gpt-")||t.startsWith("o1")||t.startsWith("o3")||t.startsWith("o4")?/^gpt-5\.6/.
+test(t)?ye:1:t.startsWith("gemini")?1:ye}function Z(e){try{return JSON.parse(typeof e=="string"?e:e.toString("utf8")).usage??null}catch{return null}}function Se(e,t,n){return Ce(e,t,n,false)}function Te(e,t,n){
+return Ce(e,t,n,true)}function Ce(e,t,n,o){let r=n.tokens.entrada+n.tokens.cacheLeida+n.tokens.cacheEscrita;return {requestId:e,model:t,calls:o?{avoidedLlm:1,actualLlm:0}:{avoidedLlm:0,actualLlm:1},tokens:{
+baselineInput:r,actualInput:o?0:r,eliminatedInput:0,compressedInput:0,baselineOutput:n.tokens.salida,actualOutput:o?0:n.tokens.salida,providerCachedInput:o?0:n.tokens.cacheLeida},cache:{result:o?"sing\
+leflight":"miss"},cost:o?{baselineEstimate:n.costeUsd,actual:0,netSavings:1,basis:"estimated"}:{baselineEstimate:n.costeUsd,actual:n.costeUsd,netSavings:0,basis:"measured"}}}var ee=5*1024*1024,ot=["authorization","x-api-key","anthropic-version","anthropic-beta"];function Re(e,t,n,o=""){return createHash("sha256").update(e).update(`
+`).update(t).update(`
+`).update(o).update(`
+`).update(n).digest("hex")}function Ee(e){return ot.map(t=>`${t}=${e(t)??""}`).join(`
+`)}var q=class{enVuelo=new Map;primarias=0;gemelas=0;registrar(t){if(this.enVuelo.has(t))return null;this.primarias+=1;let n,o=new Promise(a=>n=a);this.enVuelo.set(t,{promesa:o,resolver:n});let r=[],s=0,
+i=false;return {capturar:a=>{if(!i){if(s+=a.length,s>ee){i=true,r.length=0;return}r.push(a);}},terminar:(a,l)=>{let p=!i&&a>=200&&a<300;this.enVuelo.get(t)?.resolver(p?{status:a,headers:l,chunks:r}:null),this.
+enVuelo.delete(t);},abortar:()=>{this.enVuelo.get(t)?.resolver(null),this.enVuelo.delete(t);}}}async esperar(t){let n=this.enVuelo.get(t);if(!n)return null;let o=await n.promesa;return o&&(this.gemelas+=
+1),o}tieneEnVuelo(t){return this.enVuelo.has(t)}};var it=["content-encoding","content-length","transfer-encoding"];async function Ie(e={}){let t=(e.upstream??"https://api.anthropic.com").replace(/\/+$/,""),n=e.fetchImpl??fetch,o=e.log??(c=>console.log(
+c)),r;if(e.serviceAccountKey){r=new I({url:e.meteringUrl??"https://savings.bivelio.com/api/metering/usage",serviceAccountKey:e.serviceAccountKey,...e.fetchImpl?{fetchImpl:e.fetchImpl}:{},onAuthError:u=>w(
+"gateway-ingest-auth",`[bvsala gateway] la ingesta de uso rechaza la credencial (${u}). El tr\xE1fico sigue fluyendo (avisar, nunca romper), pero este uso no est\xE1 llegando al panel. Revisa BIVELIO_SERVIC\
+E_KEY y el estado de la suscripci\xF3n en savings.bivelio.com.`)});let c=V();e.seatId?r.setSeat(e.seatId,c):F(e.serviceAccountKey).then(u=>r?.setSeat(u,c)).catch(()=>{}),r.start();}else w("gateway-sin-\
+clave","[bvsala gateway] sin BIVELIO_SERVICE_KEY: el gateway reenv\xEDa el tr\xE1fico pero NO mide. Consigue tu clave en savings.bivelio.com/dashboard/install para ver el gasto en tu panel.");let s=e.
+coalescer?new q:null,i=c=>c==="/v1/messages"?new $:c.endsWith("/responses")?new U:null,a=(c,u,f,b,m,d)=>{if(!r||!f)return;let h=xe(u,d);if(!h){w(`gateway-sin-modelo:${m}`,`[bvsala gateway] no se pudo \
+leer el modelo del cuerpo de ${m} (content-encoding: ${d??"ninguno"}); su uso se reenv\xEDa pero no se mide.`);return}let k=ke(h,f);k?(r.record(b?Te(c,h,k):Se(c,h,k)),o(`[gateway] POST ${m} ${b?"\xB7 COA\
+LESCIDA (llamada evitada)":""} \xB7 ${h} \xB7 $${k.costeUsd.toFixed(6)} (in ${k.tokens.entrada}, cache\u2191${k.tokens.cacheEscrita}${k.tokens.cacheEscrita1h?` (1h ${k.tokens.cacheEscrita1h})`:""} cac\
+he\u2193${k.tokens.cacheLeida}, out ${k.tokens.salida})`)):w(`gateway-sin-precio:${h}`,`[bvsala gateway] el modelo "${h}" no est\xE1 en el cat\xE1logo de precios; su uso se reenv\xEDa pero no se mide.`);},
+l=createServer(async(c,u)=>{let f=randomUUID(),b=new AbortController;u.on("close",()=>{u.writableEnded||b.abort();});let m=null,d=new URL(c.url??"/",t),h=null,k=Buffer.alloc(0),N=false,O=c.headers["content-encoding"],z=Array.
+isArray(O)?O[0]:O;try{let D=[];for await(let g of c)D.push(g);let S=Buffer.concat(D);k=S,d=new URL(c.url??"/",t);let pe=s!==null&&c.method==="POST"&&S.length>0,Ve=Ee(g=>{let v=c.headers[g];return Array.
+isArray(v)?v.join(", "):v}),W=pe?Re("POST",d.pathname+d.search,S,Ve):"";if(pe)if(s.tieneEnVuelo(W)){let g=await s.esperar(W);if(g){u.writeHead(g.status,g.headers);let v=i(d.pathname)??new $;for(let ge of g.
+chunks)u.write(ge),v.observar(ge);u.end();let Fe=v.usage()??(d.pathname==="/v1/messages"?Z(Buffer.concat(g.chunks)):null);a(f,S,Fe,!0,d.pathname,z);return}}else m=s.registrar(W);let me={};for(let[g,v]of Object.
+entries(c.headers))g==="host"||g==="content-length"||v===void 0||(me[g]=Array.isArray(v)?v.join(", "):v);let x;try{x=await n(d,{method:c.method,headers:me,body:["GET","HEAD"].includes(c.method??"")?void 0:
+S,redirect:"manual",signal:b.signal});}catch(g){m?.abortar(),u.headersSent||(u.writeHead(502,{"content-type":"application/json"}),u.end(JSON.stringify({error:"bvsala gateway: upstream unreachable",detail:String(
+g)}))),o(`[gateway] ${c.method} ${d.pathname} \u2192 upstream inalcanzable: ${String(g)}`);return}let G=Object.fromEntries(x.headers.entries());for(let g of it)delete G[g];u.writeHead(x.status,G);let fe=x.
+headers.get("content-type")??"",Y=fe.includes("text/event-stream")||fe===""&&x.ok&&i(d.pathname)!==null;h=Y?i(d.pathname):null;let L=!Y&&x.ok&&r!==void 0&&c.method==="POST"&&d.pathname==="/v1/messages"&&
+(x.headers.get("content-type")??"").includes("application/json")?[]:null,he=0;if(x.body)for await(let g of x.body){let v=Buffer.from(g);u.write(v),h?.observar(v),L&&(he+=v.length,he>ee?L=null:L.push(v)),
+m?.capturar(v);}u.end(),m?.terminar(x.status,G),h&&x.ok?(N=!0,a(f,S,h.usage(),!1,d.pathname,z)):L?a(f,S,Z(Buffer.concat(L)),!1,d.pathname,z):Y||o(`[gateway] ${c.method} ${d.pathname} \u2192 ${x.status}`);}catch(D){
+if(m?.abortar(),b.signal.aborted){let S=!N&&h?h.usageFinal():null;S?(o(`[gateway] ${c.method} ${d.pathname} \u2192 el cliente cerr\xF3 tras el usage final; se mide igual`),a(f,k,S,false,d.pathname,z)):o(
+`[gateway] ${c.method} ${d.pathname} \u2192 el cliente abort\xF3; upstream cancelado`);}else if(o(`[gateway] ${c.method} ${d.pathname} \u2192 error sirviendo: ${String(D)}`),!u.headersSent){u.writeHead(
+502,{"content-type":"application/json"}),u.end(JSON.stringify({error:"bvsala gateway: stream interrupted",detail:String(D)}));return}u.writableEnded||u.end();}});return l.on("upgrade",(c,u)=>{o(`[gatew\
+ay] ${c.method} ${new URL(c.url??"/","http://x").pathname} \u2192 426 (WebSocket no soportado; el cliente cae a HTTP)`),u.once("error",()=>{}),u.once("finish",()=>u.destroy()),u.end(`HTTP/1.1 426 Upgr\
+ade Required\r
+connection: close\r
+content-length: 0\r
+\r
+`);}),await new Promise((c,u)=>{l.once("error",u),l.listen(e.puerto??8402,"127.0.0.1",()=>c());}),{puerto:l.address().port,cerrar:async()=>{await r?.stopAndDrain(),await new Promise(c=>l.close(()=>c()));}}}var te=["claude","codex","goose","qwen"];function _e(e){return te.includes(e??"")}function Ae(e,t={}){let n=t.path??process.env.PATH??"",o=t.
+existe??existsSync,r=null;for(let s of n.split(";").filter(i=>i.length>0)){for(let i of [".exe",".com"]){let a=join(s,e+i);if(o(a))return {tipo:"exe",ruta:a}}if(r===null)for(let i of [".cmd",".bat"]){let a=join(s,e+
+i);if(o(a)){r=a;break}}}return r!==null?{tipo:"solo-shim",ruta:r}:{tipo:"no-encontrado"}}function Oe(e={}){let n=(e.env??process.env).BVSALA_CODEX_AUTH?.toLowerCase();if(n==="api-key"||n==="apikey")return "\
+api-key";if(n==="chatgpt")return "chatgpt";let o=null;try{o=e.leerAuth?e.leerAuth():null;}catch{o=null;}if(o===null)return "api-key";try{let r=JSON.parse(o);return typeof r.auth_mode=="string"?r.auth_mode.
+toLowerCase().replace(/[^a-z]/g,"")==="apikey"?"api-key":"chatgpt":r.tokens!==void 0&&r.tokens!==null?"chatgpt":"api-key"}catch{return "api-key"}}var ct={"api-key":{upstream:"https://api.openai.com",prefijo:"\
+/v1"},chatgpt:{upstream:"https://chatgpt.com",prefijo:"/backend-api/codex"}};function ne(e,t,n,o={}){let r=`http://127.0.0.1:${t}`;switch(e){case "claude":return {bin:"claude",args:n,env:{ANTHROPIC_BASE_URL:r}};case "\
+goose":return {bin:"goose",args:n,env:{ANTHROPIC_HOST:r}};case "qwen":return {bin:"qwen",args:n,env:{ANTHROPIC_BASE_URL:r},nota:'Qwen Code solo enruta por aqu\xED con `security.auth.selectedType: "anthropic\
+"` en ~/.qwen/settings.json (ver `bvsala doctor`).'};case "codex":{let s=o.modoCodex??"api-key",i=ct[s];return {bin:"codex",args:["-c",`openai_base_url="${r}${i.prefijo}"`,...n],env:{},upstream:i.upstream,
+nota:s==="chatgpt"?"Auth ChatGPT detectada: el gateway enruta a chatgpt.com/backend-api/codex. El tr\xE1fico de suscripci\xF3n se mide (equivalente a precio de lista) pero no se monetiza: no hay factura por\
+ tokens.":"Auth por API key: el gateway enruta a api.openai.com/v1."}}}}var pt="comprobar: en el log del gateway debe aparecer `[gateway] POST /v1/messages \u2026`; si ve\
+s `/v1/v1/messages`, sobra un /v1; si ves `POST /messages` a secas, falta uno.",mt=[{id:"claude",nombre:"Claude Code",binario:"claude",configs:[],detectable:true,receta:({base:e})=>["usa `bvsala claude`\
+ \u2014 arranca el gateway en un puerto ef\xEDmero, lanza `claude` apunt\xE1ndole y lo apaga al salir.",`a mano: ANTHROPIC_BASE_URL=${e} claude   (sin /v1: el cliente a\xF1ade /v1/messages)`]},{id:"co\
+dex",nombre:"Codex CLI",binario:"codex",configs:[join(".codex","config.toml"),join(".codex","auth.json")],detectable:true,receta:({base:e,rutas:t})=>["usa `bvsala codex` \u2014 el prefijo del base URL depende del \
+modo de auth y lo resuelve el envoltorio:",`  API key           \u2192 openai_base_url=${e}/v1`,`  suscripci\xF3n ChatGPT \u2192 openai_base_url=${e}/backend-api/codex   (tiene que terminar exactament\
+e ah\xED)`,`${t[1]}: solo se comprueba que exista; nunca se lee.`]},{id:"opencode",nombre:"opencode",binario:"opencode",configs:[join(".config","opencode","opencode.json")],detectable:true,receta:({baseV1:e,
+rutas:t})=>[`mecanismo: ${t[0]} \u2192 provider.anthropic.options.baseURL (el opencode.json del proyecto pisa al global). CON /v1.`,"{",'  "provider": {','    "anthropic": {',`      "options": { "base\
+URL": "${e}" }`,"    }","  }","}",'alternativa: "baseURL": "{env:BVSALA_BASE_URL}" y exportar la variable; trampa: sin la variable, baseURL queda vac\xEDo.']},{id:"goose",nombre:"Goose",binario:"goose",
+configs:[join(".config","goose","config.yaml")],detectable:true,receta:({base:e,rutas:t})=>[`mecanismo: variable de entorno ANTHROPIC_HOST (pisa ${t[0]}). SIN /v1.`,`ANTHROPIC_HOST=${e} ANTHROPIC_API_KEY=\u2026\
+ goose`]},{id:"crush",nombre:"Crush",binario:"crush",configs:[join(".config","crush","crushrc")],detectable:true,receta:({baseV1:e,rutas:t})=>[`mecanismo: ${t[0]} (Bash); crush.json est\xE1 deprecado. CON /v1\
+ y SIN barra final (el SDK Go resuelve relativo: /v1/ \u2192 /v1/v1/messages).`,`provider add bvsala --type anthropic --base-url ${e} --api-key "$ANTHROPIC_API_KEY"`]},{id:"qwen",nombre:"Qwen Code",binario:"\
+qwen",configs:[join(".qwen","settings.json")],detectable:true,receta:({base:e,rutas:t})=>[`mecanismo: variable de entorno ANTHROPIC_BASE_URL + ${t[0]} con selectedType = anthropic. SIN /v1 (el SDK TS ofici\
+al a\xF1ade /v1/messages).`,`ANTHROPIC_BASE_URL=${e} ANTHROPIC_API_KEY=\u2026 qwen`,`comprueba a mano que ${t[0]} lleve selectedType: anthropic \u2014 el doctor no lee el archivo.`]},{id:"droid",nombre:"\
+Droid (Factory)",binario:"droid",configs:[join(".factory","settings.json")],detectable:true,receta:({base:e,rutas:t})=>[`mecanismo: ${t[0]} \u2192 customModels[] con provider "anthropic". SIN /v1 [inferido: val\
+idar en mano contra el log del gateway].`,"{",'  "customModels": [',"    {",'      "model": "<id de modelo Anthropic>",','      "displayName": "<nombre visible>",','      "provider": "anthropic",',`  \
+    "baseUrl": "${e}",`,'      "apiKey": "<tu API key de Anthropic>"',"    }","  ]","}"]},{id:"cline",nombre:"Cline",configs:[],detectable:false,receta:({baseV1:e})=>["mecanismo: UI \u2192 proveedor Anthropic\
+ \u2192 marca \xABUse custom base URL\xBB. CON /v1 (Cline fija https://api.anthropic.com/v1 y solo normaliza la URL oficial exacta).",`Base URL: ${e}`]},{id:"kilo",nombre:"Kilo Code",configs:[],detectable:false,
+receta:({baseV1:e})=>["mecanismo: UI \u2192 proveedor custom, Provider API \xABAnthropic Messages\xBB. Probar CON /v1 primero (linaje Cline) [inferido: validar en mano].",`Base URL: ${e}`]}];function ft(e,t){
+let n=e.split(delimiter).filter(r=>r.length>0),o=process.platform==="win32"?["",".exe",".cmd",".bat"]:[""];return r=>n.some(s=>o.some(i=>t(join(s,r+i))))}async function De(e,t={}){if(!Number.isInteger(e)||e<1||
+e>65535)throw new RangeError(`[bvsala doctor] puerto inv\xE1lido: ${String(e)}`);let n=t.home??homedir(),o=t.existe??existsSync,r=t.enPath??ft(t.path??process.env.PATH??"",o),s=`http://127.0.0.1:${e}`,i=`${s}/v1`,
+a=[],l=[`bvsala doctor \u2014 gateway local en ${s}`,"Solo imprime: no escribe ninguna configuraci\xF3n. Detecci\xF3n por existencia (binarios en PATH y","archivos de configuraci\xF3n de usuario); nunca \
+se lee el contenido de ning\xFAn archivo.",""];for(let p of mt){let c=p.configs.map(d=>join(n,d)),u=p.binario!==void 0&&r(p.binario),f=c.filter(d=>o(d)),b=u||f.length>0;b&&a.push(p.id);let m;p.detectable?
+b?m=`detectado \u2014 ${[...u?[`binario \`${p.binario}\` en PATH`]:[],...f.map(h=>`config presente: ${h}`)].join("; ")}`:m="no detectado":m="sin detecci\xF3n autom\xE1tica (extensi\xF3n de editor)",l.
+push(`\xBB ${p.id}: ${m}`),l.push(`  ${p.nombre}`);for(let d of p.receta({base:s,baseV1:i,rutas:c}))l.push(`  ${d}`);l.push(`  ${pt}`),l.push("");}return l.push("Regla BYOK: las recetas del anillo Anth\
+ropic (Goose, Qwen Code, opencode, Crush, Droid, Cline, Kilo) son","para API key. Nunca enrutes por el gateway el OAuth de una suscripci\xF3n Claude Pro/Max desde un harness","de terceros \u2014 Anthropic \
+lo proh\xEDbe. Claude Code y Codex con suscripci\xF3n se enrutan y se miden, pero no","se monetizan: no hay factura por tokens.","Detalle por terminal: docs/terminales/<terminal>.md"),{texto:l.join(`
+`),detectados:a}}var oe=class{id;exact=false;constructor(t="heuristic"){this.id=t;}count(t){if(t.length===0)return 0;let n=t.match(/[A-Za-z]+|\d+|\s+|[^\sA-Za-z\d]/g)??[],o=0;for(let r of n){let s=r[0];if(/\s/.test(s)){let i=(r.
+match(/\n/g)??[]).length;o+=i+Math.floor(Math.max(0,r.length-1)/2);}else /[A-Za-z]/.test(s)?o+=Math.max(1,Math.ceil(r.length/4)):/\d/.test(s)?o+=Math.max(1,Math.ceil(r.length/2)):o+=1;}return Math.max(o,
+Math.ceil(t.length/4))}},re=new oe;var se=class{estimators=new Map;modelToTokenizer=new Map;fallbackId;constructor(t=re){this.fallbackId=t.id,this.estimators.set(t.id,t);}register(t){return this.estimators.set(t.id,t),this}mapModel(t,n){
+return this.modelToTokenizer.set(t,n),this}resolve(t){let n=t.tokenizer?this.estimators.get(t.tokenizer):void 0;if(n)return n;if(t.model){let o=this.modelToTokenizer.get(t.model);if(o){let r=this.estimators.
+get(o);if(r)return r}}return this.estimators.get(this.fallbackId)}count(t,n){return this.resolve(n).count(t)}};new se;new TextEncoder;new TextDecoder;new TextDecoder;var _t={"gpt-4o-mini":{deltaTokens:-16,salidaDelBrazoA:72,contrato:"triage (6 fields, long enums)",pares:8},"gpt-4o":{deltaTokens:3,salidaDelBrazoA:75,contrato:"triage (6 fields, long enums)",pares:8}};
+X(_t);var le="0.4.6";var[,,y,...A]=process.argv;function Mt(){console.log(`bvsala ${le} \u2014 BiVelio Savings Layer
 
 Comandos:
-  gateway [--puerto N]   Proxy local medidor para Claude Code (ANTHROPIC_BASE_URL).
+  gateway [--puerto N]   Proxy local medidor (por defecto 8402) para terminales que
+                         respetan un base URL: Claude Code, opencode, Goose, Crush\u2026
   claude [args\u2026]         Lanza Claude Code a trav\xE9s del gateway, sin configurar nada.
+  codex [args\u2026]          Lanza Codex CLI a trav\xE9s del gateway (API key: api.openai.com;
+                         auth ChatGPT: chatgpt.com/backend-api/codex \u2014 se mide, no se monetiza).
+  goose [args\u2026]          Lanza Goose (ANTHROPIC_HOST) a trav\xE9s del gateway.
+  qwen [args\u2026]           Lanza Qwen Code (ANTHROPIC_BASE_URL) a trav\xE9s del gateway.
+  doctor [--puerto N]    Detecta terminales instalados e imprime su configuraci\xF3n exacta.
 
 Entorno:
   BIVELIO_SERVICE_KEY    Clave de servicio (bvk_\u2026): habilita metering + asiento.
   BVSALA_SEAT_ID         Identidad de asiento estable por r\xE9plica (opcional).
-  BVSALA_GATEWAY_UPSTREAM  Upstream alternativo (por defecto https://api.anthropic.com).
+  BVSALA_GATEWAY_UPSTREAM  Upstream alternativo (por defecto el del terminal).
   BVSALA_GATEWAY_COALESCE  =1 enciende la coalescencia de duplicados (F2, experimental).
+  BVSALA_CODEX_AUTH      api-key | chatgpt \u2014 fuerza el modo de auth de Codex.
+  CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1  (Claude Code, solo API key) tus modelos en /model.
 
 El gateway nunca corta el tr\xE1fico: sin clave o con la ingesta ca\xEDda, reenv\xEDa y avisa.
-Tus prompts jam\xE1s salen de tu m\xE1quina \u2014 solo cuentas y coste. M\xE1s: savings.bivelio.com`);}x!=="gateway"&&x!=="claude"&&(tt(),process.exit(x===void 0||x==="help"||x==="--help"?0:1));var ee=N.
-indexOf("--puerto"),j=x==="claude"?0:ee>=0?Number(N[ee+1]):8402;(!Number.isInteger(j)||j<0||j>65535)&&(console.error(`[bvsala gateway] puerto inv\xE1lido: ${N[ee+1]}`),process.exit(1));var te=process.
-env.BIVELIO_SERVICE_KEY,T=await me({puerto:j,...te?{serviceAccountKey:te}:{},...process.env.BVSALA_SEAT_ID?{seatId:process.env.BVSALA_SEAT_ID}:{},...process.env.BVSALA_GATEWAY_UPSTREAM?{upstream:process.
-env.BVSALA_GATEWAY_UPSTREAM}:{},...process.env.BVSALA_GATEWAY_COALESCE==="1"?{coalescer:true}:{},...process.env.BVSALA_METERING_URL?{meteringUrl:process.env.BVSALA_METERING_URL}:{}});console.log(`[bvsal\
-a gateway] v${Z} escuchando en http://127.0.0.1:${T.puerto}`);console.log(`[bvsala gateway] medici\xF3n: ${te?"ACTIVA (clave de servicio presente)":"APAGADA (falta BIVELIO_SERVICE_KEY)"}`);if(x==="cla\
-ude"){let t=spawn("claude",N,{stdio:"inherit",env:{...process.env,ANTHROPIC_BASE_URL:`http://127.0.0.1:${T.puerto}`}});t.on("error",e=>{console.error(`[bvsala claude] no se pudo lanzar \`claude\`: ${String(
-e)}. \xBFEst\xE1 instalado y en el PATH?`),T.cerrar().then(()=>process.exit(127));}),t.on("exit",(e,n)=>{T.cerrar().then(()=>process.exit(e??(n?1:0)));});}else console.log(`[bvsala gateway] apunta tu her\
-ramienta:  ANTHROPIC_BASE_URL=http://127.0.0.1:${T.puerto} claude`);var ye=async()=>{await T.cerrar(),process.exit(0);};process.on("SIGINT",()=>{ye();});process.on("SIGTERM",()=>{ye();});
+Tus prompts jam\xE1s salen de tu m\xE1quina \u2014 solo cuentas y coste. M\xE1s: savings.bivelio.com`);}var J=_e(y);y!=="gateway"&&y!=="doctor"&&!J&&(Mt(),process.exit(y===void 0||y==="help"||y==="--he\
+lp"?0:1));var ue=A.indexOf("--puerto"),_=J?0:ue>=0?Number(A[ue+1]):8402;(!Number.isInteger(_)||(y==="doctor"?_<1:_<0)||_>65535)&&(console.error(`[bvsala ${y}] puerto inv\xE1lido: ${A[ue+1]}`),process.
+exit(1));if(y==="doctor"){A.includes("--write")&&(console.error("[bvsala doctor] --write todav\xEDa no existe: el doctor solo imprime; copia el bloque a mano."),process.exit(1));let e=await De(_);console.
+log(e.texto),process.exit(0);}var R=J?ne(y,0,A,{modoCodex:y==="codex"?Oe({leerAuth:()=>readFileSync(join(homedir(),".codex","auth.json"),"utf8")}):void 0}):null,de=process.env.BIVELIO_SERVICE_KEY,E=await Ie({puerto:_,...de?
+{serviceAccountKey:de}:{},...process.env.BVSALA_SEAT_ID?{seatId:process.env.BVSALA_SEAT_ID}:{},...process.env.BVSALA_GATEWAY_UPSTREAM?{upstream:process.env.BVSALA_GATEWAY_UPSTREAM}:R?.upstream?{upstream:R.
+upstream}:{},...process.env.BVSALA_GATEWAY_COALESCE==="1"?{coalescer:true}:{},...process.env.BVSALA_METERING_URL?{meteringUrl:process.env.BVSALA_METERING_URL}:{}}),$t=process.env.BVSALA_GATEWAY_UPSTREAM??
+R?.upstream??"https://api.anthropic.com";console.log(`[bvsala gateway] v${le} escuchando en http://127.0.0.1:${E.puerto} \u2192 ${$t}`);console.log(`[bvsala gateway] medici\xF3n: ${de?"ACTIVA (clave d\
+e servicio presente)":"APAGADA (falta BIVELIO_SERVICE_KEY)"}`);process.env.BVSALA_GATEWAY_UPSTREAM&&R?.upstream&&process.env.BVSALA_GATEWAY_UPSTREAM!==R.upstream&&console.error(`[bvsala ${y}] AVISO: B\
+VSALA_GATEWAY_UPSTREAM=${process.env.BVSALA_GATEWAY_UPSTREAM} pisa el upstream de este terminal (${R.upstream}). Si no es lo que quieres, quita la variable.`);y==="codex"&&!we()&&console.error(`[bvsal\
+a codex] AVISO: este Node (${process.version}) no descomprime zstd y Codex manda el cuerpo en zstd: el tr\xE1fico pasa pero NO se mide. Usa Node \u2265 22.15.`);if(R&&J){let e=ne(y,E.puerto,A,{...R.upstream?
+{modoCodex:R.upstream.includes("chatgpt.com")?"chatgpt":"api-key"}:{}});e.nota&&console.log(`[bvsala ${y}] ${e.nota}`);let t=e.bin;if(process.platform==="win32"){let o=Ae(e.bin);o.tipo==="exe"?t=o.ruta:
+o.tipo==="solo-shim"&&(console.error(`[bvsala ${y}] \`${e.bin}\` est\xE1 instalado como shim de npm (${o.ruta}) y Windows no puede lanzarlo de forma segura con argumentos (CVE-2024-27980). Inst\xE1lalo c\
+on su instalador nativo (deja un ${e.bin}.exe en el PATH) o usa la receta manual de docs/terminales/.`),await E.cerrar(),process.exit(127));}let n=spawn(t,e.args,{stdio:"inherit",env:{...process.env,...e.
+env}});n.on("error",o=>{console.error(`[bvsala ${y}] no se pudo lanzar \`${e.bin}\`: ${String(o)}. \xBFEst\xE1 instalado y en el PATH?`),E.cerrar().then(()=>process.exit(127));}),n.on("exit",(o,r)=>{E.
+cerrar().then(()=>process.exit(o??(r?1:0)));});}else console.log(`[bvsala gateway] apunta tu terminal (o usa \`bvsala ${te.join("|")}\`):  ANTHROPIC_BASE_URL=http://127.0.0.1:${E.puerto} claude   \xB7   bv\
+sala doctor para el resto`);var Be=async()=>{await E.cerrar(),process.exit(0);};process.on("SIGINT",()=>{Be();});process.on("SIGTERM",()=>{Be();});

package/dist/index.d.ts

@@ -3237,6 +3237,6 @@ declare function createSavingsLayer(config: Omit<SavingsLayerConfig, "tokenizer"
  * constant to package.json so the two can never drift.
  */
 
-declare const BV_SALA_VERSION = "0.4.4";
+declare const BV_SALA_VERSION = "0.4.6";
 
 export { type AnthropicOptions, AnthropicProvider, BV_SALA_VERSION, type BivelioHandoff, CATALOGO, COMPACT_ROWS_INSTRUCTION, type CacheOutcome, type CacheTier, type CachedAnswer, type CanonicalRequest, type ChatMessage, type CompactRowsDecodeOptions, type CompactRowsOptions, type CompactVerification, type CompressionEconomics, type CompressionPolicyInput, type CompressionRequest, type CompressionResult, type Compressor, type ConstraintBackend, type ConstraintBackendId, type ConstraintPlan, type ConversationState, type CostBasis, type CostModel, DEFAULT_COST_MODEL, DEFAULT_MAX_STALENESS_SECONDS, type DeferredExecutionReport, type DeterministicResolver, EMBEDDED_PUBLIC_KEY, type EmbeddingFn, type EvidenceDoc, type ExactCache, ExactTokenizer, type ExecutionClass, ExecutionRouter, type FormatChoice, FormatSelector, type FormatSelectorOptions, type HandoffFact, HeuristicEstimator, InMemoryExactCache, InMemorySemanticCache, type JsonSchema, LicenseError, type LicenseGate, type LicenseKeyset, type LicenseStatus, type LicenseTokenPayload, type LocalClassifier, MODELOS_POR_CODIFICACION, MODELS_BY_ENCODING, type MemoryDelta, type MessageRole, MockProvider, type MockProviderOptions, type ModelCascadeMode, type ModelCascadeReport, type ModelCascadeSettings, type OpenAICompatibleOptions, OpenAICompatibleProvider, type OutputContract, PRECIOS_AL_DIA, type Policy, type ProtectedSpan, type Provider, type ProviderRequest, type ProviderResponse, type ProviderUsage, QUALITY_STATUSES, type QualityStatus, type RequestContext, type Reranker, type ResolvedDeps, type ResolvedGate, type ResolvedLicense, ResolverRegistry, type ResolverResult, type RetrievalOptions, type RetrievalOutcome, type RetrievalPlan, type Retriever, type RevocationListBody, type RevocationListVerification, type RevocationPollEvent, RevocationPoller, type RevocationPollerOptions, RevocationSnapshot, type RouteDecision, type SavingsLayer, type SavingsLayerConfig, SavingsLedger, type SavingsReport, type SavingsRequest, type SavingsResult, type SavingsToggles, SchemaRegistry, type SemanticCacheOptions, type SemanticHit, type SemanticRecord, type SemanticVerifier, type SerializationFormat, type Serializer, Singleflight, type TokenEstimator, TokenizerRegistry, type ToolCallRequest, type ToolDescriptor, type ToolRisk, type ToolSelection, ToolSelector, type ToolSelectorOptions, TraceCollector, type TraceEvent, UMBRAL_LOCAL, UsageEmitter, type UsageEmitterOptions, type ValidationError, type ValidationResult, adaptiveK, arithmeticResolver, buildExactKey, buildInflightKey, canonicalize, compactRowsSerializer, compresionFiel, computeNextDelay, cosine, createCompactRowsSerializer, createDefaultResolvers, createHandoff, createMockProvider, createSavingsLayer, csvSerializer, decodeCompactRows, dedupe, defaultTokenizerRegistry, deriveSeatId, deriveStatus, detectCi, embebedorLocal, emptyState, encodeCompactRows, evalArithmetic, evaluatePolicy, executeRetrievalPlan, gateFromKey, heuristicEstimator, isKeyset, isStrictCompatible, jsonCompactSerializer, keyTokensMatch, liveGateFromKey, mergeDelta, modelFamilyOf, multisetEqual, negationCount, noopCompressor, normalizeText, numericTokens, precioDeLista, projectContext, providerNativeBackend, randomId, registerExactTokenizer, registrarTokenizadorExacto, renderState, resolveConstraintBackend, resolveDependencies, resolveLicense, sha256, shouldCompress, stableStringify, uniformColumns, validateAgainstSchema, vectorLocal, verifyCompactSignature, verifyLicenseToken, verifyRevocationList, withProtectedSpans, words };

package/dist/index.js

@@ -781,7 +781,7 @@ ng/usage`:void 0);if(a){i=new dt({url:a,serviceAccountKey:t.serviceAccountKey,..
 {},...t.metering?.maxBatch!=null?{maxBatch:t.metering.maxBatch}:{},...t.metering?.maxBuffer!=null?{maxBuffer:t.metering.maxBuffer}:{},...t.meteringFetch?{fetchImpl:t.meteringFetch}:t.licenseFetch?{fetchImpl:t.
 licenseFetch}:{},...t.now?{now:t.now}:{},...t.metering?.ci!=null?{ci:t.metering.ci}:{},...t.silenceWarnings!=null?{silenceWarnings:t.silenceWarnings}:{}});let c=t.metering?.ci??cr();if(t.metering?.seatId)
 i.setSeat(t.metering.seatId,c);else {let l=i;lr(t.serviceAccountKey).then(u=>l.setSeat(u,c)).catch(()=>{});}i.start();}}return {generate:async a=>{let c=await s.generate(a);if(i)try{i.record(c.report);}catch{}
-return c},close:()=>{r?.stop(),o?.stop(),i?.stop();}}}var af="0.4.4";/*! Bundled license information:
+return c},close:()=>{r?.stop(),o?.stop(),i?.stop();}}}var af="0.4.6";/*! Bundled license information:
 
 @noble/curves/utils.js:
 @noble/curves/abstract/modular.js:

package/docs/terminales/README.md

@@ -0,0 +1,133 @@
+# Guías por terminal — medir el gasto de IA con el gateway local
+
+**Fecha:** 2026-08-30 · **Fuente de verdad:** `docs/PASARELA-S3-TERMINALES.md`
+§3 (formas de URL y mecanismos de enrutado verificados contra el código de cada
+terminal). Cada afirmación va marcada **[V]** (verificada en fuente) o **[I]**
+(inferida). Si una guía contradice a ese documento, manda el documento.
+
+## Qué es esto
+
+`bvsala gateway` es un proxy local medidor: escucha en `127.0.0.1`, reenvía
+cada petición **byte a byte** al proveedor (`https://api.anthropic.com` por
+defecto) y, una vez servida la respuesta, lee el `usage` del stream y lo
+convierte en coste. Tus prompts jamás salen de tu máquina hacia BiVelio — solo
+cuentas y coste. Nunca corta el tráfico: sin clave o con la ingesta caída,
+reenvía y avisa.
+
+Hoy **mide**; no optimiza todavía. Y mide **todo el tráfico de inferencia**
+que el terminal enruta por el base URL — no «todo el tráfico»: cada guía dice
+lo que su terminal manda por fuera.
+
+## Índice
+
+| Guía | Base URL exacto | `/v1` | Enrutado [V] | Envoltorio | Estado |
+|---|---|---|---|---|---|
+| [Claude Code](claude-code.md) | `http://127.0.0.1:8402` | **sin** | env `ANTHROPIC_BASE_URL` | `bvsala claude` ✅ | [V] en producción |
+| [Codex CLI](codex.md) | `http://127.0.0.1:8402/v1` (API key) · `…/backend-api/codex` (ChatGPT) | **con** | `codex -c openai_base_url=…` | `bvsala codex` ✅ | [V] validado en mano el 30-08 (426 → fallback HTTP, stream íntegro) |
+| [Goose](goose.md) | `http://127.0.0.1:8402` | **sin** | env `ANTHROPIC_HOST` | `bvsala goose` ✅ | [V] |
+| [Qwen Code](qwen-code.md) | `http://127.0.0.1:8402` | **sin** | env `ANTHROPIC_BASE_URL` + `~/.qwen/settings.json` | `bvsala qwen` ✅ | [V] |
+| [opencode](opencode.md) | `http://127.0.0.1:8402/v1` | **con** | `~/.config/opencode/opencode.json` | — (config de usuario) | [V] |
+| [Crush](crush.md) | `http://127.0.0.1:8402/v1` | **con**, sin barra final | `~/.config/crush/crushrc` | — (config de usuario) | [V] |
+| [Droid](droid.md) | `http://127.0.0.1:8402` | sin **[I]** | `~/.factory/settings.json` | — (config de usuario) | validar en mano |
+| [Cline](cline.md) | `http://127.0.0.1:8402/v1` | **con** | UI | — | [V] |
+| [Kilo Code](kilo.md) | `http://127.0.0.1:8402/v1` | con **[I]** | UI | — | validar en mano |
+
+Reglas de la columna «Base URL»: **nunca barra final**, **nunca redirecciones**
+(un 3xx en el base URL es fallo por diseño del cliente, y el gateway lo reenvía
+en vez de seguirlo). Y nunca copies el URL de un terminal a otro: cada SDK añade
+su propio tramo de ruta y el error es silencioso (§ «Comprobar que mide»).
+
+Claude Code, Codex, Goose y Qwen Code tienen **envoltorio propio** (`bvsala
+claude|codex|goose|qwen`): arrancan un gateway en puerto efímero, lanzan el
+terminal apuntándole y lo apagan al salir. Cero configuración persistente. La
+receta manual de cada guía hace exactamente lo mismo. Para el resto,
+`bvsala doctor` imprime el bloque exacto de cada terminal instalado.
+
+## Lo común a todas las guías
+
+### 1 · Instalar y arrancar el gateway
+
+```bash
+npm i -g @bivelio/savings-layer      # trae el binario `bvsala`
+export BIVELIO_SERVICE_KEY=bvk_…     # clave de servicio, desde tu panel. Sin ella: reenvía, NO mide
+bvsala gateway                        # escucha en http://127.0.0.1:8402
+bvsala gateway --puerto 8500          # otro puerto si el 8402 está ocupado
+```
+
+Al arrancar imprime dos líneas; la segunda te dice si estás midiendo:
+
+```
+[bvsala gateway] v0.4.4 escuchando en http://127.0.0.1:8402
+[bvsala gateway] medición: ACTIVA (clave de servicio presente)
+```
+
+`medición: APAGADA (falta BIVELIO_SERVICE_KEY)` = el terminal funciona igual,
+pero nada llega a tu panel.
+
+Un gateway habla con **un** upstream (`BVSALA_GATEWAY_UPSTREAM`, por defecto
+`https://api.anthropic.com`). Los terminales del dialecto Anthropic comparten
+instancia; Codex necesita la suya contra OpenAI — `bvsala codex` la arranca
+sola con el upstream correcto según tu modo de auth (ver su guía).
+
+### 2 · Comprobar que mide: el log del gateway
+
+Por cada llamada de inferencia servida y medida, el gateway escribe una línea
+con el coste:
+
+```
+[gateway] POST /v1/messages  · <modelo> · $0.001234 (in 120, cache↑0 cache↓46792, out 8)
+```
+
+Si ves esa línea con `$`, el terminal está enrutado y medido. Lo que significan
+las otras líneas:
+
+| Línea en el log | Qué pasa | Arreglo |
+|---|---|---|
+| `[gateway] POST /v1/v1/messages → 404` | el base URL lleva `/v1` **de más** para ese terminal | quita el `/v1` |
+| `[gateway] POST /messages → 404` | al base URL le **falta** `/v1` (el SDK solo añade `/messages`) | añade el `/v1` |
+| `[bvsala gateway] el modelo "…" no está en el catálogo de precios; su uso se reenvía pero no se mide.` | modelo fuera de catálogo (a propósito: presente-y-mal es peor que ausente) | nada; se reenvía sin medir |
+| nada de nada | el terminal no está apuntando al gateway (config no leída, env pisado por config, otro puerto) | revisa la trampa de su guía |
+
+Claude Code manda además un `HEAD /api/hello` antes de la primera llamada: es
+la sonda de vida, no una inferencia.
+
+`bvsala doctor [--puerto N]`: sondea el PATH y la existencia de las configs de
+usuario (nunca lee su contenido) e imprime el bloque exacto por terminal con el
+puerto indicado. Solo imprime: no escribe ninguna configuración.
+
+### 3 · Windows
+
+`npm i -g @bivelio/savings-layer` y `bvsala claude` son idénticos en los tres
+sistemas. Lo que cambia es cómo se fija la clave en la sesión — el `export` de
+estas guías es POSIX; en PowerShell:
+
+```powershell
+$env:BIVELIO_SERVICE_KEY = "bvk_…"
+bvsala claude
+```
+
+(En `cmd`: `set BIVELIO_SERVICE_KEY=bvk_…`.) El prefijo `VAR=valor comando` de
+las recetas manuales también es POSIX: en Windows, fija la variable primero y
+lanza después.
+
+Y una condición dura: el terminal debe estar instalado con su **instalador
+nativo** (un `claude.exe` / `codex.exe` en el PATH — Claude Code, Codex, Goose
+y Qwen Code lo tienen [V]). El shim `.cmd` que deja `npm i -g <terminal>` no
+puede lanzarse de forma segura con argumentos (CVE-2024-27980) y `bvsala` se
+niega con una guía en vez de fallar con un ENOENT mudo.
+
+### 4 · Regla BYOK, sin excepción
+
+Todas las recetas del anillo 2 (Goose, Qwen Code, opencode, Crush, Droid, Cline,
+Kilo) son **API key exclusivamente**. Anthropic prohíbe usar el OAuth de Claude
+Pro/Max en harnesses de terceros (opencode lo documenta; Crush retiró su OAuth en
+ene-2026). El gateway reenviaría un Bearer de suscripción sin inmutarse — y eso
+no se promociona ni se documenta como receta.
+
+### 5 · Wording honesto
+
+«Anthropic doesn't endorse, maintain, or audit third-party gateway products»
+[V]. El modo BV-SALA es **configuración soportada del binario sin modificar**:
+di eso, nunca «aprobado por Anthropic». El contrato del gateway es una lista
+abierta de cabeceras y campos que crece con cada release del terminal; el
+passthrough byte a byte es lo que lo mantiene vivo sin tocar nada.

package/docs/terminales/claude-code.md

@@ -0,0 +1,110 @@
+# Claude Code a través del gateway
+
+**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §1 (conformidad con el protocolo
+oficial de gateway de Claude Code, leído íntegro el 2026-08-30). Es el terminal
+de referencia: 10 de 12 requisitos del protocolo los cumple el passthrough por
+construcción, con test.
+
+## Qué necesitas
+
+- `claude` en el PATH.
+- **Una API key de Anthropic** (`ANTHROPIC_API_KEY`, o `ANTHROPIC_AUTH_TOKEN` /
+  `apiKeyHelper`): es el segmento que BV-SALA mide y factura. Con login de
+  claude.ai el enrutado también funciona — la doc oficial lo sanciona: el login
+  sigue siendo la credencial activa y «its usage limits and billing apply» [V] —
+  pero ahí no hay factura por token que recortar.
+- `bvsala` instalado y `BIVELIO_SERVICE_KEY` exportada (ver [README](README.md)).
+
+## Envoltorio: `bvsala claude` (recomendado)
+
+```bash
+export BIVELIO_SERVICE_KEY=bvk_…
+bvsala claude                    # cualquier argumento pasa tal cual: bvsala claude -p "hola"
+```
+
+Arranca el gateway en un **puerto efímero**, lanza `claude` con
+`ANTHROPIC_BASE_URL=http://127.0.0.1:<puerto>` en su entorno, hereda tu
+terminal entera (el TUI funciona tal cual) y apaga el gateway cuando `claude`
+sale. No escribe ninguna configuración. No toca credenciales: el reenvío de
+`Authorization` / `x-api-key` es íntegro.
+
+## Manual: `ANTHROPIC_BASE_URL`
+
+Si prefieres un gateway compartido en un puerto fijo (por ejemplo para varios
+terminales a la vez):
+
+```bash
+bvsala gateway                                       # ventana 1: http://127.0.0.1:8402
+ANTHROPIC_BASE_URL=http://127.0.0.1:8402 claude      # ventana 2 — SIN /v1
+```
+
+Claude Code añade `/v1/messages` por su cuenta. Sin barra final.
+
+## Comprobar que funciona
+
+En el log del gateway, en este orden:
+
+```
+[gateway] HEAD /api/hello → 200
+[gateway] POST /v1/messages  · <modelo> · $0.001234 (in 120, cache↑0 (1h 49268) cache↓43430, out 8)
+```
+
+El `HEAD /api/hello` es la sonda de vida que Claude Code manda antes de la
+primera llamada. La línea con `$` es la inferencia medida. La cifra `cache↑ …
+(1h …)` es normal: Claude Code escribe caché a 1 h, y es más de la mitad de la
+entrada en sesiones reales.
+
+## Model discovery (opcional, solo con API key)
+
+```bash
+CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 bvsala claude
+```
+
+Con la bandera, Claude Code pide `GET /v1/models?limit=1000` al gateway
+(timeout 3 s, credencial en `Authorization` **y** `x-api-key`) y filtra ids que
+contengan «claude»/«anthropic» [V]. El passthrough lo sirve por construcción
+(api.anthropic.com responde `{data:[{id,display_name}]}`) y en `/model` debería
+aparecer «From gateway».
+
+Honestidad sobre el estado: el passthrough de `GET /v1/models` **tiene test**
+(pasa íntegro y no factura); la validación en mano con API key está pendiente
+(S3 §1.2). Y las únicas fuentes de credencial
+del discovery son `ANTHROPIC_AUTH_TOKEN`/`apiKeyHelper` y `ANTHROPIC_API_KEY`: un
+login claude.ai **no** es fuente, así que en suscripción pura el cliente escribe
+`[gatewayDiscovery] skipped` y ni pregunta.
+
+## La trampa típica
+
+1. **`/v1` en el base URL.** `ANTHROPIC_BASE_URL=http://127.0.0.1:8402/v1` da
+   `[gateway] POST /v1/v1/messages → 404` y Claude Code reporta un error
+   genérico. Sin `/v1`.
+2. **Watchdog de 300 s.** En conexiones por `ANTHROPIC_BASE_URL` Claude Code
+   corta un stream sin bytes durante 300 s (único valor que documenta hoy la doc
+   oficial). En el camino normal el gateway no bufferiza y reenvía los pings
+   como bytes, así que no salta. Solo bajo `BVSALA_GATEWAY_COALESCE=1` (apagada
+   por defecto) una petición gemela espera a que termine la primaria, y una
+   primaria de más de 300 s la mataría — está identificado en S3 §1.1 y no se
+   enciende por defecto hasta arreglarlo.
+3. **Redirecciones.** Cualquier 3xx en el base URL es fallo de discovery por
+   diseño del cliente; el gateway reenvía el 3xx en vez de seguirlo con tu
+   credencial (`redirect: "manual"`, verificado).
+
+## Lo que NO pasa por el gateway (aviso honesto)
+
+La promesa de medición es «todo el tráfico de **inferencia**», no «todo el
+tráfico»: **fast-mode y el safety-check de WebFetch van directos a
+api.anthropic.com por diseño del cliente** [V]. Ese gasto no aparece en tu panel
+y no es computable desde el gateway. El contrato es una lista abierta que crece
+con cada release de Claude Code; BV-SALA repite el smoke test de `bvsala claude`
+contra cada versión nueva.
+
+Las cabeceras `x-claude-code-session-id` / `agent-id` / `parent-agent-id`
+llegan en el tráfico real y hoy se reenvían sin consumirlas: el coste por sesión
+y por subagente está previsto en S3 §1.3, todavía no en el panel.
+
+## Nota BYOK y wording
+
+El modo BV-SALA es **configuración soportada del binario sin modificar**, nunca
+«aprobado por Anthropic» («Anthropic doesn't endorse, maintain, or audit
+third-party gateway products» [V]). Lo que BV-SALA mide y factura es el uso por
+API key; el gateway no persiste ninguna credencial, sea cual sea.

package/docs/terminales/cline.md

@@ -0,0 +1,53 @@
+# Cline a través del gateway
+
+**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §3 [V]. Cline configura el
+proveedor por **UI** (extensión de VS Code), así que aquí no hay archivo ni
+envoltorio: solo pasos y la forma exacta del URL, que es **con `/v1`**.
+
+Por qué con `/v1` (refutación verificada): Cline `main` ya usa
+`@ai-sdk/anthropic`, no el SDK TS oficial; su `normalizeBaseURL` solo añade
+`/v1` cuando el URL es exactamente `https://api.anthropic.com`, y `builtins.ts`
+fija `https://api.anthropic.com/v1` [V]. Con un URL custom, lo que pongas es lo
+que se usa.
+
+## Qué necesitas
+
+- Cline instalado en VS Code.
+- Tu **API key** de Anthropic.
+- `bvsala gateway` corriendo en `http://127.0.0.1:8402` (ver [README](README.md)).
+
+## Pasos en la UI
+
+1. Abre los ajustes de Cline → **API Provider**: elige **Anthropic**.
+2. Pega tu **Anthropic API Key**.
+3. Marca **«Use custom base URL»** y escribe exactamente:
+
+   ```
+   http://127.0.0.1:8402/v1
+   ```
+
+   **Con `/v1`, sin barra final.**
+4. Elige el modelo y guarda.
+
+## Comprobar que funciona
+
+Manda un mensaje trivial desde Cline y mira la ventana del gateway:
+
+```
+[gateway] POST /v1/messages  · <modelo> · $0.001234 (in 120, cache↑0 cache↓0, out 8)
+```
+
+## La trampa típica
+
+- **Sin `/v1`** → Cline pide `…/messages` → `[gateway] POST /messages → 404` y
+  la UI muestra un error genérico de API. Añade el `/v1`.
+- **Barra final** → no.
+- **Gateway apagado**: la UI recuerda el base URL custom; cuando no tengas
+  `bvsala gateway` corriendo, Cline fallará hasta que lo arranques o desmarques
+  la casilla.
+
+## Nota BYOK
+
+**API key exclusivamente.** Anthropic prohíbe usar el OAuth de Claude Pro/Max en
+harnesses de terceros (Cline estuvo en la primera oleada del bloqueo de
+ene-2026). Esta receta es la del proveedor Anthropic con API key; nada más.

package/docs/terminales/codex.md

@@ -0,0 +1,132 @@
+# Codex CLI a través del gateway
+
+**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §2 (código de `openai/codex`,
+`openai-node` y docs de OpenAI, 2026-08-30). **Estado: envoltorio en el
+paquete y validado en mano el 30-08** (sesión real de Codex v0.134 con auth
+ChatGPT: 426 → fallback HTTP, stream íntegro, registro `measured` en la
+ingesta). Lee «Qué mide» y las validaciones pendientes antes de anunciar
+cifras.
+
+## Qué necesitas
+
+- `codex` en el PATH.
+- Login en Codex: **API key de OpenAI** (el caso que se monetiza) o
+  suscripción ChatGPT (se enruta y se mide, pero **no se monetiza**: no hay
+  factura por tokens; ver más abajo).
+- `bvsala` instalado y `BIVELIO_SERVICE_KEY` exportada (ver [README](README.md)).
+
+## Envoltorio: `bvsala codex [args…]`
+
+```bash
+export BIVELIO_SERVICE_KEY=bvk_…
+bvsala codex                       # cualquier argumento pasa tal cual a codex
+```
+
+Espejo de `bvsala claude`: gateway efímero con el upstream que toque +
+`spawn("codex", ["-c", 'openai_base_url="http://127.0.0.1:<puerto><prefijo>"', ...resto])`
+(cadena TOML entrecomillada: «values are parsed as TOML», doc oficial). Por qué
+así y no por variable de entorno:
+
+- `-c` es flag global de **máxima precedencia** [V]; **no existe** una env
+  `OPENAI_BASE_URL` en Codex (cero referencias en su código de config) [V].
+- Sin escribir config, el ajuste muere con el proceso: nada queda apuntando a un
+  gateway que ya no corre.
+- **El prefijo depende del modo de auth** [V `AuthDotJson`, `to_api_provider`]:
+  `ApiKey` → upstream `https://api.openai.com`, prefijo `/v1`; toda la familia
+  ChatGPT → upstream `https://chatgpt.com`, prefijo `/backend-api/codex`. El
+  envoltorio lee `auth_mode` de `~/.codex/auth.json` **por existencia/valor del
+  enum, jamás imprime tokens**; `BVSALA_CODEX_AUTH=api-key|chatgpt` lo fuerza.
+
+## Manual (API key): `-c openai_base_url=…`
+
+```bash
+BVSALA_GATEWAY_UPSTREAM=https://api.openai.com bvsala gateway     # ventana 1: http://127.0.0.1:8402
+codex -c openai_base_url=http://127.0.0.1:8402/v1                 # ventana 2 — CON /v1, sin barra final
+```
+
+Codex añade `/responses` (`POST {base_url}/responses`, siempre `stream: true`)
+[V]. Si en el 8402 ya tienes el gateway de Anthropic para otros terminales,
+arranca este en otro puerto (`--puerto 8403`) y apunta ahí: un gateway habla con
+un solo upstream.
+
+No lo escribas en `~/.codex/config.toml`: ahí se quedaría fijo y Codex fallaría
+cada vez que el gateway no esté corriendo. El `-c` por sesión es la forma.
+
+## Comprobar que funciona
+
+En el log del gateway verás, en este orden, la sesión real (30-08):
+
+```
+[gateway] GET /backend-api/codex/models → 200
+[gateway] GET /backend-api/codex/responses → 426 (WebSocket no soportado; el cliente cae a HTTP)
+[gateway] POST /backend-api/codex/responses → el cliente cerró tras el usage; se mide igual
+[gateway] POST /backend-api/codex/responses  · gpt-5.5 · $0.210766 (in 41880, cache↑0 cache↓2432, out 5)
+```
+
+(Con API key la ruta es `/v1/responses`.) La línea con `$` es la medición.
+
+**Qué mide:** el `usage` de `event: response.completed` con la fórmula oficial
+de OpenAI (`entrada = input − cached − writes`; `cached` a la tarifa cacheada
+del catálogo; `writes` a 1,25×, la prima oficial de gpt-5.6+) [V]. Tres cosas
+que el tráfico real enseñó y el gateway ya contempla:
+
+- Codex **cierra la conexión nada más recibir `response.completed`**; el
+  gateway mide igual con el usage ya observado («se mide igual» en el log).
+- El backend de ChatGPT sirve el SSE **sin cabecera `content-type`**; en las
+  rutas `…/responses` el gateway asume SSE si falta.
+- Codex manda el cuerpo de la petición **comprimido con zstd**; el gateway lo
+  reenvía intacto y lee el `model` a través del `content-encoding` (Node ≥ 22.15
+  para zstd; en un Node sin zstd la petición pasa y no se mide).
+
+## La trampa típica
+
+1. **El prefijo.** Con API key es `/v1` **exacto**. Con la familia ChatGPT el
+   base_url tiene que terminar **exactamente** en `/backend-api/codex` o
+   `supports_codex_backend_routes()` se apaga [V]. Mezclarlos = 404 silencioso.
+2. **Una línea `failed to connect to websocket: HTTP error: 426`** al arrancar
+   es normal: Codex intenta WebSocket primero (`supports_websockets: true` está
+   hardcodeado y no se apaga por config [V]); el gateway responde `426 Upgrade
+   Required` y el fallback a HTTP es inmediato y pegajoso por sesión [V test
+   `websocket_fallback.rs`]. Sin «Reconnecting…».
+3. **`failed to refresh available models: unknown variant …`** es de tu versión
+   de Codex frente a su backend: aparece igual **sin** gateway (comprobado).
+4. **Barra final.** `…/v1/` no.
+
+## Modo suscripción ChatGPT — validado, medido, NO monetizado
+
+Validado en mano el 30-08 (prefijo `/backend-api/codex`, upstream
+`https://chatgpt.com`): 200, stream íntegro, `usage` presente en
+`response.completed` y registro `measured` en la ingesta. **Pero un suscriptor
+no paga por tokens**: la cifra que ve es el equivalente a precio de lista por
+API key, no una factura; y como la comisión de BV-SALA solo toca ahorro medido
+sobre gasto real, este tráfico **no se monetiza** — igual que el OAuth de
+suscripción en Claude Code (`docs/PASARELA-F0.md`: «el caso que NO
+facturamos»). OpenAI ni bendice ni prohíbe el proxy de suscripción (silencio
+del staff, a diferencia de Anthropic, que lo documenta). Postura idéntica a
+Claude Code: cero persistencia de `Authorization` / `ChatGPT-Account-ID`,
+binario sin modificar, y no se promociona como modo de ahorro.
+
+**Laguna conocida:** el registro que emite el gateway para un suscriptor es hoy
+**idéntico** al de una API key (`basis: measured`, coste a precio de lista) —
+el panel no puede distinguirlos. Mientras la comisión sea 0 no hay efecto; antes
+de que S4 calcule comisión sobre ahorro medido, S2 etiquetará la auth de
+suscripción en el wire para que ese tráfico jamás entre en la base. Está en el
+plan (`docs/PLAN-PASARELA-API-KEY.md`, S3).
+
+## Validaciones en mano
+
+- ✅ (b) Suscripción ChatGPT: 426 → fallback, 200, stream íntegro, `usage`
+  presente, registro `measured` (30-08).
+- ⏳ (a) Sesión con **API key** (ruta `/v1/responses` contra api.openai.com):
+  misma mecánica, pendiente de una cuenta con API key.
+- ⏳ (c) Plausibilidad `cached + writes ≤ input` en un prompt repetido > 1.024
+  tokens (OpenAI reconoció contadores mal en el arranque de 5.6). El gateway
+  ya recorta al lado que infra-mide si no cuadra.
+- ⏳ Contrastar la cifra del gateway con la consola del proveedor en una sesión
+  larga (Codex imprime su propio «tokens used»; la fuente de BV-SALA es el
+  `usage` del proveedor, no ese contador).
+
+## Nota BYOK
+
+La receta documentada es **API key exclusivamente**. El gateway no persiste
+ninguna credencial; lo que factura BV-SALA es el uso por API key.

package/docs/terminales/crush.md

@@ -0,0 +1,52 @@
+# Crush a través del gateway
+
+**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §3 [V]. Crush (Charm) configura
+proveedores por **`~/.config/crush/crushrc`** (un script Bash); `crush.json`
+está **deprecado** (verificado 2026-08-30). Su SDK Go resuelve rutas de forma
+relativa, y eso dicta la forma del URL: **con `/v1`, sin barra final**.
+
+## Qué necesitas
+
+- `crush` instalado.
+- `ANTHROPIC_API_KEY` exportada (Crush retiró su OAuth de Claude en ene-2026:
+  solo API key).
+- `bvsala` instalado y `BIVELIO_SERVICE_KEY` exportada (ver [README](README.md)).
+
+## Config de usuario: `~/.config/crush/crushrc`
+
+Añade esta línea:
+
+```bash
+provider add bvsala --type anthropic --base-url http://127.0.0.1:8402/v1 --api-key "$ANTHROPIC_API_KEY"
+```
+
+Y elige el proveedor `bvsala` en Crush. `crush.json` no: deprecado.
+
+No hay envoltorio `bvsala crush`: el enrutado es config de usuario. El
+`bvsala doctor --write crush` previsto en S3 hará un append comentado de esa
+línea en tu `crushrc` (con copia `.bak`).
+
+## Arrancar y comprobar
+
+```bash
+bvsala gateway        # http://127.0.0.1:8402
+crush
+```
+
+```
+[gateway] POST /v1/messages  · <modelo> · $0.001234 (in 120, cache↑0 cache↓0, out 8)
+```
+
+## La trampa típica
+
+- **Barra final.** `--base-url http://127.0.0.1:8402/v1/` → el SDK Go resuelve
+  relativo y pide `/v1/v1/messages` → `[gateway] POST /v1/v1/messages → 404` [V].
+  Sin barra.
+- **Sin `/v1`** → `[gateway] POST /messages → 404`.
+- **`crush.json`** → deprecado; si tienes uno viejo con otro proveedor, puede
+  seguir mandando. Usa `crushrc`.
+
+## Nota BYOK
+
+**API key exclusivamente.** Crush ya retiró su OAuth de Claude; el gateway
+reenviaría cualquier credencial sin inmutarse, pero la receta es esta.

package/docs/terminales/droid.md

@@ -0,0 +1,55 @@
+# Droid (Factory) a través del gateway
+
+**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §3. Droid es **cerrado**; el
+mecanismo de enrutado está verificado [V] (`~/.factory/settings.json` →
+`customModels[]` con `provider: "anthropic"`), pero **la forma del base URL es
+inferida [I]: hay que validarla en mano contra el log del gateway.** Esta guía
+lo dice tal cual; no hay validación hecha.
+
+## Qué necesitas
+
+- `droid` instalado, en modo BYOK con tu **API key** de Anthropic.
+- `bvsala` instalado y `BIVELIO_SERVICE_KEY` exportada (ver [README](README.md)).
+
+## Config de usuario: `~/.factory/settings.json`
+
+```json
+{
+  "customModels": [
+    {
+      "provider": "anthropic",
+      "baseUrl": "http://127.0.0.1:8402",
+      "apiKey": "<tu ANTHROPIC_API_KEY>"
+    }
+  ]
+}
+```
+
+Las claves verificadas [V] son `customModels[]{provider:"anthropic", baseUrl,
+apiKey}`. La forma **sin `/v1`** es inferida [I]. Conserva el resto de tu
+`settings.json` (el `doctor --write droid` previsto en S3 hará el merge JSON
+conservador con copia `.bak`).
+
+## Validar en mano (obligatorio antes de fiarte)
+
+1. `bvsala gateway` en una ventana.
+2. Lanza `droid` con ese modelo custom y haz una pregunta trivial.
+3. Mira el log del gateway:
+   - `[gateway] POST /v1/messages  · <modelo> · $…` → la forma sin `/v1` es la
+     buena. Confírmalo en S3 (pasar el [I] a [V]).
+   - `[gateway] POST /messages → 404` → Droid solo añade `/messages`: cambia el
+     `baseUrl` a `http://127.0.0.1:8402/v1` y repite.
+   - nada en el log → Droid no está leyendo el modelo custom; revisa que sea el
+     modelo seleccionado.
+
+## La trampa típica
+
+- **Adivinar el `/v1`**: por eso el paso de validación. Un URL mal formado
+  falla en silencio (404 del upstream sin medir).
+- **La API key va en el JSON**: es config de usuario en tu máquina; no la
+  copies a ningún repo ni la pegues en un ticket.
+
+## Nota BYOK
+
+**API key exclusivamente.** Droid es BYOK; Anthropic prohíbe el OAuth de Claude
+Pro/Max en harnesses de terceros, y esta receta no lo contempla.

package/docs/terminales/goose.md

@@ -0,0 +1,54 @@
+# Goose a través del gateway
+
+**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §3 [V]. Goose habla dialecto
+Anthropic puro y autentica con `x-api-key` + `anthropic-version`, que el
+reenvío pasa intactos: **nada que cambiar en el gateway**, todo está en la
+forma del URL.
+
+## Qué necesitas
+
+- `goose` en el PATH, con el proveedor Anthropic elegido.
+- `ANTHROPIC_API_KEY` exportada (Goose es solo BYOK).
+- `bvsala` instalado y `BIVELIO_SERVICE_KEY` exportada (ver [README](README.md)).
+
+## Envoltorio: `bvsala goose`
+
+```bash
+export BIVELIO_SERVICE_KEY=bvk_…
+bvsala goose                       # espejo exacto de `bvsala claude`
+```
+
+Espejo exacto de `bvsala claude`: gateway efímero, `goose` lanzado con
+`ANTHROPIC_HOST=http://127.0.0.1:<puerto>`, todo muere al salir. La tabla vive
+en `gateway/envoltorios.ts`. La receta manual de abajo es literalmente lo mismo.
+
+## Manual: `ANTHROPIC_HOST`
+
+```bash
+bvsala gateway                                        # ventana 1: http://127.0.0.1:8402
+ANTHROPIC_HOST=http://127.0.0.1:8402 goose            # ventana 2 — SIN /v1
+```
+
+`ANTHROPIC_HOST` **pisa** lo que haya en `config.yaml` [V], así que no hace
+falta tocar ningún archivo. Sin `/v1`, sin barra final: Goose añade
+`/v1/messages` por su cuenta.
+
+## Comprobar que funciona
+
+```
+[gateway] POST /v1/messages  · <modelo> · $0.001234 (in 120, cache↑0 cache↓0, out 8)
+```
+
+## La trampa típica
+
+- **`/v1` en `ANTHROPIC_HOST`** → `[gateway] POST /v1/v1/messages → 404`. Quítalo.
+- **Escribir el host en `config.yaml`** en vez de la variable: funciona, pero
+  se queda fijo y Goose falla cada vez que el gateway no esté corriendo. La
+  variable de entorno por sesión es la forma; la env pisa al archivo de todos
+  modos.
+
+## Nota BYOK
+
+**API key exclusivamente.** Anthropic prohíbe usar el OAuth de Claude Pro/Max
+en harnesses de terceros; Goose es BYOK y esta receta también. El gateway
+reenviaría cualquier credencial sin inmutarse — eso no es una receta.

package/docs/terminales/kilo.md

@@ -0,0 +1,50 @@
+# Kilo Code a través del gateway
+
+**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §3. Kilo Code configura por **UI**
+(proveedor custom con Provider API «Anthropic Messages»; la config queda en
+`kilo.json`, detectable) [V]. **La forma del base URL es inferida [I] por
+linaje Cline: probar con `/v1` primero y validar en mano contra el log del
+gateway.** No hay validación hecha; esta guía lo dice tal cual.
+
+## Qué necesitas
+
+- Kilo Code instalado en VS Code.
+- Tu **API key** de Anthropic.
+- `bvsala gateway` corriendo en `http://127.0.0.1:8402` (ver [README](README.md)).
+
+## Pasos en la UI
+
+1. Ajustes de Kilo Code → añade un **proveedor custom**.
+2. **Provider API**: «Anthropic Messages».
+3. Pega tu **API key** de Anthropic.
+4. **Base URL** — prueba primero:
+
+   ```
+   http://127.0.0.1:8402/v1
+   ```
+
+   **Sin barra final.**
+5. Elige el modelo y guarda.
+
+## Validar en mano (obligatorio antes de fiarte)
+
+Manda un mensaje trivial y mira la ventana del gateway:
+
+- `[gateway] POST /v1/messages  · <modelo> · $…` → **con `/v1`** es la forma
+  buena; confírmalo en S3 (pasar el [I] a [V]).
+- `[gateway] POST /v1/v1/messages → 404` → Kilo ya añade `/v1`: quita el `/v1`
+  del base URL (`http://127.0.0.1:8402`) y repite.
+- `[gateway] POST /messages → 404` → falta el `/v1`; vuelve a ponerlo.
+- nada en el log → el proveedor custom no es el activo.
+
+## La trampa típica
+
+- **Adivinar el `/v1`**: de ahí el paso de validación. Un URL mal formado falla
+  en silencio (404 del upstream, nada medido, error genérico en la UI).
+- **Gateway apagado**: `kilo.json` recuerda el base URL; sin `bvsala gateway`
+  corriendo, Kilo fallará hasta que lo arranques o cambies de proveedor.
+
+## Nota BYOK
+
+**API key exclusivamente.** Anthropic prohíbe usar el OAuth de Claude Pro/Max en
+harnesses de terceros; esta receta es la del proveedor custom con API key.

package/docs/terminales/opencode.md

@@ -0,0 +1,67 @@
+# 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`.
+
+## Qué necesitas
+
+- `opencode` instalado, proveedor `anthropic` con tu **API key** de Anthropic.
+- `bvsala` instalado y `BIVELIO_SERVICE_KEY` exportada (ver [README](README.md)).
+
+## Config de usuario: `~/.config/opencode/opencode.json`
+
+```json
+{
+  "provider": {
+    "anthropic": {
+      "options": {
+        "baseURL": "http://127.0.0.1:8402/v1"
+      }
+    }
+  }
+}
+```
+
+**Con `/v1`, sin barra final.** Es la clave `provider.anthropic.options.baseURL`
+[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
+{ "provider": { "anthropic": { "options": { "baseURL": "{env:BVSALA_BASE_URL}" } } } }
+```
+
+Escrito una vez, habilita un uso puro-env (`BVSALA_BASE_URL=http://127.0.0.1:8402/v1 opencode`).
+**Trampa:** sin la variable, el `baseURL` queda vacío y opencode no funciona.
+
+## Arrancar y comprobar
+
+```bash
+bvsala gateway        # http://127.0.0.1:8402
+opencode
+```
+
+```
+[gateway] POST /v1/messages  · <modelo> · $0.001234 (in 120, cache↑0 cache↓0, out 8)
+```
+
+## La trampa típica
+
+- **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.
+- **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.)
+
+## Nota BYOK
+
+**API key exclusivamente.** opencode documenta expresamente que el OAuth de
+Claude Pro/Max no puede usarse en harnesses de terceros; esta receta lo respeta.

package/docs/terminales/qwen-code.md

@@ -0,0 +1,76 @@
+# Qwen Code a través del gateway
+
+**Fuente:** `docs/PASARELA-S3-TERMINALES.md` §3 [V]. Qwen Code con proveedor
+Anthropic habla dialecto Anthropic puro (SDK TS oficial), así que el medidor
+actual lo entiende sin cambios. La familia de modelos **qwen** queda fuera del
+catálogo a propósito (más abajo).
+
+## Qué necesitas
+
+- `qwen` en el PATH.
+- **Una API key de Anthropic** (`ANTHROPIC_API_KEY`), con Qwen Code configurado
+  para usar el proveedor Anthropic.
+- `bvsala` instalado y `BIVELIO_SERVICE_KEY` exportada (ver [README](README.md)).
+
+## Config de usuario: `~/.qwen/settings.json`
+
+El enrutado necesita dos cosas a la vez [V]: la variable de entorno
+`ANTHROPIC_BASE_URL` **y** que `~/.qwen/settings.json` seleccione el tipo
+Anthropic:
+
+```json
+{
+  "selectedType": "anthropic"
+}
+```
+
+Conserva el resto de tu `settings.json`; la clave verificada en S3 es
+`selectedType`. Sin ella, Qwen Code no lee `ANTHROPIC_BASE_URL` y el gateway no
+verá nada.
+
+## Envoltorio: `bvsala qwen`
+
+```bash
+export BIVELIO_SERVICE_KEY=bvk_…
+bvsala qwen
+```
+
+Espejo de `bvsala claude` con `ANTHROPIC_BASE_URL`. El envoltorio **no lee**
+`settings.json`: comprueba tú que `selectedType` sea `anthropic` (`bvsala
+doctor` te recuerda la ruta). La receta manual de abajo es lo mismo.
+
+## Manual: `ANTHROPIC_BASE_URL`
+
+```bash
+bvsala gateway                                         # ventana 1: http://127.0.0.1:8402
+ANTHROPIC_BASE_URL=http://127.0.0.1:8402 qwen          # ventana 2 — SIN /v1
+```
+
+Sin `/v1`: el SDK TS oficial de Anthropic añade `/v1/messages` [V]. Sin barra
+final.
+
+## Comprobar que funciona
+
+```
+[gateway] POST /v1/messages  · <modelo> · $0.001234 (in 120, cache↑0 cache↓0, out 8)
+```
+
+## La trampa típica
+
+1. **`/v1` en el base URL** → `[gateway] POST /v1/v1/messages → 404`.
+2. **`selectedType` no es `anthropic`** → el log del gateway no muestra nada:
+   Qwen Code está hablando con su proveedor por defecto, no contigo.
+3. **Modelos qwen (DashScope / ModelStudio)**: están **fuera del catálogo a
+   propósito** — `costeMedido → null`, passthrough con un aviso una vez
+   (`el modelo "…" no está en el catálogo de precios; su uso se reenvía pero no
+   se mide`). Coherente con la política del catálogo: presente-y-mal es peor que
+   ausente. Para medirlos harían falta precios **verificados** de
+   ModelStudio/DashScope en la fecha, y antes comprobar que DashScope emite SSE
+   con `\n\n` — el observador parte bloques solo por `\n\n`; un upstream que
+   emita `\r\n\r\n` jamás cerraría un bloque y no mediría nada aunque el precio
+   estuviera [I].
+
+## Nota BYOK
+
+**API key exclusivamente.** Anthropic prohíbe el OAuth de Claude Pro/Max en
+harnesses de terceros; Qwen Code es BYOK desde abr-2026 y esta receta también.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bivelio/savings-layer",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "BV-SALA — provider-neutral LLM execution optimizer. A decision layer in front of any LLM provider that cuts the cost of every request while preserving required quality, and reports the saving per call with token-level accounting you can check against your bill. Proprietary and confidential — property of BiVelio Inc.",
   "keywords": [
     "llm",
@@ -41,6 +41,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "docs/terminales",
     "README.md",
     "LICENSE"
   ],