@openllmsh/sdk 0.0.0-stage → 2.10.12-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (245) hide show
  1. package/ARCHITECTURE.md +43 -0
  2. package/LICENSE +202 -0
  3. package/README.md +142 -2
  4. package/assets/openllm-light.svg +18 -0
  5. package/assets/openllm.svg +18 -0
  6. package/client/chat.ts +140 -0
  7. package/client/devices.ts +269 -0
  8. package/client/http.ts +72 -0
  9. package/client/index.ts +129 -0
  10. package/client/relay-mux.ts +547 -0
  11. package/client/types.ts +51 -0
  12. package/client/vault.ts +239 -0
  13. package/connect/chat.ts +58 -0
  14. package/connect/client.ts +240 -0
  15. package/connect/config.ts +47 -0
  16. package/connect/errors.ts +121 -0
  17. package/connect/index.ts +23 -0
  18. package/connect/oauth.ts +265 -0
  19. package/connect/routes.ts +234 -0
  20. package/connect/store.ts +107 -0
  21. package/mcp/handle.ts +24 -0
  22. package/mcp/index.ts +76 -0
  23. package/mcp/server.ts +319 -0
  24. package/mcp/tools/marketplace.ts +439 -0
  25. package/mcp/tools/memory-client.ts +297 -0
  26. package/mcp/tools/memory-config.ts +32 -0
  27. package/mcp/tools/memory.ts +369 -0
  28. package/mcp/tools/model-priority.ts +88 -0
  29. package/mcp/tools/openllm.ts +883 -0
  30. package/mcp/types.ts +28 -0
  31. package/openapi/call.ts +90 -0
  32. package/openapi/index.ts +8 -0
  33. package/openapi/openapi.json +80213 -0
  34. package/openapi/operations.ts +2075 -0
  35. package/package.json +39 -4
  36. package/protocol/CONTRIBUTING.md +21 -0
  37. package/protocol/README.md +134 -0
  38. package/protocol/access.ts +186 -0
  39. package/protocol/agent-prompt-text.ts +32 -0
  40. package/protocol/agent.ts +991 -0
  41. package/protocol/api-key-syntax.ts +105 -0
  42. package/protocol/assets/openllm-light.svg +18 -0
  43. package/protocol/assets/openllm.svg +18 -0
  44. package/protocol/audio.ts +29 -0
  45. package/protocol/auth.ts +142 -0
  46. package/protocol/changelog.ts +155 -0
  47. package/protocol/chat.ts +458 -0
  48. package/protocol/client-registry.ts +356 -0
  49. package/protocol/config.ts +345 -0
  50. package/protocol/control-channel.ts +115 -0
  51. package/protocol/cooldown-reason.ts +78 -0
  52. package/protocol/cost.ts +10 -0
  53. package/protocol/daemon-port.ts +31 -0
  54. package/protocol/daemon.ts +1524 -0
  55. package/protocol/default-chains.ts +66 -0
  56. package/protocol/device-state.ts +85 -0
  57. package/protocol/doctor-report-local.ts +443 -0
  58. package/protocol/doctor-report-policy.ts +119 -0
  59. package/protocol/doctor-report.ts +947 -0
  60. package/protocol/errors.ts +14 -0
  61. package/protocol/execution-selection.ts +141 -0
  62. package/protocol/hop-grant.ts +33 -0
  63. package/protocol/image-edit-parse.ts +263 -0
  64. package/protocol/images.ts +298 -0
  65. package/protocol/index.ts +74 -0
  66. package/protocol/inference-headers.ts +3 -0
  67. package/protocol/keepalive.ts +69 -0
  68. package/protocol/local-auth.ts +300 -0
  69. package/protocol/local-device-control.ts +133 -0
  70. package/protocol/local-provider.ts +288 -0
  71. package/protocol/local-session.ts +118 -0
  72. package/protocol/marketplace.ts +187 -0
  73. package/protocol/media-attempt.ts +81 -0
  74. package/protocol/media-bytes.ts +28 -0
  75. package/protocol/media-default.ts +357 -0
  76. package/protocol/media-dimensions.ts +132 -0
  77. package/protocol/media-input.ts +61 -0
  78. package/protocol/media-model.ts +142 -0
  79. package/protocol/media-option-issue.ts +90 -0
  80. package/protocol/media-types.ts +70 -0
  81. package/protocol/model-match.ts +1051 -0
  82. package/protocol/model-settings.ts +327 -0
  83. package/protocol/models.ts +767 -0
  84. package/protocol/mux.ts +722 -0
  85. package/protocol/plan-surface.ts +59 -0
  86. package/protocol/provider-models.ts +16 -0
  87. package/protocol/provider-status.ts +206 -0
  88. package/protocol/provider-tier.ts +67 -0
  89. package/protocol/provider-usage.ts +263 -0
  90. package/protocol/providers.ts +901 -0
  91. package/protocol/public-usage-index.ts +354 -0
  92. package/protocol/realtime-generated.ts +31 -0
  93. package/protocol/realtime.ts +324 -0
  94. package/protocol/registry-pointer.ts +118 -0
  95. package/protocol/relay.ts +702 -0
  96. package/protocol/replay-session.ts +11 -0
  97. package/protocol/responses.ts +280 -0
  98. package/protocol/semver.ts +182 -0
  99. package/protocol/setup-mode.ts +22 -0
  100. package/protocol/sha256-hex.ts +98 -0
  101. package/protocol/stats.ts +406 -0
  102. package/protocol/streaming.ts +19 -0
  103. package/protocol/subscription-daemon-floors.ts +33 -0
  104. package/protocol/subscription-provider-compat.ts +104 -0
  105. package/protocol/subscription-provider.ts +32 -0
  106. package/protocol/team-grant.ts +17 -0
  107. package/protocol/team-shareable.ts +61 -0
  108. package/protocol/transcription-encoding.ts +76 -0
  109. package/protocol/url-locality-dns.ts +37 -0
  110. package/protocol/url-locality.ts +288 -0
  111. package/protocol/usage-snapshots.ts +9 -0
  112. package/protocol/vendor-cli-install.ts +29 -0
  113. package/protocol/video-job-plan.ts +50 -0
  114. package/protocol/videos.ts +227 -0
  115. package/tsconfig.json +14 -0
  116. package/tunnel/ARCHITECTURE.md +111 -0
  117. package/tunnel/LICENSE +33 -0
  118. package/tunnel/README.md +45 -0
  119. package/tunnel/assets/openllm-light.svg +18 -0
  120. package/tunnel/assets/openllm.svg +18 -0
  121. package/tunnel/channel-envelope.ts +139 -0
  122. package/tunnel/codec.ts +191 -0
  123. package/tunnel/device-anchor.ts +229 -0
  124. package/tunnel/device-control.ts +118 -0
  125. package/tunnel/device-grant.ts +173 -0
  126. package/tunnel/fleet.ts +77 -0
  127. package/tunnel/index.ts +22 -0
  128. package/tunnel/mux.ts +580 -0
  129. package/tunnel/peer-link.ts +390 -0
  130. package/tunnel/rtc-auth.ts +415 -0
  131. package/tunnel/rtc-duplex.ts +187 -0
  132. package/tunnel/rtc-ice.ts +136 -0
  133. package/tunnel/secure.ts +1298 -0
  134. package/tunnel/stream-reset-error.ts +14 -0
  135. package/tunnel/streams.ts +1430 -0
  136. package/tunnel/team-grant.ts +302 -0
  137. package/tunnel/wire-bytes.ts +102 -0
  138. package/vault/ARCHITECTURE.md +470 -0
  139. package/vault/LICENSE +33 -0
  140. package/vault/api-key.ts +190 -0
  141. package/vault/argon2.ts +106 -0
  142. package/vault/cli-auth-seal.ts +157 -0
  143. package/vault/cred-seal.ts +146 -0
  144. package/vault/credential.ts +55 -0
  145. package/vault/crypto.ts +210 -0
  146. package/vault/daemon-attest.ts +229 -0
  147. package/vault/derive.ts +113 -0
  148. package/vault/device-access.ts +87 -0
  149. package/vault/device-anchor.ts +185 -0
  150. package/vault/device-control.ts +174 -0
  151. package/vault/handoff.ts +396 -0
  152. package/vault/index.ts +21 -0
  153. package/vault/passkey.ts +243 -0
  154. package/vault/phrase.ts +65 -0
  155. package/vault/pin.ts +153 -0
  156. package/vault/public-key-seal.ts +131 -0
  157. package/vault/seed.ts +272 -0
  158. package/vault/team.ts +355 -0
  159. package/vault/vault-item.ts +131 -0
  160. package/vault/vault-migrate-digest.ts +29 -0
  161. package/vault/wrapped.ts +77 -0
  162. package/wire/ARCHITECTURE.md +90 -0
  163. package/wire/CONTRIBUTING.md +19 -0
  164. package/wire/LICENSE +33 -0
  165. package/wire/README.md +51 -0
  166. package/wire/adapters/messages/anthropic-map.ts +37 -0
  167. package/wire/adapters/messages/index.ts +7 -0
  168. package/wire/adapters/messages/reasoning-from-items.ts +38 -0
  169. package/wire/adapters/messages/reasoning-signature.ts +243 -0
  170. package/wire/adapters/messages/request.ts +574 -0
  171. package/wire/adapters/messages/response.ts +215 -0
  172. package/wire/adapters/messages/streaming.ts +1027 -0
  173. package/wire/adapters/messages/usage.ts +43 -0
  174. package/wire/adapters/responses/index.ts +3 -0
  175. package/wire/adapters/responses/request.ts +395 -0
  176. package/wire/adapters/responses/response.ts +88 -0
  177. package/wire/adapters/responses/streaming.ts +344 -0
  178. package/wire/assets/openllm-light.svg +18 -0
  179. package/wire/assets/openllm.svg +18 -0
  180. package/wire/features/account-rank.ts +166 -0
  181. package/wire/features/compaction/compact-request.ts +862 -0
  182. package/wire/features/compaction/compaction-text.ts +43 -0
  183. package/wire/features/context-demote.ts +47 -0
  184. package/wire/features/context-overflow-strategy.ts +26 -0
  185. package/wire/features/context-skip.ts +170 -0
  186. package/wire/features/conversation-affinity.ts +144 -0
  187. package/wire/features/max-tokens-backfill.ts +141 -0
  188. package/wire/features/model-caps.ts +53 -0
  189. package/wire/features/model-settings.ts +24 -0
  190. package/wire/features/output-limit-clamp.ts +64 -0
  191. package/wire/features/quota-gate.ts +85 -0
  192. package/wire/index.ts +44 -0
  193. package/wire/lib/attempt-outcome.ts +43 -0
  194. package/wire/lib/canonical/content-part.ts +38 -0
  195. package/wire/lib/canonical/count-tokens-capability.ts +138 -0
  196. package/wire/lib/canonical/encoding-select.ts +82 -0
  197. package/wire/lib/canonical/image-signature.ts +202 -0
  198. package/wire/lib/canonical/image-sse.ts +216 -0
  199. package/wire/lib/canonical/message.ts +43 -0
  200. package/wire/lib/canonical/token-estimate.ts +266 -0
  201. package/wire/lib/encrypted-content.ts +66 -0
  202. package/wire/lib/error-class.ts +154 -0
  203. package/wire/lib/error-envelope.ts +56 -0
  204. package/wire/lib/forwarded-headers.ts +180 -0
  205. package/wire/lib/provider-error-rules.ts +48 -0
  206. package/wire/lib/refusal.ts +38 -0
  207. package/wire/lib/responses-apply-patch.ts +104 -0
  208. package/wire/lib/responses-namespace.ts +53 -0
  209. package/wire/lib/secret-scrub.ts +101 -0
  210. package/wire/lib/streaming/accumulate.ts +221 -0
  211. package/wire/lib/streaming/finish-reason.ts +33 -0
  212. package/wire/lib/streaming/peek.ts +154 -0
  213. package/wire/lib/streaming/provider-decode.ts +259 -0
  214. package/wire/lib/streaming/response-stream.ts +71 -0
  215. package/wire/lib/streaming/sse.ts +699 -0
  216. package/wire/lib/streaming/strip-tool-calls.ts +95 -0
  217. package/wire/lib/streaming/upstream-error.ts +58 -0
  218. package/wire/lib/strip-subagent-isolation.ts +284 -0
  219. package/wire/lib/thinking-signature.ts +156 -0
  220. package/wire/lib/token-ruler/bpe-core.ts +426 -0
  221. package/wire/lib/token-ruler/index.ts +2 -0
  222. package/wire/lib/token-ruler/ruler.ts +79 -0
  223. package/wire/lib/token-ruler/vocab/claude-ranks.ts +16 -0
  224. package/wire/lib/token-ruler/vocab/claude.ts +22 -0
  225. package/wire/lib/token-ruler/vocab/o200k-ranks.ts +18 -0
  226. package/wire/lib/token-ruler/vocab/o200k.ts +19 -0
  227. package/wire/lib/tool-name-map.ts +271 -0
  228. package/wire/lib/tool-schema.ts +353 -0
  229. package/wire/lib/usage-observer.ts +125 -0
  230. package/wire/providers/anthropic/adaptive-thinking.ts +291 -0
  231. package/wire/providers/anthropic/beta-headers.ts +165 -0
  232. package/wire/providers/anthropic/index.ts +10 -0
  233. package/wire/providers/anthropic/request.ts +607 -0
  234. package/wire/providers/anthropic/response.ts +155 -0
  235. package/wire/providers/anthropic/streaming.ts +315 -0
  236. package/wire/providers/anthropic/web-search-domains.ts +49 -0
  237. package/wire/providers/chatgpt/common.ts +136 -0
  238. package/wire/providers/chatgpt/index.ts +9 -0
  239. package/wire/providers/chatgpt/request.ts +959 -0
  240. package/wire/providers/chatgpt/streaming.ts +1007 -0
  241. package/wire/providers/chatgpt/web-search.ts +63 -0
  242. package/wire/providers/grok/web-search.ts +87 -0
  243. package/wire/providers/kimi/web-search.ts +145 -0
  244. package/wire/providers/upstream-deny.ts +355 -0
  245. package/wire/providers/upstream-request.ts +619 -0
