pi-cursor-sdk 0.1.49 → 0.1.51

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 (278) hide show
  1. package/CHANGELOG.md +36 -1
  2. package/README.md +2 -2
  3. package/docs/cursor-live-smoke-checklist.md +4 -4
  4. package/docs/cursor-model-ux-spec.md +5 -5
  5. package/docs/cursor-native-tool-replay.md +2 -2
  6. package/docs/cursor-native-tool-visual-audit.md +1 -1
  7. package/docs/cursor-testing-lessons.md +1 -1
  8. package/package.json +6 -15
  9. package/src/cursor-fallback-models.generated.ts +536 -302
  10. package/src/cursor-provider-errors.ts +29 -0
  11. package/src/cursor-provider-overflow.ts +96 -0
  12. package/src/cursor-tool-manifest.ts +1 -1
  13. package/src/index.ts +4 -1
  14. package/node_modules/@connectrpc/connect-node/README.md +0 -141
  15. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.d.ts +0 -15
  16. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.js +0 -89
  17. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.d.ts +0 -42
  18. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.js +0 -61
  19. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.d.ts +0 -100
  20. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.js +0 -25
  21. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.d.ts +0 -96
  22. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.js +0 -25
  23. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.d.ts +0 -96
  24. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.js +0 -25
  25. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.d.ts +0 -146
  26. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.js +0 -536
  27. package/node_modules/@connectrpc/connect-node/dist/cjs/index.d.ts +0 -15
  28. package/node_modules/@connectrpc/connect-node/dist/cjs/index.js +0 -36
  29. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.d.ts +0 -45
  30. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.js +0 -154
  31. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.d.ts +0 -1
  32. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.js +0 -29
  33. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.d.ts +0 -89
  34. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.js +0 -58
  35. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.d.ts +0 -54
  36. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.js +0 -326
  37. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.d.ts +0 -41
  38. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.js +0 -234
  39. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.d.ts +0 -19
  40. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.js +0 -97
  41. package/node_modules/@connectrpc/connect-node/dist/cjs/package.json +0 -1
  42. package/node_modules/@connectrpc/connect-node/dist/esm/compression.d.ts +0 -15
  43. package/node_modules/@connectrpc/connect-node/dist/esm/compression.js +0 -86
  44. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.d.ts +0 -42
  45. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.js +0 -58
  46. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.d.ts +0 -100
  47. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.js +0 -22
  48. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.d.ts +0 -96
  49. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.js +0 -22
  50. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.d.ts +0 -96
  51. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.js +0 -22
  52. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.d.ts +0 -146
  53. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.js +0 -532
  54. package/node_modules/@connectrpc/connect-node/dist/esm/index.d.ts +0 -15
  55. package/node_modules/@connectrpc/connect-node/dist/esm/index.js +0 -23
  56. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.d.ts +0 -45
  57. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.js +0 -147
  58. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.d.ts +0 -1
  59. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.js +0 -27
  60. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.d.ts +0 -89
  61. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.js +0 -58
  62. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.d.ts +0 -54
  63. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.js +0 -324
  64. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.d.ts +0 -41
  65. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.js +0 -230
  66. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.d.ts +0 -19
  67. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.js +0 -93
  68. package/node_modules/@connectrpc/connect-node/package.json +0 -46
  69. package/node_modules/undici/LICENSE +0 -21
  70. package/node_modules/undici/README.md +0 -741
  71. package/node_modules/undici/docs/docs/api/Agent.md +0 -84
  72. package/node_modules/undici/docs/docs/api/BalancedPool.md +0 -99
  73. package/node_modules/undici/docs/docs/api/CacheStorage.md +0 -30
  74. package/node_modules/undici/docs/docs/api/CacheStore.md +0 -164
  75. package/node_modules/undici/docs/docs/api/Client.md +0 -288
  76. package/node_modules/undici/docs/docs/api/ClientStats.md +0 -27
  77. package/node_modules/undici/docs/docs/api/Connector.md +0 -115
  78. package/node_modules/undici/docs/docs/api/ContentType.md +0 -57
  79. package/node_modules/undici/docs/docs/api/Cookies.md +0 -128
  80. package/node_modules/undici/docs/docs/api/Debug.md +0 -62
  81. package/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +0 -315
  82. package/node_modules/undici/docs/docs/api/Dispatcher.md +0 -1392
  83. package/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +0 -159
  84. package/node_modules/undici/docs/docs/api/Errors.md +0 -49
  85. package/node_modules/undici/docs/docs/api/EventSource.md +0 -45
  86. package/node_modules/undici/docs/docs/api/Fetch.md +0 -60
  87. package/node_modules/undici/docs/docs/api/GlobalInstallation.md +0 -139
  88. package/node_modules/undici/docs/docs/api/H2CClient.md +0 -263
  89. package/node_modules/undici/docs/docs/api/MockAgent.md +0 -603
  90. package/node_modules/undici/docs/docs/api/MockCallHistory.md +0 -197
  91. package/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +0 -43
  92. package/node_modules/undici/docs/docs/api/MockClient.md +0 -81
  93. package/node_modules/undici/docs/docs/api/MockErrors.md +0 -12
  94. package/node_modules/undici/docs/docs/api/MockPool.md +0 -555
  95. package/node_modules/undici/docs/docs/api/Pool.md +0 -84
  96. package/node_modules/undici/docs/docs/api/PoolStats.md +0 -35
  97. package/node_modules/undici/docs/docs/api/ProxyAgent.md +0 -229
  98. package/node_modules/undici/docs/docs/api/RedirectHandler.md +0 -93
  99. package/node_modules/undici/docs/docs/api/RetryAgent.md +0 -50
  100. package/node_modules/undici/docs/docs/api/RetryHandler.md +0 -118
  101. package/node_modules/undici/docs/docs/api/RoundRobinPool.md +0 -145
  102. package/node_modules/undici/docs/docs/api/SnapshotAgent.md +0 -616
  103. package/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +0 -275
  104. package/node_modules/undici/docs/docs/api/Util.md +0 -25
  105. package/node_modules/undici/docs/docs/api/WebSocket.md +0 -141
  106. package/node_modules/undici/docs/docs/api/api-lifecycle.md +0 -91
  107. package/node_modules/undici/docs/docs/best-practices/client-certificate.md +0 -64
  108. package/node_modules/undici/docs/docs/best-practices/crawling.md +0 -58
  109. package/node_modules/undici/docs/docs/best-practices/mocking-request.md +0 -190
  110. package/node_modules/undici/docs/docs/best-practices/proxy.md +0 -127
  111. package/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +0 -224
  112. package/node_modules/undici/docs/docs/best-practices/writing-tests.md +0 -63
  113. package/node_modules/undici/index-fetch.js +0 -65
  114. package/node_modules/undici/index.d.ts +0 -3
  115. package/node_modules/undici/index.js +0 -234
  116. package/node_modules/undici/lib/api/abort-signal.js +0 -59
  117. package/node_modules/undici/lib/api/api-connect.js +0 -110
  118. package/node_modules/undici/lib/api/api-pipeline.js +0 -252
  119. package/node_modules/undici/lib/api/api-request.js +0 -214
  120. package/node_modules/undici/lib/api/api-stream.js +0 -209
  121. package/node_modules/undici/lib/api/api-upgrade.js +0 -111
  122. package/node_modules/undici/lib/api/index.js +0 -7
  123. package/node_modules/undici/lib/api/readable.js +0 -580
  124. package/node_modules/undici/lib/cache/memory-cache-store.js +0 -234
  125. package/node_modules/undici/lib/cache/sqlite-cache-store.js +0 -461
  126. package/node_modules/undici/lib/core/connect.js +0 -153
  127. package/node_modules/undici/lib/core/constants.js +0 -143
  128. package/node_modules/undici/lib/core/diagnostics.js +0 -227
  129. package/node_modules/undici/lib/core/errors.js +0 -477
  130. package/node_modules/undici/lib/core/request.js +0 -453
  131. package/node_modules/undici/lib/core/socks5-client.js +0 -422
  132. package/node_modules/undici/lib/core/socks5-utils.js +0 -212
  133. package/node_modules/undici/lib/core/symbols.js +0 -75
  134. package/node_modules/undici/lib/core/tree.js +0 -160
  135. package/node_modules/undici/lib/core/util.js +0 -992
  136. package/node_modules/undici/lib/dispatcher/agent.js +0 -158
  137. package/node_modules/undici/lib/dispatcher/balanced-pool.js +0 -219
  138. package/node_modules/undici/lib/dispatcher/client-h1.js +0 -1722
  139. package/node_modules/undici/lib/dispatcher/client-h2.js +0 -995
  140. package/node_modules/undici/lib/dispatcher/client.js +0 -664
  141. package/node_modules/undici/lib/dispatcher/dispatcher-base.js +0 -184
  142. package/node_modules/undici/lib/dispatcher/dispatcher.js +0 -48
  143. package/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +0 -146
  144. package/node_modules/undici/lib/dispatcher/fixed-queue.js +0 -135
  145. package/node_modules/undici/lib/dispatcher/h2c-client.js +0 -51
  146. package/node_modules/undici/lib/dispatcher/pool-base.js +0 -214
  147. package/node_modules/undici/lib/dispatcher/pool.js +0 -118
  148. package/node_modules/undici/lib/dispatcher/proxy-agent.js +0 -319
  149. package/node_modules/undici/lib/dispatcher/retry-agent.js +0 -35
  150. package/node_modules/undici/lib/dispatcher/round-robin-pool.js +0 -137
  151. package/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +0 -260
  152. package/node_modules/undici/lib/encoding/index.js +0 -33
  153. package/node_modules/undici/lib/global.js +0 -59
  154. package/node_modules/undici/lib/handler/cache-handler.js +0 -578
  155. package/node_modules/undici/lib/handler/cache-revalidation-handler.js +0 -124
  156. package/node_modules/undici/lib/handler/decorator-handler.js +0 -67
  157. package/node_modules/undici/lib/handler/deduplication-handler.js +0 -460
  158. package/node_modules/undici/lib/handler/redirect-handler.js +0 -238
  159. package/node_modules/undici/lib/handler/retry-handler.js +0 -394
  160. package/node_modules/undici/lib/handler/unwrap-handler.js +0 -106
  161. package/node_modules/undici/lib/handler/wrap-handler.js +0 -105
  162. package/node_modules/undici/lib/interceptor/cache.js +0 -495
  163. package/node_modules/undici/lib/interceptor/decompress.js +0 -259
  164. package/node_modules/undici/lib/interceptor/deduplicate.js +0 -117
  165. package/node_modules/undici/lib/interceptor/dns.js +0 -571
  166. package/node_modules/undici/lib/interceptor/dump.js +0 -112
  167. package/node_modules/undici/lib/interceptor/redirect.js +0 -21
  168. package/node_modules/undici/lib/interceptor/response-error.js +0 -95
  169. package/node_modules/undici/lib/interceptor/retry.js +0 -19
  170. package/node_modules/undici/lib/llhttp/.gitkeep +0 -0
  171. package/node_modules/undici/lib/llhttp/constants.d.ts +0 -195
  172. package/node_modules/undici/lib/llhttp/constants.js +0 -531
  173. package/node_modules/undici/lib/llhttp/llhttp-wasm.js +0 -15
  174. package/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +0 -15
  175. package/node_modules/undici/lib/llhttp/utils.d.ts +0 -2
  176. package/node_modules/undici/lib/llhttp/utils.js +0 -12
  177. package/node_modules/undici/lib/mock/mock-agent.js +0 -232
  178. package/node_modules/undici/lib/mock/mock-call-history.js +0 -248
  179. package/node_modules/undici/lib/mock/mock-client.js +0 -68
  180. package/node_modules/undici/lib/mock/mock-errors.js +0 -29
  181. package/node_modules/undici/lib/mock/mock-interceptor.js +0 -209
  182. package/node_modules/undici/lib/mock/mock-pool.js +0 -68
  183. package/node_modules/undici/lib/mock/mock-symbols.js +0 -32
  184. package/node_modules/undici/lib/mock/mock-utils.js +0 -486
  185. package/node_modules/undici/lib/mock/pending-interceptors-formatter.js +0 -43
  186. package/node_modules/undici/lib/mock/snapshot-agent.js +0 -353
  187. package/node_modules/undici/lib/mock/snapshot-recorder.js +0 -588
  188. package/node_modules/undici/lib/mock/snapshot-utils.js +0 -158
  189. package/node_modules/undici/lib/util/cache.js +0 -414
  190. package/node_modules/undici/lib/util/date.js +0 -653
  191. package/node_modules/undici/lib/util/promise.js +0 -28
  192. package/node_modules/undici/lib/util/runtime-features.js +0 -124
  193. package/node_modules/undici/lib/util/stats.js +0 -32
  194. package/node_modules/undici/lib/util/timers.js +0 -425
  195. package/node_modules/undici/lib/web/cache/cache.js +0 -864
  196. package/node_modules/undici/lib/web/cache/cachestorage.js +0 -152
  197. package/node_modules/undici/lib/web/cache/util.js +0 -45
  198. package/node_modules/undici/lib/web/cookies/constants.js +0 -12
  199. package/node_modules/undici/lib/web/cookies/index.js +0 -199
  200. package/node_modules/undici/lib/web/cookies/parse.js +0 -314
  201. package/node_modules/undici/lib/web/cookies/util.js +0 -282
  202. package/node_modules/undici/lib/web/eventsource/eventsource-stream.js +0 -399
  203. package/node_modules/undici/lib/web/eventsource/eventsource.js +0 -501
  204. package/node_modules/undici/lib/web/eventsource/util.js +0 -29
  205. package/node_modules/undici/lib/web/fetch/LICENSE +0 -21
  206. package/node_modules/undici/lib/web/fetch/body.js +0 -509
  207. package/node_modules/undici/lib/web/fetch/constants.js +0 -131
  208. package/node_modules/undici/lib/web/fetch/data-url.js +0 -596
  209. package/node_modules/undici/lib/web/fetch/formdata-parser.js +0 -586
  210. package/node_modules/undici/lib/web/fetch/formdata.js +0 -259
  211. package/node_modules/undici/lib/web/fetch/global.js +0 -40
  212. package/node_modules/undici/lib/web/fetch/headers.js +0 -719
  213. package/node_modules/undici/lib/web/fetch/index.js +0 -2413
  214. package/node_modules/undici/lib/web/fetch/request.js +0 -1115
  215. package/node_modules/undici/lib/web/fetch/response.js +0 -641
  216. package/node_modules/undici/lib/web/fetch/util.js +0 -1522
  217. package/node_modules/undici/lib/web/infra/index.js +0 -229
  218. package/node_modules/undici/lib/web/subresource-integrity/Readme.md +0 -9
  219. package/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +0 -307
  220. package/node_modules/undici/lib/web/webidl/index.js +0 -1006
  221. package/node_modules/undici/lib/web/websocket/connection.js +0 -329
  222. package/node_modules/undici/lib/web/websocket/constants.js +0 -126
  223. package/node_modules/undici/lib/web/websocket/events.js +0 -331
  224. package/node_modules/undici/lib/web/websocket/frame.js +0 -133
  225. package/node_modules/undici/lib/web/websocket/permessage-deflate.js +0 -100
  226. package/node_modules/undici/lib/web/websocket/receiver.js +0 -507
  227. package/node_modules/undici/lib/web/websocket/sender.js +0 -109
  228. package/node_modules/undici/lib/web/websocket/stream/websocketerror.js +0 -104
  229. package/node_modules/undici/lib/web/websocket/stream/websocketstream.js +0 -498
  230. package/node_modules/undici/lib/web/websocket/util.js +0 -347
  231. package/node_modules/undici/lib/web/websocket/websocket.js +0 -758
  232. package/node_modules/undici/package.json +0 -152
  233. package/node_modules/undici/scripts/strip-comments.js +0 -10
  234. package/node_modules/undici/types/README.md +0 -6
  235. package/node_modules/undici/types/agent.d.ts +0 -32
  236. package/node_modules/undici/types/api.d.ts +0 -43
  237. package/node_modules/undici/types/balanced-pool.d.ts +0 -30
  238. package/node_modules/undici/types/cache-interceptor.d.ts +0 -179
  239. package/node_modules/undici/types/cache.d.ts +0 -36
  240. package/node_modules/undici/types/client-stats.d.ts +0 -15
  241. package/node_modules/undici/types/client.d.ts +0 -139
  242. package/node_modules/undici/types/connector.d.ts +0 -36
  243. package/node_modules/undici/types/content-type.d.ts +0 -21
  244. package/node_modules/undici/types/cookies.d.ts +0 -30
  245. package/node_modules/undici/types/diagnostics-channel.d.ts +0 -74
  246. package/node_modules/undici/types/dispatcher.d.ts +0 -275
  247. package/node_modules/undici/types/env-http-proxy-agent.d.ts +0 -22
  248. package/node_modules/undici/types/errors.d.ts +0 -177
  249. package/node_modules/undici/types/eventsource.d.ts +0 -66
  250. package/node_modules/undici/types/fetch.d.ts +0 -231
  251. package/node_modules/undici/types/formdata.d.ts +0 -114
  252. package/node_modules/undici/types/global-dispatcher.d.ts +0 -9
  253. package/node_modules/undici/types/global-origin.d.ts +0 -7
  254. package/node_modules/undici/types/h2c-client.d.ts +0 -73
  255. package/node_modules/undici/types/handlers.d.ts +0 -14
  256. package/node_modules/undici/types/header.d.ts +0 -160
  257. package/node_modules/undici/types/index.d.ts +0 -91
  258. package/node_modules/undici/types/interceptors.d.ts +0 -80
  259. package/node_modules/undici/types/mock-agent.d.ts +0 -68
  260. package/node_modules/undici/types/mock-call-history.d.ts +0 -111
  261. package/node_modules/undici/types/mock-client.d.ts +0 -27
  262. package/node_modules/undici/types/mock-errors.d.ts +0 -12
  263. package/node_modules/undici/types/mock-interceptor.d.ts +0 -94
  264. package/node_modules/undici/types/mock-pool.d.ts +0 -27
  265. package/node_modules/undici/types/patch.d.ts +0 -29
  266. package/node_modules/undici/types/pool-stats.d.ts +0 -19
  267. package/node_modules/undici/types/pool.d.ts +0 -41
  268. package/node_modules/undici/types/proxy-agent.d.ts +0 -29
  269. package/node_modules/undici/types/readable.d.ts +0 -68
  270. package/node_modules/undici/types/retry-agent.d.ts +0 -8
  271. package/node_modules/undici/types/retry-handler.d.ts +0 -125
  272. package/node_modules/undici/types/round-robin-pool.d.ts +0 -41
  273. package/node_modules/undici/types/snapshot-agent.d.ts +0 -109
  274. package/node_modules/undici/types/socks5-proxy-agent.d.ts +0 -25
  275. package/node_modules/undici/types/util.d.ts +0 -18
  276. package/node_modules/undici/types/utility.d.ts +0 -7
  277. package/node_modules/undici/types/webidl.d.ts +0 -347
  278. package/node_modules/undici/types/websocket.d.ts +0 -188
