@bivelio/savings-layer 0.5.2 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +138 -0
- package/LICENSE +183 -163
- package/LICENSE-CLOUD.md +174 -0
- package/NOTICE +11 -0
- package/README.md +228 -122
- package/dist/adapters/ai-sdk.js +78 -78
- package/dist/adapters/anthropic-sdk.js +88 -88
- package/dist/adapters/langchain.js +58 -58
- package/dist/adapters/mastra.js +70 -70
- package/dist/gateway/bin.js +1291 -1082
- package/dist/index.d.ts +393 -194
- package/dist/index.js +1704 -1612
- package/docs/terminales/README.md +39 -33
- package/docs/terminales/aider.md +1 -1
- package/docs/terminales/claude-code.md +2 -2
- package/docs/terminales/cline.md +1 -1
- package/docs/terminales/codex.md +3 -3
- package/docs/terminales/copilot.md +1 -1
- package/docs/terminales/crush.md +1 -1
- package/docs/terminales/cursor.md +32 -0
- package/docs/terminales/deepseek.md +28 -0
- package/docs/terminales/droid.md +1 -1
- package/docs/terminales/gemini.md +38 -0
- package/docs/terminales/goose.md +2 -2
- package/docs/terminales/kilo.md +2 -2
- package/docs/terminales/no-soportados.md +16 -27
- package/docs/terminales/ollama.md +19 -0
- package/docs/terminales/opencode.md +2 -2
- package/docs/terminales/qwen-code.md +2 -2
- package/package.json +50 -20
package/LICENSE-CLOUD.md
ADDED
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
BiVelio Inc. — BV-SALA Cloud Services Terms (LICENSE-CLOUD.md)
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 BiVelio Inc. All Rights Reserved.
|
|
4
|
+
|
|
5
|
+
IMPORTANT — READ BEFORE USE. The "@bivelio/savings-layer" package (BV-SALA) is
|
|
6
|
+
published under the Apache License, Version 2.0 (see LICENSE): the SDK, the local
|
|
7
|
+
gateway and the whole savings engine run without any key, in COMMUNITY mode, with
|
|
8
|
+
zero telemetry. These Cloud Services Terms (the "Agreement") govern only the
|
|
9
|
+
OPTIONAL paid cloud: the BiVelio dashboard, cloud metering, organization
|
|
10
|
+
entitlements, shared caches, license management and support (the "Cloud
|
|
11
|
+
Services"), which require an active BiVelio subscription and a valid license key
|
|
12
|
+
("License Key"). By configuring a BiVelio key, you agree to this Agreement. If
|
|
13
|
+
you do not agree, do not configure a key; the open-source package keeps working
|
|
14
|
+
without one.
|
|
15
|
+
|
|
16
|
+
1. CLOUD SERVICES LICENSE GRANT. Subject to your continuous compliance with this
|
|
17
|
+
Agreement and to an active BiVelio subscription (paid, or granted by BiVelio at
|
|
18
|
+
no charge, for example through a promotional code, a pilot, or the free Measure
|
|
19
|
+
license) with a valid License Key, BiVelio grants you a limited, non-exclusive,
|
|
20
|
+
non-transferable, non-sublicensable, revocable license to use the Cloud
|
|
21
|
+
Services, as published, solely for your own internal business purposes, and only
|
|
22
|
+
for the number of seats covered by your subscription. The Cloud Services are
|
|
23
|
+
licensed, not sold. Under a Measure license the Cloud Services run in shadow
|
|
24
|
+
mode only: nothing is optimized, nothing is served from cache, and the
|
|
25
|
+
dashboard shows estimated savings that are never billed.
|
|
26
|
+
|
|
27
|
+
2. LICENSE KEY; FAIL-CLOSED CLOUD. The Cloud Services require a valid, active
|
|
28
|
+
License Key. Expiry, non-payment, revocation, suspension, or termination of your
|
|
29
|
+
subscription immediately ends the license granted in Section 1 and closes the
|
|
30
|
+
Cloud Services. The open-source package (Apache-2.0) does not need a key and
|
|
31
|
+
keeps working in COMMUNITY mode without one; if you DO configure a key and it is
|
|
32
|
+
invalid, expired or revoked, the package fails closed with a LicenseError until
|
|
33
|
+
you fix or unset it. You will not circumvent, disable, remove, or tamper with the
|
|
34
|
+
Cloud Services' licensing, metering, or revocation mechanisms, nor use the Cloud
|
|
35
|
+
Services after your license has ended.
|
|
36
|
+
|
|
37
|
+
3. RESTRICTIONS. Except as expressly permitted above, you will not: (a) distribute,
|
|
38
|
+
publish, resell, rent, lease, lend, offer as a hosted or managed service, or
|
|
39
|
+
otherwise make the Cloud Services available to any third party; (b) sublicense,
|
|
40
|
+
assign, or transfer your rights; (c) use the Cloud Services for more seats than
|
|
41
|
+
your subscription covers, or share a License Key across more machines or service
|
|
42
|
+
identities than it covers; (d) remove, alter, or obscure any proprietary or
|
|
43
|
+
copyright notice; (e) reverse engineer, decompile, or disassemble the Cloud
|
|
44
|
+
Services, except to the limited extent applicable law expressly permits
|
|
45
|
+
notwithstanding this restriction; or (f) use the Cloud Services to develop,
|
|
46
|
+
train, or improve a product or service that competes with the Cloud Services.
|
|
47
|
+
Nothing in this Agreement restricts what the Apache License 2.0 permits for the
|
|
48
|
+
open-source package itself.
|
|
49
|
+
|
|
50
|
+
4. OWNERSHIP. The Cloud Services are the exclusive property of BiVelio and its
|
|
51
|
+
licensors and embody valuable proprietary information and trade secrets. BiVelio
|
|
52
|
+
retains all right, title, and interest in and to the Cloud Services and all
|
|
53
|
+
intellectual property rights therein. No rights are granted to you except as
|
|
54
|
+
expressly set out in this Agreement, whether by implication, estoppel, or
|
|
55
|
+
otherwise.
|
|
56
|
+
|
|
57
|
+
5. YOUR DATA; PRIVACY.
|
|
58
|
+
(a) What the Software never sends to BiVelio. The Software never transmits to
|
|
59
|
+
BiVelio the content of your requests or responses (including prompts, system
|
|
60
|
+
instructions, messages, tool definitions, tool arguments and results, retrieved
|
|
61
|
+
documents, and completions) or the credentials you use with your LLM provider
|
|
62
|
+
(API keys, OAuth tokens, or other authorization headers). That content and those
|
|
63
|
+
credentials travel only between your systems and the LLM provider you configure.
|
|
64
|
+
(b) What the Software sends to BiVelio. The SDK contacts BiVelio only when you
|
|
65
|
+
configure a license server or metering URL; the local gateway does only when you
|
|
66
|
+
configure a service-account key — with no BiVelio keys configured, nothing is
|
|
67
|
+
sent to BiVelio (COMMUNITY mode). With a
|
|
68
|
+
BiVelio service-account key, the Software sends BiVelio's control plane usage
|
|
69
|
+
records for the requests it meters, each limited to:
|
|
70
|
+
(i) identifiers: a request identifier generated on your side (at random, or by
|
|
71
|
+
your own generator); for a repeated request valued by reference, the
|
|
72
|
+
identifier and timestamp of the earlier request whose provider counter is
|
|
73
|
+
used; a seat identifier, which is either a value you set or an opaque value
|
|
74
|
+
computed on your machine as a keyed hash (HMAC-SHA-256 wherever the
|
|
75
|
+
runtime provides it), keyed with your service-account key, of the
|
|
76
|
+
platform, CPU architecture, runtime executable path, host name,
|
|
77
|
+
operating-system user name, and home directory (those underlying values
|
|
78
|
+
are never sent); for traffic through the local gateway,
|
|
79
|
+
the session and sub-agent identifiers that your coding agent attaches to
|
|
80
|
+
its own requests (for example, Claude Code's session id), only when they
|
|
81
|
+
are plain identifiers; an organization hint; and a flag marking CI or
|
|
82
|
+
ephemeral runners;
|
|
83
|
+
(ii) the identifier of the model that served the request (the model named in
|
|
84
|
+
the request or, where the Software sent the request to another model under
|
|
85
|
+
a setting you enabled, that model; for a self-hosted or Azure deployment,
|
|
86
|
+
the name you gave it) and the time of the request;
|
|
87
|
+
(iii) counts: LLM calls executed and avoided; input and output tokens before
|
|
88
|
+
and after the Software's optimizations, including tokens removed,
|
|
89
|
+
compressed, or read from the provider's cache; and the cache outcome; and
|
|
90
|
+
(iv) cost figures computed by the Software from its price catalogue (or from
|
|
91
|
+
a cost model you supply): baseline cost, actual cost, the net-saving
|
|
92
|
+
ratio, the basis of the figures (measured, reference, estimated, shadow,
|
|
93
|
+
or unmeasured), the value, at the provider's cache-read price, of
|
|
94
|
+
input tokens your provider reported as cleared from context, and the
|
|
95
|
+
discount your provider's own prompt cache gave the request and the
|
|
96
|
+
cache-write premium it billed, which are shown apart and never used to
|
|
97
|
+
calculate the fees in Section 6.
|
|
98
|
+
Each batch of records also carries the Software's surface and version (for
|
|
99
|
+
example, "gateway/0.4.23"). BiVelio's ingest rejects any record that carries a
|
|
100
|
+
field not listed above. Separately, the Software fetches from BiVelio its current
|
|
101
|
+
license token, the signed license revocation list and, for the gateway, your
|
|
102
|
+
organization's feature entitlements; these requests carry your service-account
|
|
103
|
+
key where authentication is required, and no request data. Like any HTTPS
|
|
104
|
+
request, all of the above also reveals ordinary network metadata, such as your
|
|
105
|
+
IP address. If you enable the SDK's optional verification, which is off by
|
|
106
|
+
default, the SDK also sends BiVelio, through a separate channel and for each
|
|
107
|
+
request it samples: a label marking the record as a verification sample; the
|
|
108
|
+
request identifier and time; the model requested and the model that served it;
|
|
109
|
+
the cache outcome; the category of the request and the outcome of the check;
|
|
110
|
+
the input, cached-input, and output token counts and the cost of the served
|
|
111
|
+
request and of the unoptimized copy the SDK sent to your LLM provider; how
|
|
112
|
+
that copy finished and whether it met the response contract; and the per-token
|
|
113
|
+
prices applied; together with daily counts of requests per category and a
|
|
114
|
+
random batch identifier. That channel likewise rejects any field not listed
|
|
115
|
+
here, and none of it is used to calculate the fees in Section 6.
|
|
116
|
+
(c) BiVelio uses this data to operate licensing and revocation, show your
|
|
117
|
+
dashboard, count billable seats, and calculate the fees in Section 6. Each
|
|
118
|
+
field, and how long BiVelio keeps it, is further described at
|
|
119
|
+
https://savings.bivelio.com/privacy.
|
|
120
|
+
|
|
121
|
+
6. FEES. Your subscription is subject to BiVelio's pricing as published at
|
|
122
|
+
https://savings.bivelio.com/pricing (the "Published Pricing") for each billing
|
|
123
|
+
period:
|
|
124
|
+
(a) a subscription fee, per seat or for a plan that includes a number of seats,
|
|
125
|
+
payable whether or not the Software produces any saving; and (b) only if your
|
|
126
|
+
subscription is on a plan that the Published Pricing lists as carrying a
|
|
127
|
+
commission, a commission, at tiered marginal rates, charged only on measured
|
|
128
|
+
savings, meaning savings whose basis is labelled "measured" or "reference" in
|
|
129
|
+
your usage records (Section 5(b)(iv)). A "measured" saving is established from
|
|
130
|
+
your LLM provider's own usage counter for that request; a "reference" saving, for
|
|
131
|
+
a repeated request the Software served without calling your provider, from your
|
|
132
|
+
provider's counter for the identical earlier request that did run. Both are
|
|
133
|
+
valued at the per-token prices the Software applied to that request: those of a
|
|
134
|
+
cost model you configure, where you configure one, and otherwise your provider's
|
|
135
|
+
list prices in the price catalogue included in the Software. Savings labelled
|
|
136
|
+
"estimated", "shadow", or "unmeasured" never carry commission. Traffic the
|
|
137
|
+
Software identifies as a flat-rate provider subscription (a Claude or ChatGPT
|
|
138
|
+
subscription used through the local gateway) is metered but credited no measured
|
|
139
|
+
saving, so it carries no commission. A period with no measured savings carries no
|
|
140
|
+
commission. The first calendar month (UTC) in which your organization reports any
|
|
141
|
+
usage is a calibration period, however little of that month remains, and carries
|
|
142
|
+
no commission. Nor is commission charged for a period that BiVelio closes while
|
|
143
|
+
your account is exempt from it. Your account is exempt if BiVelio grants it an
|
|
144
|
+
exemption and, until a payment is made on the account, if its subscription was
|
|
145
|
+
activated with a promotional code that waives the subscription fee in full for
|
|
146
|
+
its entire term. For a calibration or exempt period the statement still shows the
|
|
147
|
+
commission that would have applied. Each period's commission is
|
|
148
|
+
itemized on a statement in your dashboard, together with the exchange rate
|
|
149
|
+
applied. Rates, tier thresholds, and currency are those of the Published Pricing
|
|
150
|
+
and are not restated here.
|
|
151
|
+
|
|
152
|
+
7. TERM AND TERMINATION. This Agreement remains in effect while your subscription is
|
|
153
|
+
active. BiVelio may terminate this Agreement immediately if you breach it. Upon
|
|
154
|
+
expiry or termination you must cease all use of the Cloud Services and destroy
|
|
155
|
+
your copies. Sections 2 through 10 survive termination.
|
|
156
|
+
|
|
157
|
+
8. DISCLAIMER OF WARRANTY. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
|
|
158
|
+
KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
159
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
|
|
160
|
+
|
|
161
|
+
9. LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL
|
|
162
|
+
BIVELIO INC. BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR
|
|
163
|
+
EXEMPLARY DAMAGES, OR FOR ANY LOSS OF PROFITS, REVENUE, OR DATA, ARISING FROM OR
|
|
164
|
+
RELATED TO THE SOFTWARE OR THIS AGREEMENT. BIVELIO'S TOTAL LIABILITY SHALL NOT
|
|
165
|
+
EXCEED THE FEES YOU PAID FOR THE SOFTWARE IN THE TWELVE MONTHS PRECEDING THE CLAIM.
|
|
166
|
+
|
|
167
|
+
10. GENERAL. This Agreement is governed by the laws of the State of Delaware, USA,
|
|
168
|
+
without regard to its conflict-of-laws rules. If any provision is held
|
|
169
|
+
unenforceable, the remaining provisions remain in effect. This Agreement, together
|
|
170
|
+
with the applicable BiVelio subscription terms, constitutes the entire agreement
|
|
171
|
+
between you and BiVelio regarding the Software. Unauthorized use, reproduction, or
|
|
172
|
+
distribution of the Software may result in civil and criminal penalties.
|
|
173
|
+
|
|
174
|
+
For licensing and compliance inquiries, contact: BiVelio Inc. — privacy@bivelio.com
|
package/NOTICE
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
BiVelio Savings Layer (BV-SALA)
|
|
2
|
+
Copyright 2026 BiVelio Inc.
|
|
3
|
+
|
|
4
|
+
This product is published under the Apache License, Version 2.0 (LICENSE).
|
|
5
|
+
|
|
6
|
+
The optional BiVelio cloud services (dashboard, metering, organization
|
|
7
|
+
entitlements, shared caches, license management) are governed by the separate
|
|
8
|
+
BiVelio Cloud Services Terms (LICENSE-CLOUD.md). The "BiVelio", "Savings" and
|
|
9
|
+
BV-SALA names and logos are trademarks of BiVelio Inc.; the Apache License does
|
|
10
|
+
not grant any right to use them except as permitted by applicable law and the
|
|
11
|
+
license itself.
|