@@ -0,0 +1,406 @@
1
+ import { Schema as S } from "effect";
2
+
3
+ export const RequestStatus = S.Literals([
4
+ "success",
5
+ "error",
6
+ "timeout",
7
+ "rate_limited",
8
+ ]);
9
+ export type TRequestStatus = S.Schema.Type<typeof RequestStatus>;
10
+
11
+ export const RequestRow = S.Struct({
12
+ id: S.String,
13
+ user_id: S.String,
14
+ key_id: S.String,
15
+ model: S.String,
16
+ provider: S.String,
17
+ /** Canonical prompt tokens — INCLUDES the two cache columns below. */
18
+ tokens_in: S.Number,
19
+ tokens_out: S.Number,
20
+ /**
21
+ * Cache split of `tokens_in`. Kept so a row can be re-priced at the cache
22
+ * rates (`cache_read_per_million` / `cache_write_per_million`) rather than
23
+ * the full input rate — see `priceSubscriptionUsage` in `handlers/stats.ts`.
24
+ * Rows written before these columns existed carry 0.
25
+ */
26
+ cached_tokens: S.Number,
27
+ cache_creation_tokens: S.Number,
28
+ cost_usd: S.Number,
29
+ latency_ms: S.Number,
30
+ status: RequestStatus,
31
+ error: S.NullOr(S.String),
32
+ idempotency_key: S.NullOr(S.String),
33
+ ts: S.String,
34
+ /**
35
+ * Teams attribution (docs/plan/2026-10-26-teams.md §5 / §14 phase 5).
36
+ * Nullable — personal hops omit both. No FK: deleting a team must not
37
+ * rewrite history.
38
+ */
39
+ team_id: S.NullOr(S.String),
40
+ served_by_user_id: S.NullOr(S.String),
41
+ });
42
+ export type TRequestRow = S.Schema.Type<typeof RequestRow>;
43
+
44
+ export const ModelBreakdown = S.Struct({
45
+ model: S.String,
46
+ provider: S.String,
47
+ requests: S.Number,
48
+ tokens_in: S.Number,
49
+ tokens_out: S.Number,
50
+ cost_usd: S.Number,
51
+ });
52
+ export type TModelBreakdown = S.Schema.Type<typeof ModelBreakdown>;
53
+
54
+ export const DailyBucket = S.Struct({
55
+ day: S.String,
56
+ requests: S.Number,
57
+ tokens_in: S.Number,
58
+ tokens_out: S.Number,
59
+ cost_usd: S.Number,
60
+ });
61
+ export type TDailyBucket = S.Schema.Type<typeof DailyBucket>;
62
+
63
+ /**
64
+ * All-device subscription usage INFERRED from the vendor quota meter, per
65
+ * provider — the calibration estimator's output (docs/proposals/
66
+ * inferred-subscription-usage-calibration.md). Every dollar figure is a
67
+ * LOWER bound by construction (censored one-sided estimator), so the UI
68
+ * may present them as "≥ $X"; `tightness` near 1 means the estimate has
69
+ * converged and can read as "≈".
70
+ */
71
+ export const InferredWindowUsage = S.Struct({
72
+ window_label: S.String,
73
+ percent_used: S.Number,
74
+ used_usd: S.Number,
75
+ headroom_usd: S.Number,
76
+ bracket_usd: S.Number,
77
+ });
78
+ export type TInferredWindowUsage = S.Schema.Type<typeof InferredWindowUsage>;
79
+
80
+ /**
81
+ * THE uniform usage index — every provider reduces to this one 30-day
82
+ * forecast, no matter how the vendor meters (Claude's 5h/7d, Codex's
83
+ * weekly, Kimi's daily, Grok's monthly). It is scoped to ONE window chunk
84
+ * — the most recent POPULATED window of the largest live calibrated series
85
+ * (the closest earlier populated window stands in when the current one is
86
+ * still empty) — and never an integral over past windows or a sum of
87
+ * exceptional grants:
88
+ *
89
+ * - `used_usd` — that window's own API-eq usage, scaled to 30 days by
90
+ * 30d / the resolved NOMINAL window duration, across all
91
+ * devices.
92
+ * - `bracket_usd` — that window's bracket, scaled by the same factor.
93
+ * Nominal duration is stated vendor duration first, then
94
+ * a known window label, otherwise the conservative
95
+ * maximum of 30 days and observed remaining horizons —
96
+ * never an adjacent reset-deadline difference alone.
97
+ * Guarantees used ≤ bracket (same positive scale on both).
98
+ * - `headroom_usd` — max(0, bracket − used).
99
+ *
100
+ * Methodology `account-owned-v2` (see `PROVIDER_TIER_METHODOLOGY_VERSION`):
101
+ * recurring capacity estimated from the selected window. A one-off early
102
+ * reset is still detected for epoch continuity, but does not shorten the
103
+ * recurring 30-day projection. Historical `account-owned-v1` cache/public
104
+ * rows stay stored and are unread as current until on-demand regeneration.
105
+ */
106
+ export const InferredMonthlyIndex = S.Struct({
107
+ used_usd: S.Number,
108
+ headroom_usd: S.Number,
109
+ bracket_usd: S.Number,
110
+ });
111
+ export type TInferredMonthlyIndex = S.Schema.Type<typeof InferredMonthlyIndex>;
112
+
113
+ /**
114
+ * One vendor ACCOUNT's inferred figures — the per-account detail behind a
115
+ * provider's rollup when several accounts are calibrated at once (two
116
+ * machines on two logins). Note an account's figures are ACCOUNT-level:
117
+ * every openllm user linked to the same vendor account sees the same
118
+ * numbers — that is by design, not double counting to be "fixed" (the
119
+ * meter is the account's).
120
+ */
121
+ /**
122
+ * One persistent (provider, account, plan) bucket's inferred figures.
123
+ * Reused under a single-account provider payload and under each
124
+ * `accounts[]` entry — never by duplicating `accounts[]` per tier.
125
+ *
126
+ * `current_window` / `monthly_index` are live only for the ACTIVE visit
127
+ * of this plan; inactive visits keep historical `off_gateway_usd` and
128
+ * leave those fields null.
129
+ */
130
+ export const InferredTierUsage = S.Struct({
131
+ /** Trimmed upstream plan (`pro`, `prolite`, …). Null = unclassified. */
132
+ plan: S.NullOr(S.String),
133
+ off_gateway_usd: S.Number,
134
+ current_window: S.NullOr(InferredWindowUsage),
135
+ monthly_index: S.NullOr(InferredMonthlyIndex),
136
+ pair_count: S.Number,
137
+ tightness: S.Number,
138
+ });
139
+ export type TInferredTierUsage = S.Schema.Type<typeof InferredTierUsage>;
140
+
141
+ export const InferredAccountUsage = S.Struct({
142
+ /** Obscured account identity (`sha256("openllm-account-v1:…")`), or null
143
+ * for the legacy assumed-single-account series. */
144
+ account_hash: S.NullOr(S.String),
145
+ /**
146
+ * Active plan for live capacity (latest unambiguous observation, or the
147
+ * caller-supplied selection). Null when the latest samples conflict or
148
+ * the plan is unknown. Top-level window/index/pairs/tightness describe
149
+ * this plan only.
150
+ */
151
+ plan: S.optional(S.NullOr(S.String)),
152
+ off_gateway_usd: S.Number,
153
+ current_window: S.NullOr(InferredWindowUsage),
154
+ /** The uniform 30-day forecast for this account. NULL until a LIVE
155
+ * window series is calibrated (cold start / just after a vendor
156
+ * window reshape). */
157
+ monthly_index: S.NullOr(InferredMonthlyIndex),
158
+ pair_count: S.Number,
159
+ tightness: S.Number,
160
+ /** Per-plan buckets for this account. Absent when only the active
161
+ * unclassified series exists (legacy no-plan callers). */
162
+ tiers: S.optional(S.Array(InferredTierUsage)),
163
+ });
164
+ export type TInferredAccountUsage = S.Schema.Type<typeof InferredAccountUsage>;
165
+
166
+ export const InferredProviderUsage = S.Struct({
167
+ provider: S.String,
168
+ /** For a SINGLE-account provider, that account's obscured hash — the
169
+ * top-level figures are its own. Absent (undefined) when several accounts
170
+ * are calibrated; read `accounts[].account_hash` instead. */
171
+ account_hash: S.optional(S.NullOr(S.String)),
172
+ /** API-eq value of 30-day usage the gateway never saw (other devices /
173
+ * raw CLI / vendor apps). Lower bound; with several accounts, the sum
174
+ * of their independent lower bounds. */
175
+ off_gateway_usd: S.Number,
176
+ /** The in-progress window's figures, when a calibrated series has a
177
+ * current reading — drives the providers-page headroom line. NULL when
178
+ * several accounts are calibrated (each has its own in-progress window;
179
+ * read `accounts` instead). */
180
+ current_window: S.NullOr(InferredWindowUsage),
181
+ /** The uniform 30-day forecast — forecasts sum soundly, so with several
182
+ * accounts this is the SUM of their forecasts (unlike `current_window`,
183
+ * which goes null). NULL when no account has a live calibrated series
184
+ * yet. */
185
+ monthly_index: S.NullOr(InferredMonthlyIndex),
186
+ /** Valid calibration pairs behind K̂ — 0 pairs never reaches here. With
187
+ * several accounts: the SUM across accounts (evidence volume). */
188
+ pair_count: S.Number,
189
+ /** 0–1; ≥ ~0.8 reads as converged ("≈" instead of "≥"). With several
190
+ * accounts: the MIN across accounts, so the conservative "≥" rendering
191
+ * wins whenever any account is still loose. */
192
+ tightness: S.Number,
193
+ /**
194
+ * Active plan when this payload is a SINGLE account. Absent when several
195
+ * accounts are calibrated — read `accounts[].plan` instead.
196
+ */
197
+ plan: S.optional(S.NullOr(S.String)),
198
+ /** Per-account detail, present only when ≥2 accounts calibrated for this
199
+ * provider. Absent in the single-account case — the top-level fields
200
+ * ARE that account's. Never one entry per tier of the same account. */
201
+ accounts: S.optional(S.Array(InferredAccountUsage)),
202
+ /** Per-plan buckets when this payload is a SINGLE account. Absent when
203
+ * several accounts are calibrated — read `accounts[].tiers` instead. */
204
+ tiers: S.optional(S.Array(InferredTierUsage)),
205
+ });
206
+ export type TInferredProviderUsage = S.Schema.Type<
207
+ typeof InferredProviderUsage
208
+ >;
209
+
210
+ export const UserStats = S.Struct({
211
+ total_requests: S.Number,
212
+ /** Inclusive input: uncached prompt + cache read + cache write. */
213
+ total_tokens_in: S.Number,
214
+ total_tokens_out: S.Number,
215
+ /** Reported cache-read subset of total_tokens_in; legacy rows carry 0. */
216
+ total_cached_tokens: S.Number,
217
+ /** Reported cache-write subset of total_tokens_in; legacy rows carry 0. */
218
+ total_cache_creation_tokens: S.Number,
219
+ total_cost_usd: S.Number,
220
+ /**
221
+ * What the same window's usage would have cost at pure metered API
222
+ * pricing: non-subscription rows contribute their real `cost_usd`;
223
+ * subscription rows (which log cost 0) are re-priced from the static
224
+ * catalog pricing at API-equivalent per-token rates — PLUS the inferred
225
+ * off-gateway subscription usage below (usage on other devices moves the
226
+ * same quota meter the plan fee bought). Drives the overview savings bar
227
+ * (`total_api_equivalent_cost_usd - total_cost_usd` = what the
228
+ * subscriptions saved).
229
+ */
230
+ total_api_equivalent_cost_usd: S.Number,
231
+ /**
232
+ * Per-provider inferred all-device usage (absent providers had no
233
+ * calibrated meter series — their contribution is 0, the pre-inference
234
+ * behaviour). The sum of `off_gateway_usd` here is exactly the inferred
235
+ * term inside `total_api_equivalent_cost_usd`.
236
+ */
237
+ inferred_subscription_usage: S.optional(S.Array(InferredProviderUsage)),
238
+ by_model: S.Array(ModelBreakdown),
239
+ daily: S.Array(DailyBucket),
240
+ });
241
+ export type TUserStats = S.Schema.Type<typeof UserStats>;
242
+
243
+ export const KeyStats = S.Struct({
244
+ key_id: S.String,
245
+ total_requests: S.Number,
246
+ total_tokens_in: S.Number,
247
+ total_tokens_out: S.Number,
248
+ total_cost_usd: S.Number,
249
+ daily: S.Array(DailyBucket),
250
+ });
251
+ export type TKeyStats = S.Schema.Type<typeof KeyStats>;
252
+
253
+ export const AdminStats = S.Struct({
254
+ total_users: S.Number,
255
+ active_users_7d: S.Number,
256
+ total_requests: S.Number,
257
+ total_cost_usd: S.Number,
258
+ by_model: S.Array(ModelBreakdown),
259
+ daily: S.Array(DailyBucket),
260
+ });
261
+ export type TAdminStats = S.Schema.Type<typeof AdminStats>;
262
+
263
+ // ─── Stacked / grouped requests for the overview "Recent Requests" table ─────
264
+
265
+ /**
266
+ * A horizontal grouping of recent requests by (provider, model) within a
267
+ * sliding window. Ephemeral `local_port_<n>` providers are collapsed to the
268
+ * stable `local_port` bucket with model `local_port/<leaf>`. The overview
269
+ * table renders one row per group with an `N×` badge; expanding fans out
270
+ * the individual rows via `requestItems`, each carrying its own endpoint.
271
+ */
272
+ /**
273
+ * Side of a team-attributed request group, derived (no DB column):
274
+ * - `consumer` — `provider` starts with `team:`
275
+ * - `supplier` — `team_id` set and provider is the real upstream
276
+ */
277
+ export const TeamRequestSide = S.Literals(["consumer", "supplier"]);
278
+ export type TTeamRequestSide = S.Schema.Type<typeof TeamRequestSide>;
279
+
280
+ export const GroupedRequest = S.Struct({
281
+ id: S.String,
282
+ provider: S.String,
283
+ model: S.NullOr(S.String),
284
+ /** Distinct endpoints inside the bucket (empty when all rows had none). */
285
+ endpoints: S.Array(S.String),
286
+ count: S.Number,
287
+ tokens_in: S.Number,
288
+ tokens_out: S.Number,
289
+ total_tokens: S.Number,
290
+ /**
291
+ * What this group actually cost on metered API billing — the summed
292
+ * `requests.cost_usd`. Subscription groups log cost 0, so this is 0
293
+ * for them; their price story lives in `api_equivalent_cost_usd`.
294
+ */
295
+ cost_usd: S.Number,
296
+ /**
297
+ * What this group's usage would cost at metered API pricing — set only
298
+ * for subscription-provider groups (which log `cost_usd = 0`), re-priced
299
+ * from the static catalog via `priceSubscriptionUsage` (same calculator
300
+ * as the overview savings bar, cache-read/cache-write split included).
301
+ * `null` for metered groups, whose real cost already lives in `cost_usd`.
302
+ */
303
+ api_equivalent_cost_usd: S.NullOr(S.Number),
304
+ first_timestamp: S.String,
305
+ last_timestamp: S.String,
306
+ /**
307
+ * Teams attribution for the overview "for team X" / "via team X" label.
308
+ * Null when the group is personal (no `team_id`).
309
+ */
310
+ team_id: S.optional(S.NullOr(S.String)),
311
+ team_slug: S.optional(S.NullOr(S.String)),
312
+ team_name: S.optional(S.NullOr(S.String)),
313
+ team_side: S.optional(S.NullOr(TeamRequestSide)),
314
+ });
315
+ export type TGroupedRequest = S.Schema.Type<typeof GroupedRequest>;
316
+
317
+ export const GroupedRequestsPagination = S.Struct({
318
+ page: S.Number,
319
+ page_size: S.Number,
320
+ total_groups: S.Number,
321
+ has_more: S.Boolean,
322
+ has_exact_total: S.Boolean,
323
+ });
324
+ export type TGroupedRequestsPagination = S.Schema.Type<
325
+ typeof GroupedRequestsPagination
326
+ >;
327
+
328
+ export const GroupedRequestsResponse = S.Struct({
329
+ groups: S.Array(GroupedRequest),
330
+ pagination: GroupedRequestsPagination,
331
+ });
332
+ export type TGroupedRequestsResponse = S.Schema.Type<
333
+ typeof GroupedRequestsResponse
334
+ >;
335
+
336
+ /** A single request row inside an expanded group. */
337
+ export const RequestItem = S.Struct({
338
+ id: S.String,
339
+ model: S.NullOr(S.String),
340
+ endpoint: S.NullOr(S.String),
341
+ prompt_tokens: S.Number,
342
+ completion_tokens: S.Number,
343
+ total_tokens: S.Number,
344
+ ts: S.String,
345
+ /**
346
+ * Present when the items query is in failed mode (`failed=1`). Success
347
+ * expansions leave these null so the recent-requests sub-rows stay lean.
348
+ */
349
+ status: S.optional(S.NullOr(RequestStatus)),
350
+ error: S.optional(S.NullOr(S.String)),
351
+ team_id: S.optional(S.NullOr(S.String)),
352
+ team_slug: S.optional(S.NullOr(S.String)),
353
+ team_name: S.optional(S.NullOr(S.String)),
354
+ team_side: S.optional(S.NullOr(TeamRequestSide)),
355
+ });
356
+ export type TRequestItem = S.Schema.Type<typeof RequestItem>;
357
+
358
+ export const RequestItemsResponse = S.Struct({
359
+ items: S.Array(RequestItem),
360
+ });
361
+ export type TRequestItemsResponse = S.Schema.Type<typeof RequestItemsResponse>;
362
+
363
+ /**
364
+ * A (provider, model) bucket of failed hops for the overview debug table —
365
+ * same grouping shape as Recent requests, but only
366
+ * `status ∈ {error, timeout, rate_limited}`. Expanding loads individual
367
+ * rows via `requestItems?failed=1`.
368
+ */
369
+ export const FailedRequestGroup = S.Struct({
370
+ id: S.String,
371
+ provider: S.String,
372
+ model: S.NullOr(S.String),
373
+ endpoints: S.Array(S.String),
374
+ count: S.Number,
375
+ /** Most recent non-null error message in the bucket (preview in the row). */
376
+ last_error: S.NullOr(S.String),
377
+ first_timestamp: S.String,
378
+ last_timestamp: S.String,
379
+ team_id: S.optional(S.NullOr(S.String)),
380
+ team_slug: S.optional(S.NullOr(S.String)),
381
+ team_name: S.optional(S.NullOr(S.String)),
382
+ team_side: S.optional(S.NullOr(TeamRequestSide)),
383
+ });
384
+ export type TFailedRequestGroup = S.Schema.Type<typeof FailedRequestGroup>;
385
+
386
+ export const FailedRequestsResponse = S.Struct({
387
+ groups: S.Array(FailedRequestGroup),
388
+ pagination: GroupedRequestsPagination,
389
+ });
390
+ export type TFailedRequestsResponse = S.Schema.Type<
391
+ typeof FailedRequestsResponse
392
+ >;
393
+
394
+ /**
395
+ * Acknowledgement for `DELETE /api/stats/requests` — drops every row
396
+ * inside one (model, endpoint, time window) group for the authed user.
397
+ * The overview table calls this when the user clicks the trash icon
398
+ * on a group row.
399
+ */
400
+ export const DeleteRequestGroupResponse = S.Struct({
401
+ ok: S.Boolean,
402
+ deleted: S.Number,
403
+ });
404
+ export type TDeleteRequestGroupResponse = S.Schema.Type<
405
+ typeof DeleteRequestGroupResponse
406
+ >;
@@ -0,0 +1,19 @@
1
+ import { Schema as S } from "effect";
2
+
3
+ export const SseEvent = S.Union([
4
+ S.Struct({ kind: S.Literal("data"), data: S.String }),
5
+ S.Struct({ kind: S.Literal("done") }),
6
+ S.Struct({ kind: S.Literal("comment"), comment: S.String }),
7
+ ]);
8
+ export type TSseEvent = S.Schema.Type<typeof SseEvent>;
9
+
10
+ export const HeartbeatOptions = S.Struct({
11
+ intervalMs: S.Number,
12
+ // Which keepalive frame to emit while the upstream is silent.
13
+ // - "comment" → `: keepalive\n\n` (OpenAI-idiomatic; safe to
14
+ // lead with — used on the `/v1/chat/completions` surface).
15
+ // - "anthropic_ping" → `event: ping\ndata: {"type":"ping"}\n\n`
16
+ // (what Claude Code's Anthropic SDK expects on `/v1/messages`).
17
+ kind: S.optional(S.Literals(["comment", "anthropic_ping"])),
18
+ });
19
+ export type THeartbeatOptions = S.Schema.Type<typeof HeartbeatOptions>;
@@ -0,0 +1,33 @@
1
+ import type { TSubscriptionProviderSlug } from "./subscription-provider";
2
+
3
+ /**
4
+ * Provider-level minimum daemon versions for subscription control-plane UI.
5
+ *
6
+ * Sparse map — providers absent here have no static floor (live only).
7
+ *
8
+ * `unreleased` means the provider's daemon support is in tree but no
9
+ * provider-capable binary has been published yet. The release publisher
10
+ * stamps every `unreleased` entry to
11
+ * `{ state: "since", version: "<this artifact's bare semver>" }` before the
12
+ * protocol source mirror (injected via `stampFiles`) and commits this file
13
+ * with `DAEMON_RELEASE`. Floors are excluded from daemon binary source
14
+ * pathspecs — `--no-compile` may stamp them without rebuilding. Do not invent
15
+ * a version here by hand, and do not bump a `since` floor on later unrelated
16
+ * releases.
17
+ *
18
+ * AUTOGENERATED body by packages/release when a stamp runs — seed new providers
19
+ * with `{ state: "unreleased" }` until their first daemon publish.
20
+ */
21
+
22
+ export type TSubscriptionDaemonFloor =
23
+ | { readonly state: "unreleased" }
24
+ | { readonly state: "since"; readonly version: string };
25
+
26
+ export type TSubscriptionDaemonFloors = Readonly<
27
+ Partial<Record<TSubscriptionProviderSlug, TSubscriptionDaemonFloor>>
28
+ >;
29
+
30
+ export const SUBSCRIPTION_DAEMON_FLOORS: TSubscriptionDaemonFloors = {
31
+ antigravity: { state: "since", version: "2.7.24" },
32
+ muse: { state: "since", version: "2.7.6" },
33
+ };
@@ -0,0 +1,104 @@
1
+ import {
2
+ isDaemonVersionAtLeast,
3
+ isDevDaemonVersion,
4
+ parseDaemonSemver,
5
+ } from "./semver";
6
+ import type { TSubscriptionDaemonFloor } from "./subscription-daemon-floors";
7
+ import { SUBSCRIPTION_DAEMON_FLOORS } from "./subscription-daemon-floors";
8
+ import type { TSubscriptionProviderSlug } from "./subscription-provider";
9
+ import { isSubscriptionProviderSlug } from "./subscription-provider";
10
+
11
+ /**
12
+ * Provider-level minimum daemon version for subscription control-plane UI.
13
+ *
14
+ * Floors live in `subscription-daemon-floors.ts`. `unreleased` falls back to
15
+ * live `connections[]` membership; the release publisher stamps unreleased
16
+ * entries to `{ state: "since", version }` before the protocol mirror and
17
+ * commits them with `DAEMON_RELEASE`.
18
+ */
19
+
20
+ export const subscriptionDaemonFloorOf = (
21
+ slug: string,
22
+ ): TSubscriptionDaemonFloor | undefined => {
23
+ if (!isSubscriptionProviderSlug(slug)) return undefined;
24
+ const keyed: TSubscriptionProviderSlug = slug;
25
+ return SUBSCRIPTION_DAEMON_FLOORS[keyed];
26
+ };
27
+
28
+ /**
29
+ * Live capability probe from a daemon status snapshot.
30
+ *
31
+ * - Cached / not-yet-live status → unknown (`null`).
32
+ * - Live complete snapshot that omits the slug → unsupported (`false`).
33
+ * - Live snapshot that includes the slug → supported (`true`).
34
+ * - Empty connections → unknown (`null`).
35
+ */
36
+ export const liveSubscriptionProviderSupport = (
37
+ connections: ReadonlyArray<{ readonly provider: string }>,
38
+ slug: string,
39
+ options?: { readonly liveConfirmed?: boolean },
40
+ ): boolean | null => {
41
+ if (options?.liveConfirmed !== true) return null;
42
+ if (connections.length === 0) return null;
43
+ return connections.some((c) => c.provider === slug);
44
+ };
45
+
46
+ export type TSubscriptionProviderSupportOptions = {
47
+ readonly daemonVersion?: string | null;
48
+ readonly connections: ReadonlyArray<{ readonly provider: string }>;
49
+ readonly liveConfirmed?: boolean;
50
+ };
51
+
52
+ /**
53
+ * Pure floor + live resolver. Tests pass an explicit floor; production uses
54
+ * {@link subscriptionProviderSupportedOnDaemon}.
55
+ */
56
+ export const subscriptionProviderSupportWithFloor = (
57
+ slug: string,
58
+ floor: TSubscriptionDaemonFloor | undefined,
59
+ options: TSubscriptionProviderSupportOptions,
60
+ ): boolean | null => {
61
+ const live = (): boolean | null =>
62
+ liveSubscriptionProviderSupport(options.connections, slug, {
63
+ liveConfirmed: options.liveConfirmed,
64
+ });
65
+
66
+ if (floor === undefined || floor.state === "unreleased") return live();
67
+
68
+ const version = options.daemonVersion;
69
+ if (
70
+ typeof version !== "string" ||
71
+ version.trim().length === 0 ||
72
+ isDevDaemonVersion(version) ||
73
+ parseDaemonSemver(version) === null
74
+ ) {
75
+ return live();
76
+ }
77
+
78
+ if (!isDaemonVersionAtLeast(version, floor.version)) return false;
79
+
80
+ // Version meets the floor. A live-confirmed omission still wins so a
81
+ // custom / stripped build is not falsely treated as Muse-capable.
82
+ if (options.liveConfirmed === true && options.connections.length > 0) {
83
+ return live();
84
+ }
85
+ return true;
86
+ };
87
+
88
+ /**
89
+ * Resolve whether a subscription provider is usable on the selected daemon.
90
+ *
91
+ * Released floors give a deterministic older-daemon "update required" from
92
+ * static metadata. Dev / unparseable / unreleased builds keep the live
93
+ * connections probe as the hard gate (and as a capability fallback when a
94
+ * new-enough binary still omits the provider).
95
+ */
96
+ export const subscriptionProviderSupportedOnDaemon = (
97
+ slug: string,
98
+ options: TSubscriptionProviderSupportOptions,
99
+ ): boolean | null =>
100
+ subscriptionProviderSupportWithFloor(
101
+ slug,
102
+ subscriptionDaemonFloorOf(slug),
103
+ options,
104
+ );
@@ -0,0 +1,32 @@
1
+ import type { TOAuthProviderSlug } from "./local-provider";
2
+ import {
3
+ isLocalKeyProviderSlug,
4
+ isLocalServerSlug,
5
+ isOAuthProviderSlug,
6
+ OAuthProviderSlug,
7
+ } from "./local-provider";
8
+ import type { TModelProviderType } from "./models";
9
+
10
+ /**
11
+ * @deprecated Prefer {@link OAuthProviderSlug} from `./local-provider`.
12
+ * Re-exported so existing imports keep compiling for one release.
13
+ */
14
+ export const SubscriptionProviderSlug = OAuthProviderSlug;
15
+ /**
16
+ * @deprecated Prefer {@link TOAuthProviderSlug}.
17
+ */
18
+ export type TSubscriptionProviderSlug = TOAuthProviderSlug;
19
+
20
+ /** Catalog tagging only — execution still uses registry `authKind`. */
21
+ export const isSubscriptionProviderSlug = (
22
+ provider: string,
23
+ ): provider is TSubscriptionProviderSlug => isOAuthProviderSlug(provider);
24
+
25
+ /** Catalog tagging only — execution still uses registry `authKind`. */
26
+ export const catalogProviderType = (provider: string): TModelProviderType => {
27
+ if (isLocalServerSlug(provider)) return "local";
28
+ // local_key plans are subscriptions too: $0 per token, savings vs list.
29
+ if (isSubscriptionProviderSlug(provider) || isLocalKeyProviderSlug(provider))
30
+ return "subscription";
31
+ return "api_key";
32
+ };
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Team-grant wire constants. A leaf module (no imports) so `relay`, `mux`
3
+ * and `daemon` can all bound the grant without an import cycle.
4
+ */
5
+
6
+ /** Soft wire cap for an origin-signed team grant on `channel_open` / tunnel OPEN. */
7
+ export const TEAM_GRANT_B64_MAX = 4 * 1024;
8
+
9
+ /** Maximum lifetime of a direct daemon-to-daemon team inference stream. */
10
+ export const TEAM_LEG_STREAM_DEADLINE_MS = 800 * 1000;
11
+
12
+ /**
13
+ * Request / tunnel-OPEN carrier for a team grant the serving daemon re-checks
14
+ * (model, local cap, kill switch). The relay admits on `channel_open.team_grant`
15
+ * only; this header is defence-in-depth on the request path.
16
+ */
17
+ export const TEAM_GRANT_HEADER = "x-openllm-team-grant";
@@ -0,0 +1,61 @@
1
+ import { isLocalProvider } from "./local-provider";
2
+
3
+ /**
4
+ * Team shareability gate (docs/plan/2026-10-26-teams.md §8).
5
+ *
6
+ * Checked at origin (catalog + share selection + upsert) and again on the
7
+ * contributor daemon at grant admit. Shared here so api and daemon cannot
8
+ * drift.
9
+ *
10
+ * Allows:
11
+ * - daemon-only classes — oauth subscription and local server providers
12
+ * (`isLocalProvider`) — served via device tunnel;
13
+ * - API-key / custom endpoint providers (`isApiKeyShareProvider`) — served
14
+ * as a cloud credential share under the two-layer K_cred / K_srv envelope.
15
+ *
16
+ * Vendor-terms rules plug in later as an additional conjunct without a
17
+ * protocol change.
18
+ */
19
+
20
+ /**
21
+ * Built-in BYOK providers that may be contributed as a `credential` share.
22
+ * OAuth / local slugs are excluded (they use `device_model`). Non-chat
23
+ * surfaces (search, embed-only) are filtered at the catalog/UI layer.
24
+ */
25
+ const API_KEY_SHARE_PROVIDERS: ReadonlySet<string> = new Set([
26
+ "openai",
27
+ "anthropic",
28
+ "alibaba",
29
+ "nvidia",
30
+ "mistral",
31
+ "groq",
32
+ "cerebras",
33
+ "opencode_zen",
34
+ "ollama_cloud",
35
+ "openrouter",
36
+ "cloudflare",
37
+ "sambanova",
38
+ "google",
39
+ "zai",
40
+ "minimax",
41
+ ]);
42
+
43
+ const CUSTOM_PROVIDER_RE = /^custom:[a-z0-9][a-z0-9-]{0,62}$/;
44
+
45
+ /** True for built-in BYOK chat providers and `custom:<name>` endpoints. */
46
+ export const isApiKeyShareProvider = (provider: string): boolean => {
47
+ if (isLocalProvider(provider)) return false;
48
+ if (CUSTOM_PROVIDER_RE.test(provider)) return true;
49
+ return API_KEY_SHARE_PROVIDERS.has(provider);
50
+ };
51
+
52
+ /** True when a provider may be shared on a team (any share kind). */
53
+ export const teamShareable = (provider: string): boolean =>
54
+ isLocalProvider(provider) || isApiKeyShareProvider(provider);
55
+
56
+ /** Provider slug of a model id (`provider/model`), or the bare id itself. */
57
+ export const providerOfModel = (model: string): string => {
58
+ const slash = model.indexOf("/");
59
+ if (slash <= 0) return model;
60
+ return model.slice(0, slash);
61
+ };