@@ -73,6 +73,19 @@ function collectConnectErrorEvidence(error: unknown, record: Record<string, unkn
73
73
  return evidence.join("\n");
74
74
  }
75
75
 
76
+ function collectConnectErrorStacks(error: unknown, record: Record<string, unknown> | undefined): string {
77
+ const stacks: string[] = [];
78
+ let value = error;
79
+ let currentRecord = record;
80
+ for (let depth = 0; depth < 3 && currentRecord; depth += 1) {
81
+ const stack = getErrorStack(value, currentRecord).trim();
82
+ if (stack) stacks.push(stack);
83
+ value = currentRecord.cause;
84
+ currentRecord = asRecord(value);
85
+ }
86
+ return stacks.join("\n");
87
+ }
88
+
76
89
  function isConnectError(error: unknown, record: Record<string, unknown> | undefined): boolean {
77
90
  const name = error instanceof Error ? error.name : getErrorStringField(record, "name");
78
91
  return name === "ConnectError";
@@ -86,6 +99,17 @@ function isUnavailableConnectCode(code: unknown): boolean {
86
99
  return code === 14 || (typeof code === "string" && /^(?:14|unavailable)$/i.test(code));
87
100
  }
88
101
 
102
+ function isCursorSdkStallAbortNetworkError(code: unknown, evidence: string, stackEvidence: string): boolean {
103
+ return (
104
+ (code === 2 || (typeof code === "string" && /^(?:2|unknown)$/i.test(code))) &&
105
+ /(?:operation was aborted|canceled)/i.test(evidence) &&
106
+ /(?:AbortError|operation was aborted)/i.test(`${evidence}\n${stackEvidence}`) &&
107
+ stackEvidence.includes("@cursor/sdk") &&
108
+ stackEvidence.includes("@connectrpc/connect-node") &&
109
+ /\b(?:onStall|reportStall|StallDetected)\b/i.test(stackEvidence)
110
+ );
111
+ }
112
+
89
113
  function isCursorExtensionConnectStack(stack: string): boolean {
90
114
  // pi runs Cursor SDK in Node, where the SDK dynamically imports connect-node.
91
115
  // connect-web is the SDK's Bun/Deno path and is intentionally not classified for supported pi runs.
@@ -128,6 +152,7 @@ export function classifyCursorConnectError(error: unknown): CursorConnectErrorCl
128
152
  const causeName = getErrorStringField(cause, "name");
129
153
  const stack = getErrorStack(error, record);
130
154
  const evidence = collectConnectErrorEvidence(error, record);
155
+ const stackEvidence = collectConnectErrorStacks(error, record);
131
156
 
132
157
  if (
133
158
  (code === 1 || code === "canceled") &&
@@ -139,6 +164,10 @@ export function classifyCursorConnectError(error: unknown): CursorConnectErrorCl
139
164
  return { kind: "abort", source: "cursor-sdk-stack" };
140
165
  }
141
166
 
167
+ if (isCursorSdkStallAbortNetworkError(code, evidence, stackEvidence)) {
168
+ return { kind: "network", source: getCursorConnectSource(error, record) };
169
+ }
170
+
142
171
  if (isUnauthenticatedConnectCode(code) || isLikelyAuthError(evidence)) {
143
172
  return { kind: "unauthenticated", source: getCursorConnectSource(error, record) };
144
173
  }
@@ -0,0 +1,96 @@
1
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ import type { AssistantMessage } from "@earendil-works/pi-ai/compat";
3
+ import { CURSOR_PROVIDER } from "./cursor-model.js";
4
+
5
+ /**
6
+ * Pi recognizes `context_length_exceeded` (its `OVERFLOW_PATTERNS` includes
7
+ * `/context[_ ]length[_ ]exceeded/i`) as a context-overflow signal and, on
8
+ * detecting it, drops the failed assistant message, compacts, and retries once.
9
+ *
10
+ * The Cursor provider sanitizes SDK failures into auth/network/generic messages
11
+ * that pi does NOT treat as overflow, so a genuine Cursor context-overflow
12
+ * failure would otherwise surface as a plain provider error and bypass pi's
13
+ * auto-compact-retry recovery. This handler rewrites only Cursor context-window
14
+ * failures into the `context_length_exceeded` form pi recognizes.
15
+ *
16
+ * See pi `docs/custom-provider.md` -> "Context Overflow Errors".
17
+ */
18
+ export const CURSOR_OVERFLOW_MARKER = "context_length_exceeded";
19
+
20
+ /**
21
+ * Context-overflow phrases. These overlap pi's own `OVERFLOW_PATTERNS` so the
22
+ * false-positive surface matches pi's built-in detection for other providers.
23
+ *
24
+ * ponytail: intentionally narrow and textual. We do NOT match bare gRPC
25
+ * `resource_exhausted` (code 8) or `too many tokens` because pi documents those
26
+ * can false-match throttling/quota errors and trigger an unwanted compaction.
27
+ * If a live Cursor probe reveals a distinct overflow phrase, add it here; this
28
+ * pattern set is the single place to extend without touching the handler.
29
+ */
30
+ const CURSOR_OVERFLOW_PATTERNS = [
31
+ /context[_ ]?length/i,
32
+ /context[_ ]?window/i,
33
+ /maximum context/i,
34
+ /prompt is too long/i,
35
+ /too large for model/i,
36
+ /exceed(?:s|ed).{0,30}context/i,
37
+ ] as const;
38
+
39
+ /** Never treat rate-limit/throttle signals as overflow (pi retries those separately). */
40
+ const CURSOR_THROTTLE_PATTERN = /too many requests|rate.?limit|throttl|retry.?after/i;
41
+
42
+ /**
43
+ * Map a finalized Cursor assistant `errorMessage` to pi's overflow form.
44
+ * Returns `undefined` when the message is not a Cursor context-overflow failure.
45
+ *
46
+ * Pure and idempotent so it is safe to call repeatedly and unit-test in isolation.
47
+ */
48
+ export function normalizeCursorOverflowErrorMessage(errorMessage: string | undefined): string | undefined {
49
+ const message = errorMessage?.trim();
50
+ if (!message) return undefined;
51
+ // Idempotent: never double-prefix an already-normalized message.
52
+ if (message.includes(CURSOR_OVERFLOW_MARKER)) return undefined;
53
+ if (CURSOR_THROTTLE_PATTERN.test(message)) return undefined;
54
+ if (CURSOR_OVERFLOW_PATTERNS.some((pattern) => pattern.test(message))) {
55
+ return `${CURSOR_OVERFLOW_MARKER}: ${message}`;
56
+ }
57
+ return undefined;
58
+ }
59
+
60
+ /**
61
+ * Rewrite a finalized assistant message into pi's overflow form when it is a
62
+ * Cursor context-overflow failure. Returns the replacement message (for the
63
+ * `message_end` result) or `undefined` to leave it unchanged.
64
+ *
65
+ * `isCursorProvider` carries the provider scoping decision out of the handler so
66
+ * the full logic is unit-testable without a pi event harness.
67
+ */
68
+ export function rewriteCursorOverflowAssistantMessage(
69
+ message: AssistantMessage,
70
+ isCursorProvider: boolean,
71
+ ): AssistantMessage | undefined {
72
+ if (!isCursorProvider || message.stopReason !== "error") return undefined;
73
+ const rewritten = normalizeCursorOverflowErrorMessage(message.errorMessage);
74
+ if (!rewritten) return undefined;
75
+ return { ...message, errorMessage: rewritten };
76
+ }
77
+
78
+ export type CursorOverflowExtensionApi = Pick<ExtensionAPI, "on">;
79
+
80
+ /**
81
+ * Register a `message_end` handler that rewrites Cursor context-overflow
82
+ * failures into the `context_length_exceeded` form pi auto-compacts on.
83
+ *
84
+ * Guarded exactly as pi's provider docs require: scoped to the Cursor provider,
85
+ * only for `stopReason === "error"`, never for throttling, and idempotent.
86
+ */
87
+ export function registerCursorOverflowNormalization(pi: CursorOverflowExtensionApi): void {
88
+ pi.on("message_end", (event, ctx) => {
89
+ const message = event.message;
90
+ if (message.role !== "assistant") return undefined;
91
+ const isCursorProvider = message.provider === CURSOR_PROVIDER || ctx.model?.provider === CURSOR_PROVIDER;
92
+ const rewritten = rewriteCursorOverflowAssistantMessage(message, isCursorProvider);
93
+ if (!rewritten) return undefined;
94
+ return { message: rewritten };
95
+ });
96
+ }
@@ -4,7 +4,7 @@ import type { CursorPiToolBridgeSnapshot } from "./cursor-pi-tool-bridge-types.j
4
4
  export const CURSOR_TOOL_MANIFEST_ENV = "PI_CURSOR_TOOL_MANIFEST";
5
5
 
6
6
  /**
7
- * Representative @cursor/sdk@1.0.19 local-agent ToolType values; actual exposure can vary by run.
7
+ * Representative @cursor/sdk@1.0.22 local-agent ToolType values; actual exposure can vary by run.
8
8
  * See docs/cursor-native-tool-replay.md#sdk-tooltype-replay-matrix.
9
9
  */
10
10
  export const CURSOR_HOST_TOOL_MANIFEST_SUMMARY =
package/src/index.ts CHANGED
@@ -11,6 +11,7 @@ import { streamCursorLazy } from "./cursor-provider-lazy.js";
11
11
  import { CURSOR_API_KEY_CONFIG_VALUE } from "./cursor-api-key.js";
12
12
  import { registerCursorFallbackIssueWarning } from "./cursor-fallback-warning.js";
13
13
  import { registerCursorAgentsContextDedup } from "./cursor-agents-context-registration.js";
14
+ import { registerCursorOverflowNormalization } from "./cursor-provider-overflow.js";
14
15
 
15
16
  type CursorExtensionApi =
16
17
  & Pick<ExtensionAPI, "registerProvider" | "registerCommand" | "on">
@@ -22,7 +23,8 @@ type CursorExtensionApi =
22
23
  & Parameters<typeof registerCursorSkillTool>[0]
23
24
  & Parameters<typeof registerCursorPiToolBridge>[0]
24
25
  & Parameters<typeof registerCursorFallbackIssueWarning>[0]
25
- & Parameters<typeof registerCursorAgentsContextDedup>[0];
26
+ & Parameters<typeof registerCursorAgentsContextDedup>[0]
27
+ & Parameters<typeof registerCursorOverflowNormalization>[0];
26
28
 
27
29
  function createCursorProviderConfig(models: ProviderModelConfig[]): ProviderConfig {
28
30
  return {
@@ -53,6 +55,7 @@ export default async function (pi: CursorExtensionApi) {
53
55
  registerCursorSkillTool(pi);
54
56
  registerCursorPiToolBridge(pi);
55
57
  registerCursorAgentsContextDedup(pi);
58
+ registerCursorOverflowNormalization(pi);
56
59
  let fallbackIssue: CursorModelFallbackIssue | undefined;
57
60
  const models = await discoverModels({
58
61
  onFallback: (issue) => {
@@ -1,141 +0,0 @@
1
- # @connectrpc/connect-node
2
-
3
- Connect is a family of libraries for building and consuming APIs on different languages and platforms, and
4
- [@connectrpc/connect](https://www.npmjs.com/package/@connectrpc/connect) brings type-safe APIs with Protobuf to
5
- TypeScript.
6
-
7
- `@connectrpc/connect-node` provides the following adapters for Node.js:
8
-
9
- ### createConnectTransport()
10
-
11
- Lets your clients running on Node.js talk to a server with the Connect protocol:
12
-
13
- ```diff
14
- import { createClient } from "@connectrpc/connect";
15
- + import { createConnectTransport } from "@connectrpc/connect-node";
16
- import { ElizaService } from "./gen/eliza_connect.js";
17
-
18
- + // A transport for clients using the Connect protocol with Node.js `http` module
19
- + const transport = createConnectTransport({
20
- + baseUrl: "https://demo.connectrpc.com",
21
- + httpVersion: "1.1"
22
- + });
23
-
24
- const client = createClient(ElizaService, transport);
25
- const { sentence } = await client.say({ sentence: "I feel happy." });
26
- console.log(sentence) // you said: I feel happy.
27
- ```
28
-
29
- ### createGrpcTransport()
30
-
31
- Lets your clients running on Node.js talk to a server with the gRPC protocol:
32
-
33
- ```diff
34
- import { createClient } from "@connectrpc/connect";
35
- + import { createGrpcTransport } from "@connectrpc/connect-node";
36
- import { ElizaService } from "./gen/eliza_connect.js";
37
-
38
- + // A transport for clients using the gRPC protocol with Node.js `http2` module
39
- + const transport = createGrpcTransport({
40
- + baseUrl: "https://demo.connectrpc.com",
41
- + httpVersion: "2"
42
- + });
43
-
44
- const client = createClient(ElizaService, transport);
45
- const { sentence } = await client.say({ sentence: "I feel happy." });
46
- console.log(sentence) // you said: I feel happy.
47
- ```
48
-
49
- ### createGrpcWebTransport()
50
-
51
- Lets your clients running on Node.js talk to a server with the gRPC-web protocol:
52
-
53
- ```diff
54
- import { createClient } from "@connectrpc/connect";
55
- + import { createGrpcWebTransport } from "@connectrpc/connect-node";
56
- import { ElizaService } from "./gen/eliza_connect.js";
57
-
58
- + // A transport for clients using the Connect protocol with Node.js `http` module
59
- + const transport = createGrpcWebTransport({
60
- + baseUrl: "https://demo.connectrpc.com",
61
- + httpVersion: "1.1"
62
- + });
63
-
64
- const client = createClient(ElizaService, transport);
65
- const { sentence } = await client.say({ sentence: "I feel happy." });
66
- console.log(sentence) // you said: I feel happy.
67
- ```
68
-
69
- ### connectNodeAdapter()
70
-
71
- Run your Connect RPCs on the Node.js `http`, `https`, or `http2` modules.
72
-
73
- ```ts
74
- // connect.ts
75
- import { ConnectRouter } from "@connectrpc/connect";
76
-
77
- export default function (router: ConnectRouter) {
78
- // implement rpc Say(SayRequest) returns (SayResponse)
79
- router.rpc(ElizaService, ElizaService.methods.say, async (req) => ({
80
- sentence: `you said: ${req.sentence}`,
81
- }));
82
- }
83
- ```
84
-
85
- ```diff
86
- // server.ts
87
- import * as http2 from "http2";
88
- + import routes from "connect";
89
- + import { connectNodeAdapter } from "@connectrpc/connect-node";
90
-
91
- http2.createServer(
92
- + connectNodeAdapter({ routes }) // responds with 404 for other requests
93
- ).listen(8080);
94
- ```
95
-
96
- With that server running, you can make requests with any gRPC, gRPC-Web, or Connect client.
97
-
98
- `buf curl` with the gRPC protocol:
99
-
100
- ```bash
101
- buf curl --schema buf.build/connectrpc/eliza \
102
- --protocol grpc --http2-prior-knowledge \
103
- -d '{"sentence": "I feel happy."}' \
104
- http://localhost:8080/connectrpc.eliza.v1.ElizaService/Say
105
- ```
106
-
107
- `curl` with the Connect protocol:
108
-
109
- ```bash
110
- curl \
111
- --header "Content-Type: application/json" \
112
- --data '{"sentence": "I feel happy."}' \
113
- --http2-prior-knowledge \
114
- http://localhost:8080/connectrpc.eliza.v1.ElizaService/Say
115
- ```
116
-
117
- Node.js with the gRPC protocol:
118
-
119
- ```ts
120
- import { createClient } from "@connectrpc/connect";
121
- import { createGrpcTransport } from "@connectrpc/connect-node";
122
- import { ElizaService } from "./gen/eliza_connect.js";
123
-
124
- const transport = createGrpcTransport({
125
- baseUrl: "http://localhost:8080",
126
- httpVersion: "2",
127
- });
128
-
129
- const client = createClient(ElizaService, transport);
130
- const { sentence } = await client.say({ sentence: "I feel happy." });
131
- console.log(sentence); // you said: I feel happy.
132
- ```
133
-
134
- A client for the web browser actually looks identical to this example - it would
135
- simply use `createConnectTransport` from [@connectrpc/connect-web](https://www.npmjs.com/package/@connectrpc/connect-web)
136
- instead.
137
-
138
- ## Getting started
139
-
140
- To get started with Connect, head over to the [docs](https://connectrpc.com/docs/node/getting-started)
141
- for a tutorial, or take a look at [our example](https://github.com/connectrpc/connect-es/tree/main/packages/example).
@@ -1,15 +0,0 @@
1
- import type { Compression } from "@connectrpc/connect/protocol";
2
- /**
3
- * The gzip compression algorithm, implemented with the Node.js built-in module
4
- * zlib. This value can be used for the `sendCompression` and `acceptCompression`
5
- * option of client transports, or for the `acceptCompression` option of server
6
- * plugins like `fastifyConnectPlugin` from @connectrpc/connect-fastify.
7
- */
8
- export declare const compressionGzip: Compression;
9
- /**
10
- * The brotli compression algorithm, implemented with the Node.js built-in module
11
- * zlib. This value can be used for the `sendCompression` and `acceptCompression`
12
- * option of client transports, or for the `acceptCompression` option of server
13
- * plugins like `fastifyConnectPlugin` from @connectrpc/connect-fastify.
14
- */
15
- export declare const compressionBrotli: Compression;
@@ -1,89 +0,0 @@
1
- "use strict";
2
- // Copyright 2021-2024 The Connect Authors
3
- //
4
- // Licensed under the Apache License, Version 2.0 (the "License");
5
- // you may not use this file except in compliance with the License.
6
- // You may obtain a copy of the License at
7
- //
8
- // http://www.apache.org/licenses/LICENSE-2.0
9
- //
10
- // Unless required by applicable law or agreed to in writing, software
11
- // distributed under the License is distributed on an "AS IS" BASIS,
12
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- // See the License for the specific language governing permissions and
14
- // limitations under the License.
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.compressionBrotli = exports.compressionGzip = void 0;
17
- const zlib = require("zlib");
18
- const util_1 = require("util");
19
- const connect_1 = require("@connectrpc/connect");
20
- const node_error_js_1 = require("./node-error.js");
21
- const gzip = (0, util_1.promisify)(zlib.gzip);
22
- const gunzip = (0, util_1.promisify)(zlib.gunzip);
23
- const brotliCompress = (0, util_1.promisify)(zlib.brotliCompress);
24
- const brotliDecompress = (0, util_1.promisify)(zlib.brotliDecompress);
25
- /**
26
- * The gzip compression algorithm, implemented with the Node.js built-in module
27
- * zlib. This value can be used for the `sendCompression` and `acceptCompression`
28
- * option of client transports, or for the `acceptCompression` option of server
29
- * plugins like `fastifyConnectPlugin` from @connectrpc/connect-fastify.
30
- */
31
- exports.compressionGzip = {
32
- name: "gzip",
33
- compress(bytes) {
34
- return gzip(bytes, {});
35
- },
36
- decompress(bytes, readMaxBytes) {
37
- if (bytes.length == 0) {
38
- return Promise.resolve(new Uint8Array(0));
39
- }
40
- return wrapZLibErrors(gunzip(bytes, {
41
- maxOutputLength: readMaxBytes,
42
- }), readMaxBytes);
43
- },
44
- };
45
- /**
46
- * The brotli compression algorithm, implemented with the Node.js built-in module
47
- * zlib. This value can be used for the `sendCompression` and `acceptCompression`
48
- * option of client transports, or for the `acceptCompression` option of server
49
- * plugins like `fastifyConnectPlugin` from @connectrpc/connect-fastify.
50
- */
51
- exports.compressionBrotli = {
52
- name: "br",
53
- compress(bytes) {
54
- return brotliCompress(bytes, {});
55
- },
56
- decompress(bytes, readMaxBytes) {
57
- if (bytes.length == 0) {
58
- return Promise.resolve(new Uint8Array(0));
59
- }
60
- return wrapZLibErrors(brotliDecompress(bytes, {
61
- maxOutputLength: readMaxBytes,
62
- }), readMaxBytes);
63
- },
64
- };
65
- function wrapZLibErrors(promise, readMaxBytes) {
66
- return promise.catch((e) => {
67
- const props = (0, node_error_js_1.getNodeErrorProps)(e);
68
- let code = connect_1.Code.Internal;
69
- let message = "decompression failed";
70
- // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check
71
- switch (props.code) {
72
- case "ERR_BUFFER_TOO_LARGE":
73
- code = connect_1.Code.ResourceExhausted;
74
- message = `message is larger than configured readMaxBytes ${readMaxBytes} after decompression`;
75
- break;
76
- case "Z_DATA_ERROR":
77
- case "ERR_PADDING_2":
78
- code = connect_1.Code.InvalidArgument;
79
- break;
80
- default:
81
- if (props.code !== undefined &&
82
- props.code.startsWith("ERR__ERROR_FORMAT_")) {
83
- code = connect_1.Code.InvalidArgument;
84
- }
85
- break;
86
- }
87
- return Promise.reject(new connect_1.ConnectError(message, code, undefined, undefined, e));
88
- });
89
- }
@@ -1,42 +0,0 @@
1
- import type { ConnectRouter, ConnectRouterOptions, ContextValues } from "@connectrpc/connect";
2
- import type { NodeHandlerFn, NodeServerRequest } from "./node-universal-handler.js";
3
- export interface ConnectNodeAdapterOptions extends ConnectRouterOptions {
4
- /**
5
- * Route definitions. We recommend the following pattern:
6
- *
7
- * Create a file `connect.ts` with a default export such as this:
8
- *
9
- * ```ts
10
- * import {ConnectRouter} from "@connectrpc/connect";
11
- *
12
- * export default (router: ConnectRouter) => {
13
- * router.service(ElizaService, {});
14
- * }
15
- * ```
16
- *
17
- * Then pass this function here.
18
- */
19
- routes: (router: ConnectRouter) => void;
20
- /**
21
- * If none of the handler request paths match, a 404 is served. This option
22
- * can provide a custom fallback for this case.
23
- */
24
- fallback?: NodeHandlerFn;
25
- /**
26
- * Serve all handlers under this prefix. For example, the prefix "/something"
27
- * will serve the RPC foo.FooService/Bar under "/something/foo.FooService/Bar".
28
- * Note that many gRPC client implementations do not allow for prefixes.
29
- */
30
- requestPathPrefix?: string;
31
- /**
32
- * Context values to extract from the request. These values are passed to
33
- * the handlers.
34
- */
35
- contextValues?: (req: NodeServerRequest) => ContextValues;
36
- }
37
- /**
38
- * Create a Node.js request handler from a ConnectRouter.
39
- *
40
- * The returned function is compatible with http.RequestListener and its equivalent for http2.
41
- */
42
- export declare function connectNodeAdapter(options: ConnectNodeAdapterOptions): NodeHandlerFn;
@@ -1,61 +0,0 @@
1
- "use strict";
2
- // Copyright 2021-2024 The Connect Authors
3
- //
4
- // Licensed under the Apache License, Version 2.0 (the "License");
5
- // you may not use this file except in compliance with the License.
6
- // You may obtain a copy of the License at
7
- //
8
- // http://www.apache.org/licenses/LICENSE-2.0
9
- //
10
- // Unless required by applicable law or agreed to in writing, software
11
- // distributed under the License is distributed on an "AS IS" BASIS,
12
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- // See the License for the specific language governing permissions and
14
- // limitations under the License.
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.connectNodeAdapter = connectNodeAdapter;
17
- const connect_1 = require("@connectrpc/connect");
18
- const protocol_1 = require("@connectrpc/connect/protocol");
19
- const node_universal_handler_js_1 = require("./node-universal-handler.js");
20
- const compression_js_1 = require("./compression.js");
21
- /**
22
- * Create a Node.js request handler from a ConnectRouter.
23
- *
24
- * The returned function is compatible with http.RequestListener and its equivalent for http2.
25
- */
26
- function connectNodeAdapter(options) {
27
- var _a;
28
- if (options.acceptCompression === undefined) {
29
- options.acceptCompression = [compression_js_1.compressionGzip, compression_js_1.compressionBrotli];
30
- }
31
- const router = (0, connect_1.createConnectRouter)(options);
32
- options.routes(router);
33
- const prefix = (_a = options.requestPathPrefix) !== null && _a !== void 0 ? _a : "";
34
- const paths = new Map();
35
- for (const uHandler of router.handlers) {
36
- paths.set(prefix + uHandler.requestPath, uHandler);
37
- }
38
- return function nodeRequestHandler(req, res) {
39
- var _a, _b, _c, _d;
40
- // Strip the query parameter when matching paths.
41
- const uHandler = paths.get((_b = (_a = req.url) === null || _a === void 0 ? void 0 : _a.split("?", 2)[0]) !== null && _b !== void 0 ? _b : "");
42
- if (!uHandler) {
43
- ((_c = options.fallback) !== null && _c !== void 0 ? _c : fallback)(req, res);
44
- return;
45
- }
46
- const uReq = (0, node_universal_handler_js_1.universalRequestFromNodeRequest)(req, res, undefined, (_d = options.contextValues) === null || _d === void 0 ? void 0 : _d.call(options, req));
47
- uHandler(uReq)
48
- .then((uRes) => (0, node_universal_handler_js_1.universalResponseToNodeResponse)(uRes, res))
49
- .catch((reason) => {
50
- if (connect_1.ConnectError.from(reason).code == connect_1.Code.Aborted) {
51
- return;
52
- }
53
- // eslint-disable-next-line no-console
54
- console.error(`handler for rpc ${uHandler.method.name} of ${uHandler.service.typeName} failed`, reason);
55
- });
56
- };
57
- }
58
- const fallback = (request, response) => {
59
- response.writeHead(protocol_1.uResponseNotFound.status);
60
- response.end();
61
- };
@@ -1,100 +0,0 @@
1
- import type { BinaryReadOptions, BinaryWriteOptions, JsonReadOptions, JsonWriteOptions } from "@bufbuild/protobuf";
2
- import type { Interceptor, Transport } from "@connectrpc/connect";
3
- import type { Compression } from "@connectrpc/connect/protocol";
4
- import type { NodeTransportOptions } from "./node-transport-options.js";
5
- /**
6
- * Options used to configure the Connect transport.
7
- *
8
- * See createConnectTransport().
9
- */
10
- export type ConnectTransportOptions = NodeTransportOptions & {
11
- /**
12
- * Base URI for all HTTP requests.
13
- *
14
- * Requests will be made to <baseUrl>/<package>.<service>/method
15
- *
16
- * Example: `baseUrl: "https://example.com/my-api"`
17
- *
18
- * This will make a `POST /my-api/my_package.MyService/Foo` to
19
- * `example.com` via HTTPS.
20
- */
21
- baseUrl: string;
22
- /**
23
- * By default, connect-node clients use the binary format.
24
- */
25
- useBinaryFormat?: boolean;
26
- /**
27
- * Interceptors that should be applied to all calls running through
28
- * this transport. See the Interceptor type for details.
29
- */
30
- interceptors?: Interceptor[];
31
- /**
32
- * Options for the JSON format.
33
- * By default, unknown fields are ignored.
34
- */
35
- jsonOptions?: Partial<JsonReadOptions & JsonWriteOptions>;
36
- /**
37
- * Options for the binary wire format.
38
- */
39
- binaryOptions?: Partial<BinaryReadOptions & BinaryWriteOptions>;
40
- /**
41
- * Compression algorithms available to a client. Clients ask servers to
42
- * compress responses using any of the registered algorithms. The first
43
- * registered algorithm is the most preferred.
44
- *
45
- * It is safe to use this option liberally: servers will ignore any
46
- * compression algorithms they don't support. To compress requests, pair this
47
- * option with `sendCompression`.
48
- *
49
- * If this option is not provided, the compression algorithms "gzip" and "br"
50
- * (Brotli) are accepted. To opt out of response compression, pass an
51
- * empty array.
52
- */
53
- acceptCompression?: Compression[];
54
- /**
55
- * Configures the client to use the specified algorithm to compress request
56
- * messages.
57
- *
58
- * Because some servers don't support compression, clients default to sending
59
- * uncompressed requests.
60
- */
61
- sendCompression?: Compression;
62
- /**
63
- * Sets a minimum size threshold for compression: Messages that are smaller
64
- * than the configured minimum are sent uncompressed.
65
- *
66
- * The default value is 1 kibibyte, because the CPU cost of compressing very
67
- * small messages usually isn't worth the small reduction in network I/O.
68
- */
69
- compressMinBytes?: number;
70
- /**
71
- * Limits the performance impact of pathologically large messages sent by the
72
- * server. Limits apply to each individual message, not to the stream as a
73
- * whole.
74
- *
75
- * The default limit is the maximum supported value of ~4GiB.
76
- */
77
- readMaxBytes?: number;
78
- /**
79
- * Prevents sending messages too large for the server to handle.
80
- *
81
- * The default limit is the maximum supported value of ~4GiB.
82
- */
83
- writeMaxBytes?: number;
84
- /**
85
- * Controls whether or not Connect GET requests should be used when
86
- * available, on side-effect free methods. Defaults to false.
87
- */
88
- useHttpGet?: boolean;
89
- /**
90
- * The timeout in milliseconds to apply to all requests.
91
- *
92
- * This can be overridden on a per-request basis by passing a timeoutMs.
93
- */
94
- defaultTimeoutMs?: number;
95
- };
96
- /**
97
- * Create a Transport for the Connect protocol using the Node.js `http`, `http2`,
98
- * or `http2` module.
99
- */
100
- export declare function createConnectTransport(options: ConnectTransportOptions): Transport;
@@ -1,25 +0,0 @@
1
- "use strict";
2
- // Copyright 2021-2024 The Connect Authors
3
- //
4
- // Licensed under the Apache License, Version 2.0 (the "License");
5
- // you may not use this file except in compliance with the License.
6
- // You may obtain a copy of the License at
7
- //
8
- // http://www.apache.org/licenses/LICENSE-2.0
9
- //
10
- // Unless required by applicable law or agreed to in writing, software
11
- // distributed under the License is distributed on an "AS IS" BASIS,
12
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- // See the License for the specific language governing permissions and
14
- // limitations under the License.
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.createConnectTransport = createConnectTransport;
17
- const protocol_connect_1 = require("@connectrpc/connect/protocol-connect");
18
- const node_transport_options_js_1 = require("./node-transport-options.js");
19
- /**
20
- * Create a Transport for the Connect protocol using the Node.js `http`, `http2`,
21
- * or `http2` module.
22
- */
23
- function createConnectTransport(options) {
24
- return (0, protocol_connect_1.createTransport)((0, node_transport_options_js_1.validateNodeTransportOptions)(options));
25
- }