@openllmsh/sdk 0.0.0-stage → 2.10.12-alpha.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.
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,390 @@
1
+ import type { TMuxChannel } from "./mux";
2
+
3
+ /** Shared timeout and retention policy for RTC→relay-mux peer links. */
4
+ export const PEER_LINK_DEFAULTS = {
5
+ muxAckSameUserMs: 5_000,
6
+ muxAckCrossUserMs: 3_000,
7
+ rtcSignalingMs: 10_000,
8
+ rtcIceMs: 20_000,
9
+ idleTtlMs: 90_000,
10
+ failureTtlMs: 60_000,
11
+ } as const;
12
+
13
+ export type TPeerLinkPath = "rtc" | "mux";
14
+ export type TPeerLinkRtcMode = "use-if-open+warm" | "probe";
15
+ export type TPeerLinkFailureReason =
16
+ | "aborted"
17
+ | "not_capable"
18
+ | "daemon_outdated"
19
+ | "overloaded"
20
+ | "tunnel_busy"
21
+ | "transport"
22
+ | "unknown";
23
+
24
+ export type TPeerLinkEvent = {
25
+ readonly type: "selected" | "failed" | "fallback" | "released";
26
+ readonly path: TPeerLinkPath;
27
+ readonly reason?: TPeerLinkFailureReason;
28
+ readonly reused: boolean;
29
+ readonly openMs?: number;
30
+ };
31
+
32
+ export type TPeerLinkDialer = {
33
+ /** A live channel can be selected without spending the open budget. */
34
+ readonly open: () => TMuxChannel | null;
35
+ /** Begins a best-effort warm-up; it must not reject the caller's request. */
36
+ readonly warm?: () => void;
37
+ /** Dials (or joins) a channel. `null` means this rung is unavailable. */
38
+ readonly dial: (
39
+ timeoutMs: number,
40
+ signal: AbortSignal,
41
+ ) => Promise<TMuxChannel | null>;
42
+ /** Release a healthy channel after it has been idle for the configured TTL. */
43
+ readonly release?: (channel: TMuxChannel) => void;
44
+ /** Host teardown hook for a channel that failed before dispatch. */
45
+ readonly drop?: (channel: TMuxChannel) => void;
46
+ };
47
+
48
+ export type TPeerLinkPolicy = {
49
+ readonly rtcMode?: TPeerLinkRtcMode;
50
+ /** The total time a `probe` call may spend across its rungs. */
51
+ readonly openBudgetMs?: number;
52
+ readonly rtcProbeMs?: number;
53
+ readonly idleTtlMs?: number;
54
+ readonly classifyFailure?: (error: unknown) => TPeerLinkFailureReason;
55
+ /** False means a failed attempt may already have dispatched work. */
56
+ readonly retrySafe?: (error: unknown) => boolean;
57
+ readonly now?: () => number;
58
+ };
59
+
60
+ export type TPeerLinkOptions = {
61
+ /** Stable peer identity; scopes the shared failure cache. */
62
+ readonly target: string;
63
+ readonly rtc?: TPeerLinkDialer;
64
+ readonly mux: TPeerLinkDialer;
65
+ readonly policy?: TPeerLinkPolicy;
66
+ readonly onEvent?: (event: TPeerLinkEvent) => void;
67
+ };
68
+
69
+ export type TPeerLinkChannel = {
70
+ readonly channel: TMuxChannel;
71
+ readonly path: TPeerLinkPath;
72
+ readonly reused: boolean;
73
+ /** Starts idle retention after the caller's last stream finishes. */
74
+ readonly release: () => void;
75
+ };
76
+
77
+ export type TPeerLink = {
78
+ readonly channel: () => Promise<TPeerLinkChannel | null>;
79
+ readonly attempt: <T>(
80
+ fn: (resolved: TPeerLinkChannel) => Promise<T>,
81
+ ) => Promise<T>;
82
+ readonly clearFailures: () => void;
83
+ };
84
+
85
+ const failureTtlMs = (reason: TPeerLinkFailureReason): number => {
86
+ switch (reason) {
87
+ case "aborted":
88
+ return 0;
89
+ case "overloaded":
90
+ case "tunnel_busy":
91
+ return 2_000;
92
+ case "not_capable":
93
+ case "daemon_outdated":
94
+ return 5_000;
95
+ default:
96
+ return PEER_LINK_DEFAULTS.failureTtlMs;
97
+ }
98
+ };
99
+
100
+ const MAX_FAILURE_CACHE_ENTRIES = 1_024;
101
+
102
+ const cacheKeyOf = (target: string, path: TPeerLinkPath): string =>
103
+ `${target}\u0000${path}`;
104
+
105
+ export type TPeerLinkFailureCache = {
106
+ readonly clear: (target?: string, path?: TPeerLinkPath) => void;
107
+ /** Clear one transport's failures without erasing the independent rung. */
108
+ readonly clearPath: (path: TPeerLinkPath) => void;
109
+ readonly has: (target: string, path: TPeerLinkPath, now?: number) => boolean;
110
+ readonly until: (
111
+ target: string,
112
+ path: TPeerLinkPath,
113
+ now?: number,
114
+ ) => number | null;
115
+ readonly set: (
116
+ target: string,
117
+ path: TPeerLinkPath,
118
+ reason: TPeerLinkFailureReason,
119
+ now?: number,
120
+ ) => void;
121
+ };
122
+
123
+ /**
124
+ * Fresh negative-cache map. Relay-mux instances each own one so two clients
125
+ * cannot poison or clear each other; RTC host glue and `createPeerLink` keep
126
+ * the process-global {@link peerLinkFailureCache}.
127
+ */
128
+ export const createPeerLinkFailureCache = (): TPeerLinkFailureCache => {
129
+ const failureCache = new Map<string, number>();
130
+
131
+ const sweepFailureCache = (now: number): void => {
132
+ for (const [key, until] of failureCache) {
133
+ if (until <= now) failureCache.delete(key);
134
+ }
135
+ while (failureCache.size > MAX_FAILURE_CACHE_ENTRIES) {
136
+ const oldest = failureCache.keys().next().value;
137
+ if (oldest === undefined) return;
138
+ failureCache.delete(oldest);
139
+ }
140
+ };
141
+
142
+ return {
143
+ clear(target?: string, path?: TPeerLinkPath): void {
144
+ if (target === undefined) {
145
+ failureCache.clear();
146
+ return;
147
+ }
148
+ if (path !== undefined) {
149
+ failureCache.delete(cacheKeyOf(target, path));
150
+ return;
151
+ }
152
+ for (const key of failureCache.keys()) {
153
+ if (key.startsWith(`${target}\u0000`)) failureCache.delete(key);
154
+ }
155
+ },
156
+ clearPath(path: TPeerLinkPath): void {
157
+ for (const key of failureCache.keys()) {
158
+ if (key.endsWith(`\u0000${path}`)) failureCache.delete(key);
159
+ }
160
+ },
161
+ has(target: string, path: TPeerLinkPath, now = Date.now()): boolean {
162
+ const key = cacheKeyOf(target, path);
163
+ const until = failureCache.get(key);
164
+ if (until === undefined) return false;
165
+ if (until > now) return true;
166
+ failureCache.delete(key);
167
+ return false;
168
+ },
169
+ until(
170
+ target: string,
171
+ path: TPeerLinkPath,
172
+ now = Date.now(),
173
+ ): number | null {
174
+ const key = cacheKeyOf(target, path);
175
+ const until = failureCache.get(key);
176
+ if (until === undefined) return null;
177
+ if (until > now) return until;
178
+ failureCache.delete(key);
179
+ return null;
180
+ },
181
+ set(
182
+ target: string,
183
+ path: TPeerLinkPath,
184
+ reason: TPeerLinkFailureReason,
185
+ now = Date.now(),
186
+ ): void {
187
+ const ttl = failureTtlMs(reason);
188
+ sweepFailureCache(now);
189
+ if (ttl > 0) {
190
+ const key = cacheKeyOf(target, path);
191
+ failureCache.delete(key);
192
+ failureCache.set(key, now + ttl);
193
+ sweepFailureCache(now);
194
+ }
195
+ },
196
+ };
197
+ };
198
+
199
+ /**
200
+ * Process-global cache for RTC host dialers and `createPeerLink`. Mux channel
201
+ * maps own a separate instance via {@link createPeerLinkFailureCache}.
202
+ */
203
+ export const peerLinkFailureCache = createPeerLinkFailureCache();
204
+
205
+ export const peerLinkFailureReasonOf = (
206
+ error: unknown,
207
+ ): TPeerLinkFailureReason => {
208
+ if (error instanceof DOMException && error.name === "AbortError") {
209
+ return "aborted";
210
+ }
211
+ if (!(error instanceof Error)) return "unknown";
212
+ if (error.message.includes("not_capable")) return "not_capable";
213
+ if (error.message.includes("daemon_outdated")) return "daemon_outdated";
214
+ if (error.message.includes("overloaded")) return "overloaded";
215
+ if (error.message.includes("tunnel_busy")) return "tunnel_busy";
216
+ return "transport";
217
+ };
218
+
219
+ /**
220
+ * Sans-I/O RTC-first channel ladder. Hosts provide their RTC and relay mechanics;
221
+ * this module owns selection, bounded probing, negative caching and idle release.
222
+ */
223
+ export const createPeerLink = (options: TPeerLinkOptions): TPeerLink => {
224
+ const now = options.policy?.now ?? Date.now;
225
+ const rtcMode = options.policy?.rtcMode ?? "use-if-open+warm";
226
+ const openBudgetMs =
227
+ options.policy?.openBudgetMs ?? PEER_LINK_DEFAULTS.muxAckSameUserMs;
228
+ const rtcProbeMs =
229
+ options.policy?.rtcProbeMs ?? Math.min(2_000, openBudgetMs);
230
+ const idleTtlMs = options.policy?.idleTtlMs ?? PEER_LINK_DEFAULTS.idleTtlMs;
231
+ const classify = options.policy?.classifyFailure ?? peerLinkFailureReasonOf;
232
+ // Retrying a dispatched inference can duplicate provider work. Callers must
233
+ // prove that the failure happened before dispatch to opt into a fallback.
234
+ const retrySafe = options.policy?.retrySafe ?? (() => false);
235
+ const idleTimers = new Map<TMuxChannel, ReturnType<typeof setTimeout>>();
236
+
237
+ const emit = (event: TPeerLinkEvent): void => options.onEvent?.(event);
238
+ const cached = (path: TPeerLinkPath): boolean =>
239
+ peerLinkFailureCache.has(options.target, path, now());
240
+ const cache = (path: TPeerLinkPath, error: unknown): void => {
241
+ const reason = classify(error);
242
+ peerLinkFailureCache.set(options.target, path, reason, now());
243
+ emit({ type: "failed", path, reason, reused: false });
244
+ };
245
+ const release = (
246
+ path: TPeerLinkPath,
247
+ dialer: TPeerLinkDialer,
248
+ channel: TMuxChannel,
249
+ ): void => {
250
+ const prior = idleTimers.get(channel);
251
+ if (prior !== undefined) clearTimeout(prior);
252
+ idleTimers.set(
253
+ channel,
254
+ setTimeout(() => {
255
+ idleTimers.delete(channel);
256
+ if (channel.openStreamCount() === 0) dialer.release?.(channel);
257
+ }, idleTtlMs),
258
+ );
259
+ emit({ type: "released", path, reused: true });
260
+ };
261
+ const resultOf = (
262
+ path: TPeerLinkPath,
263
+ dialer: TPeerLinkDialer,
264
+ channel: TMuxChannel,
265
+ reused: boolean,
266
+ openedAt: number,
267
+ ): TPeerLinkChannel => {
268
+ const prior = idleTimers.get(channel);
269
+ if (prior !== undefined) {
270
+ clearTimeout(prior);
271
+ idleTimers.delete(channel);
272
+ }
273
+ emit({ type: "selected", path, reused, openMs: now() - openedAt });
274
+ return {
275
+ channel,
276
+ path,
277
+ reused,
278
+ release: () => release(path, dialer, channel),
279
+ };
280
+ };
281
+
282
+ const dialWithin = async (
283
+ dialer: TPeerLinkDialer,
284
+ timeoutMs: number,
285
+ ): Promise<TMuxChannel | null> => {
286
+ const controller = new AbortController();
287
+ let timer: ReturnType<typeof setTimeout> | undefined;
288
+ const timedOut = new Promise<never>((_, reject) => {
289
+ timer = setTimeout(() => {
290
+ controller.abort();
291
+ reject(new DOMException("Timed out", "AbortError"));
292
+ }, timeoutMs);
293
+ });
294
+ try {
295
+ return await Promise.race([
296
+ dialer.dial(timeoutMs, controller.signal),
297
+ timedOut,
298
+ ]);
299
+ } finally {
300
+ if (timer !== undefined) clearTimeout(timer);
301
+ controller.abort();
302
+ }
303
+ };
304
+
305
+ const channel = async (): Promise<TPeerLinkChannel | null> => {
306
+ const startedAt = now();
307
+ const rtc = options.rtc;
308
+ if (rtc !== undefined && !cached("rtc")) {
309
+ const open = rtc.open();
310
+ if (open !== null) return resultOf("rtc", rtc, open, true, startedAt);
311
+ try {
312
+ rtc.warm?.();
313
+ } catch (error) {
314
+ cache("rtc", error);
315
+ emit({
316
+ type: "fallback",
317
+ path: "rtc",
318
+ reason: classify(error),
319
+ reused: false,
320
+ });
321
+ }
322
+ if (rtcMode === "probe") {
323
+ try {
324
+ const probe = await dialWithin(
325
+ rtc,
326
+ Math.min(rtcProbeMs, openBudgetMs),
327
+ );
328
+ if (probe !== null)
329
+ return resultOf("rtc", rtc, probe, false, startedAt);
330
+ } catch (error) {
331
+ cache("rtc", error);
332
+ emit({
333
+ type: "fallback",
334
+ path: "rtc",
335
+ reason: classify(error),
336
+ reused: false,
337
+ });
338
+ }
339
+ }
340
+ }
341
+ if (cached("mux")) return null;
342
+ const remaining = Math.max(0, openBudgetMs - (now() - startedAt));
343
+ if (remaining === 0) return null;
344
+ try {
345
+ const mux = await dialWithin(options.mux, remaining);
346
+ if (mux === null) return null;
347
+ return resultOf(
348
+ "mux",
349
+ options.mux,
350
+ mux,
351
+ options.mux.open() === mux,
352
+ startedAt,
353
+ );
354
+ } catch (error) {
355
+ cache("mux", error);
356
+ return null;
357
+ }
358
+ };
359
+
360
+ const attempt = async <T>(
361
+ fn: (resolved: TPeerLinkChannel) => Promise<T>,
362
+ ): Promise<T> => {
363
+ const resolved = await channel();
364
+ if (resolved === null) throw new Error("peer link unavailable");
365
+ try {
366
+ return await fn(resolved);
367
+ } catch (error) {
368
+ if (!retrySafe(error)) throw error;
369
+ cache(resolved.path, error);
370
+ const dialer = resolved.path === "rtc" ? options.rtc : options.mux;
371
+ dialer?.drop?.(resolved.channel);
372
+ if (resolved.path !== "rtc") throw error;
373
+ emit({
374
+ type: "fallback",
375
+ path: "rtc",
376
+ reason: classify(error),
377
+ reused: resolved.reused,
378
+ });
379
+ const mux = await channel();
380
+ if (mux === null || mux.path !== "mux") throw error;
381
+ return fn(mux);
382
+ }
383
+ };
384
+
385
+ return {
386
+ channel,
387
+ attempt,
388
+ clearFailures: (): void => peerLinkFailureCache.clear(options.target),
389
+ };
390
+ };