@vib-rato/ai 0.16.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 (525) hide show
  1. package/CHANGELOG.md +3354 -0
  2. package/README.md +1194 -0
  3. package/dist/types/adapter-internals/provider-safety-stop.d.ts +45 -0
  4. package/dist/types/api-registry.d.ts +30 -0
  5. package/dist/types/auth-broker/client.d.ts +80 -0
  6. package/dist/types/auth-broker/index.d.ts +5 -0
  7. package/dist/types/auth-broker/redact.d.ts +7 -0
  8. package/dist/types/auth-broker/refresher.d.ts +25 -0
  9. package/dist/types/auth-broker/remote-store.d.ts +153 -0
  10. package/dist/types/auth-broker/server.d.ts +32 -0
  11. package/dist/types/auth-broker/types.d.ts +132 -0
  12. package/dist/types/auth-broker/wire-schemas.d.ts +555 -0
  13. package/dist/types/auth-gateway/http.d.ts +40 -0
  14. package/dist/types/auth-gateway/index.d.ts +3 -0
  15. package/dist/types/auth-gateway/server.d.ts +70 -0
  16. package/dist/types/auth-gateway/types.d.ts +129 -0
  17. package/dist/types/auth-storage.d.ts +1074 -0
  18. package/dist/types/cli.d.ts +2 -0
  19. package/dist/types/codex-tools.d.ts +4 -0
  20. package/dist/types/context-cap-policy.d.ts +68 -0
  21. package/dist/types/core.d.ts +35 -0
  22. package/dist/types/index.d.ts +55 -0
  23. package/dist/types/model-cache.d.ts +24 -0
  24. package/dist/types/model-manager.d.ts +77 -0
  25. package/dist/types/model-pricing.d.ts +3 -0
  26. package/dist/types/model-retirements.d.ts +6 -0
  27. package/dist/types/model-thinking.d.ts +100 -0
  28. package/dist/types/models.d.ts +21 -0
  29. package/dist/types/openai-completions-compat.d.ts +34 -0
  30. package/dist/types/provider-details.d.ts +24 -0
  31. package/dist/types/provider-models/bundled-references.d.ts +4 -0
  32. package/dist/types/provider-models/descriptors.d.ts +48 -0
  33. package/dist/types/provider-models/google.d.ts +20 -0
  34. package/dist/types/provider-models/index.d.ts +5 -0
  35. package/dist/types/provider-models/ollama.d.ts +7 -0
  36. package/dist/types/provider-models/openai-compat.d.ts +293 -0
  37. package/dist/types/provider-models/special.d.ts +29 -0
  38. package/dist/types/providers/amazon-bedrock.d.ts +60 -0
  39. package/dist/types/providers/anthropic-messages-server-schema.d.ts +450 -0
  40. package/dist/types/providers/anthropic-messages-server.d.ts +17 -0
  41. package/dist/types/providers/anthropic.d.ts +280 -0
  42. package/dist/types/providers/aws-credential-config.d.ts +19 -0
  43. package/dist/types/providers/aws-credentials.d.ts +43 -0
  44. package/dist/types/providers/aws-eventstream.d.ts +38 -0
  45. package/dist/types/providers/aws-sigv4.d.ts +55 -0
  46. package/dist/types/providers/azure-openai-responses.d.ts +22 -0
  47. package/dist/types/providers/composer-discipline.d.ts +32 -0
  48. package/dist/types/providers/cursor/client-version.d.ts +10 -0
  49. package/dist/types/providers/cursor/exec-modern.d.ts +98 -0
  50. package/dist/types/providers/cursor/gen/agent_pb.d.ts +16769 -0
  51. package/dist/types/providers/cursor-pi-args.d.ts +119 -0
  52. package/dist/types/providers/cursor.d.ts +72 -0
  53. package/dist/types/providers/dashscope-token-plan-headers.d.ts +57 -0
  54. package/dist/types/providers/error-message.d.ts +27 -0
  55. package/dist/types/providers/github-copilot-headers.d.ts +40 -0
  56. package/dist/types/providers/gitlab-duo.d.ts +27 -0
  57. package/dist/types/providers/google-auth.d.ts +26 -0
  58. package/dist/types/providers/google-gemini-cli.d.ts +75 -0
  59. package/dist/types/providers/google-gemini-headers.d.ts +43 -0
  60. package/dist/types/providers/google-shared.d.ts +183 -0
  61. package/dist/types/providers/google-types.d.ts +138 -0
  62. package/dist/types/providers/google-vertex.d.ts +11 -0
  63. package/dist/types/providers/google.d.ts +4 -0
  64. package/dist/types/providers/grammar.d.ts +1 -0
  65. package/dist/types/providers/kimi.d.ts +27 -0
  66. package/dist/types/providers/kiro-api-key.d.ts +50 -0
  67. package/dist/types/providers/kiro-codewhisperer.d.ts +11 -0
  68. package/dist/types/providers/mock.d.ts +189 -0
  69. package/dist/types/providers/ollama.d.ts +41 -0
  70. package/dist/types/providers/openai-anthropic-shim.d.ts +31 -0
  71. package/dist/types/providers/openai-bounded-rate-limits.d.ts +3 -0
  72. package/dist/types/providers/openai-chat-server-schema.d.ts +1733 -0
  73. package/dist/types/providers/openai-chat-server.d.ts +16 -0
  74. package/dist/types/providers/openai-codex/constants.d.ts +26 -0
  75. package/dist/types/providers/openai-codex/request-transformer.d.ts +50 -0
  76. package/dist/types/providers/openai-codex/response-handler.d.ts +18 -0
  77. package/dist/types/providers/openai-codex-responses.d.ts +71 -0
  78. package/dist/types/providers/openai-completions-compat.d.ts +6 -0
  79. package/dist/types/providers/openai-completions.d.ts +35 -0
  80. package/dist/types/providers/openai-opencodex-responses.d.ts +10 -0
  81. package/dist/types/providers/openai-request-transform.d.ts +4 -0
  82. package/dist/types/providers/openai-responses-server-schema.d.ts +392 -0
  83. package/dist/types/providers/openai-responses-server.d.ts +17 -0
  84. package/dist/types/providers/openai-responses-shared.d.ts +106 -0
  85. package/dist/types/providers/openai-responses.d.ts +37 -0
  86. package/dist/types/providers/pi-native-client.d.ts +29 -0
  87. package/dist/types/providers/pi-native-server.d.ts +60 -0
  88. package/dist/types/providers/register-builtins.d.ts +59 -0
  89. package/dist/types/providers/synthetic.d.ts +26 -0
  90. package/dist/types/providers/transform-messages.d.ts +33 -0
  91. package/dist/types/providers/vision-guard.d.ts +8 -0
  92. package/dist/types/rate-limit-utils.d.ts +19 -0
  93. package/dist/types/stream.d.ts +45 -0
  94. package/dist/types/types.d.ts +1073 -0
  95. package/dist/types/usage/claude.d.ts +3 -0
  96. package/dist/types/usage/gemini.d.ts +2 -0
  97. package/dist/types/usage/github-copilot.d.ts +7 -0
  98. package/dist/types/usage/google-antigravity.d.ts +2 -0
  99. package/dist/types/usage/grok-cli.d.ts +17 -0
  100. package/dist/types/usage/kimi.d.ts +4 -0
  101. package/dist/types/usage/minimax-code.d.ts +2 -0
  102. package/dist/types/usage/openai-codex.d.ts +3 -0
  103. package/dist/types/usage/shared.d.ts +1 -0
  104. package/dist/types/usage/zai.d.ts +2 -0
  105. package/dist/types/usage.d.ts +264 -0
  106. package/dist/types/utils/abort.d.ts +19 -0
  107. package/dist/types/utils/anthropic-auth.d.ts +39 -0
  108. package/dist/types/utils/block-symbols.d.ts +6 -0
  109. package/dist/types/utils/discovery/antigravity.d.ts +67 -0
  110. package/dist/types/utils/discovery/codex.d.ts +38 -0
  111. package/dist/types/utils/discovery/cursor.d.ts +49 -0
  112. package/dist/types/utils/discovery/gemini.d.ts +25 -0
  113. package/dist/types/utils/discovery/index.d.ts +4 -0
  114. package/dist/types/utils/discovery/openai-compatible.d.ts +81 -0
  115. package/dist/types/utils/event-stream.d.ts +41 -0
  116. package/dist/types/utils/fallback-transport.d.ts +110 -0
  117. package/dist/types/utils/fireworks-model-id.d.ts +10 -0
  118. package/dist/types/utils/foundry.d.ts +11 -0
  119. package/dist/types/utils/h2-fetch.d.ts +22 -0
  120. package/dist/types/utils/http-inspector.d.ts +59 -0
  121. package/dist/types/utils/idle-iterator.d.ts +122 -0
  122. package/dist/types/utils/json-parse.d.ts +98 -0
  123. package/dist/types/utils/oauth/alibaba-token-plan.d.ts +19 -0
  124. package/dist/types/utils/oauth/anthropic.d.ts +41 -0
  125. package/dist/types/utils/oauth/api-key-login.d.ts +38 -0
  126. package/dist/types/utils/oauth/api-key-validation.d.ts +39 -0
  127. package/dist/types/utils/oauth/bizrouter.d.ts +1 -0
  128. package/dist/types/utils/oauth/callback-server.d.ts +80 -0
  129. package/dist/types/utils/oauth/cerebras.d.ts +1 -0
  130. package/dist/types/utils/oauth/cloudflare-ai-gateway.d.ts +18 -0
  131. package/dist/types/utils/oauth/commandcode.d.ts +1 -0
  132. package/dist/types/utils/oauth/cursor.d.ts +15 -0
  133. package/dist/types/utils/oauth/deepinfra.d.ts +1 -0
  134. package/dist/types/utils/oauth/deepseek.d.ts +10 -0
  135. package/dist/types/utils/oauth/firepass.d.ts +1 -0
  136. package/dist/types/utils/oauth/fireworks.d.ts +1 -0
  137. package/dist/types/utils/oauth/fugu.d.ts +1 -0
  138. package/dist/types/utils/oauth/github-copilot.d.ts +38 -0
  139. package/dist/types/utils/oauth/gitlab-duo.d.ts +3 -0
  140. package/dist/types/utils/oauth/glm-zcode.d.ts +71 -0
  141. package/dist/types/utils/oauth/google-antigravity.d.ts +11 -0
  142. package/dist/types/utils/oauth/google-gemini-cli.d.ts +10 -0
  143. package/dist/types/utils/oauth/google-oauth-shared.d.ts +28 -0
  144. package/dist/types/utils/oauth/huggingface.d.ts +19 -0
  145. package/dist/types/utils/oauth/index.d.ts +39 -0
  146. package/dist/types/utils/oauth/kagi.d.ts +17 -0
  147. package/dist/types/utils/oauth/kilo.d.ts +5 -0
  148. package/dist/types/utils/oauth/kimi.d.ts +17 -0
  149. package/dist/types/utils/oauth/kiro.d.ts +71 -0
  150. package/dist/types/utils/oauth/litellm.d.ts +18 -0
  151. package/dist/types/utils/oauth/lm-studio.d.ts +17 -0
  152. package/dist/types/utils/oauth/mara.d.ts +1 -0
  153. package/dist/types/utils/oauth/minimax-code.d.ts +28 -0
  154. package/dist/types/utils/oauth/moonshot.d.ts +1 -0
  155. package/dist/types/utils/oauth/nanogpt.d.ts +1 -0
  156. package/dist/types/utils/oauth/nvidia.d.ts +18 -0
  157. package/dist/types/utils/oauth/ollama-cloud.d.ts +2 -0
  158. package/dist/types/utils/oauth/ollama.d.ts +18 -0
  159. package/dist/types/utils/oauth/openai-codex.d.ts +21 -0
  160. package/dist/types/utils/oauth/opencode.d.ts +18 -0
  161. package/dist/types/utils/oauth/opengateway.d.ts +1 -0
  162. package/dist/types/utils/oauth/openrouter.d.ts +1 -0
  163. package/dist/types/utils/oauth/parallel.d.ts +17 -0
  164. package/dist/types/utils/oauth/perplexity.d.ts +4 -0
  165. package/dist/types/utils/oauth/pkce.d.ts +8 -0
  166. package/dist/types/utils/oauth/qianfan.d.ts +17 -0
  167. package/dist/types/utils/oauth/qwen-portal.d.ts +19 -0
  168. package/dist/types/utils/oauth/sglang.d.ts +16 -0
  169. package/dist/types/utils/oauth/synthetic.d.ts +1 -0
  170. package/dist/types/utils/oauth/tavily.d.ts +17 -0
  171. package/dist/types/utils/oauth/together.d.ts +1 -0
  172. package/dist/types/utils/oauth/types.d.ts +56 -0
  173. package/dist/types/utils/oauth/venice.d.ts +18 -0
  174. package/dist/types/utils/oauth/vercel-ai-gateway.d.ts +18 -0
  175. package/dist/types/utils/oauth/vllm.d.ts +16 -0
  176. package/dist/types/utils/oauth/xai.d.ts +30 -0
  177. package/dist/types/utils/oauth/xiaomi.d.ts +25 -0
  178. package/dist/types/utils/oauth/zai.d.ts +18 -0
  179. package/dist/types/utils/oauth/zenmux.d.ts +1 -0
  180. package/dist/types/utils/overflow.d.ts +14 -0
  181. package/dist/types/utils/parse-bind.d.ts +26 -0
  182. package/dist/types/utils/provider-response.d.ts +6 -0
  183. package/dist/types/utils/provider-safety-stop.d.ts +8 -0
  184. package/dist/types/utils/proxy.d.ts +7 -0
  185. package/dist/types/utils/retry-after.d.ts +3 -0
  186. package/dist/types/utils/retry-budget.d.ts +1 -0
  187. package/dist/types/utils/retry.d.ts +29 -0
  188. package/dist/types/utils/schema/adapt.d.ts +24 -0
  189. package/dist/types/utils/schema/compatibility.d.ts +30 -0
  190. package/dist/types/utils/schema/dereference.d.ts +11 -0
  191. package/dist/types/utils/schema/draft.d.ts +10 -0
  192. package/dist/types/utils/schema/equality.d.ts +4 -0
  193. package/dist/types/utils/schema/fields.d.ts +49 -0
  194. package/dist/types/utils/schema/index.d.ts +14 -0
  195. package/dist/types/utils/schema/json-schema-validator.d.ts +12 -0
  196. package/dist/types/utils/schema/meta-validator.d.ts +2 -0
  197. package/dist/types/utils/schema/normalize.d.ts +93 -0
  198. package/dist/types/utils/schema/root-combinator.d.ts +12 -0
  199. package/dist/types/utils/schema/spill.d.ts +8 -0
  200. package/dist/types/utils/schema/stamps.d.ts +25 -0
  201. package/dist/types/utils/schema/types.d.ts +4 -0
  202. package/dist/types/utils/schema/wire.d.ts +54 -0
  203. package/dist/types/utils/schema/zod-decontaminate.d.ts +31 -0
  204. package/dist/types/utils/sse-debug.d.ts +10 -0
  205. package/dist/types/utils/tool-call-healing.d.ts +80 -0
  206. package/dist/types/utils/tool-choice-capability.d.ts +57 -0
  207. package/dist/types/utils/tool-choice.d.ts +50 -0
  208. package/dist/types/utils/validation.d.ts +17 -0
  209. package/dist/types/utils.d.ts +117 -0
  210. package/package.json +152 -0
  211. package/src/adapter-internals/provider-safety-stop.d.ts +45 -0
  212. package/src/adapter-internals/provider-safety-stop.ts +156 -0
  213. package/src/api-registry.d.ts +30 -0
  214. package/src/api-registry.ts +96 -0
  215. package/src/auth-broker/client.ts +444 -0
  216. package/src/auth-broker/index.ts +5 -0
  217. package/src/auth-broker/redact.ts +39 -0
  218. package/src/auth-broker/refresher.ts +130 -0
  219. package/src/auth-broker/remote-store.ts +1576 -0
  220. package/src/auth-broker/server.ts +764 -0
  221. package/src/auth-broker/types.ts +164 -0
  222. package/src/auth-broker/wire-schemas.ts +261 -0
  223. package/src/auth-gateway/http.ts +198 -0
  224. package/src/auth-gateway/index.ts +3 -0
  225. package/src/auth-gateway/server.ts +1315 -0
  226. package/src/auth-gateway/types.ts +160 -0
  227. package/src/auth-storage.ts +7312 -0
  228. package/src/cli.ts +269 -0
  229. package/src/codex-tools.d.ts +4 -0
  230. package/src/codex-tools.ts +24 -0
  231. package/src/context-cap-policy.d.ts +68 -0
  232. package/src/context-cap-policy.ts +123 -0
  233. package/src/core.ts +44 -0
  234. package/src/index.ts +61 -0
  235. package/src/model-cache.ts +236 -0
  236. package/src/model-manager.ts +744 -0
  237. package/src/model-pricing.d.ts +3 -0
  238. package/src/model-pricing.ts +68 -0
  239. package/src/model-retirements.d.ts +6 -0
  240. package/src/model-retirements.ts +19 -0
  241. package/src/model-thinking.d.ts +100 -0
  242. package/src/model-thinking.ts +1054 -0
  243. package/src/models.d.ts +21 -0
  244. package/src/models.json +94672 -0
  245. package/src/models.json.d.ts +9 -0
  246. package/src/models.ts +126 -0
  247. package/src/openai-completions-compat.d.ts +34 -0
  248. package/src/openai-completions-compat.ts +383 -0
  249. package/src/prompts/composer-bash-policy-recovery.md +1 -0
  250. package/src/prompts/cursor-composer-bash-policy-recovery.md +1 -0
  251. package/src/prompts/cursor-composer-edit-discipline.md +7 -0
  252. package/src/prompts/turn-aborted-guidance.md +4 -0
  253. package/src/provider-details.ts +90 -0
  254. package/src/provider-models/bundled-references.ts +38 -0
  255. package/src/provider-models/descriptors.ts +392 -0
  256. package/src/provider-models/google.ts +92 -0
  257. package/src/provider-models/index.ts +5 -0
  258. package/src/provider-models/ollama.ts +159 -0
  259. package/src/provider-models/openai-compat.ts +2920 -0
  260. package/src/provider-models/special.ts +185 -0
  261. package/src/providers/amazon-bedrock.d.ts +60 -0
  262. package/src/providers/amazon-bedrock.ts +939 -0
  263. package/src/providers/anthropic-messages-server-schema.ts +229 -0
  264. package/src/providers/anthropic-messages-server.ts +839 -0
  265. package/src/providers/anthropic.d.ts +280 -0
  266. package/src/providers/anthropic.ts +4421 -0
  267. package/src/providers/aws-credential-config.d.ts +19 -0
  268. package/src/providers/aws-credential-config.ts +179 -0
  269. package/src/providers/aws-credentials.d.ts +43 -0
  270. package/src/providers/aws-credentials.ts +457 -0
  271. package/src/providers/aws-eventstream.d.ts +38 -0
  272. package/src/providers/aws-eventstream.ts +185 -0
  273. package/src/providers/aws-sigv4.d.ts +55 -0
  274. package/src/providers/aws-sigv4.ts +218 -0
  275. package/src/providers/azure-openai-responses.d.ts +22 -0
  276. package/src/providers/azure-openai-responses.ts +447 -0
  277. package/src/providers/composer-discipline.d.ts +32 -0
  278. package/src/providers/composer-discipline.ts +95 -0
  279. package/src/providers/cursor/client-version.d.ts +10 -0
  280. package/src/providers/cursor/client-version.ts +10 -0
  281. package/src/providers/cursor/exec-modern.d.ts +98 -0
  282. package/src/providers/cursor/exec-modern.ts +497 -0
  283. package/src/providers/cursor/gen/agent_pb.d.ts +16769 -0
  284. package/src/providers/cursor/gen/agent_pb.ts +19780 -0
  285. package/src/providers/cursor/proto/agent.proto +4533 -0
  286. package/src/providers/cursor/proto/buf.gen.yaml +6 -0
  287. package/src/providers/cursor/proto/buf.yaml +17 -0
  288. package/src/providers/cursor-pi-args.d.ts +119 -0
  289. package/src/providers/cursor-pi-args.ts +187 -0
  290. package/src/providers/cursor.d.ts +72 -0
  291. package/src/providers/cursor.ts +3396 -0
  292. package/src/providers/dashscope-token-plan-headers.d.ts +57 -0
  293. package/src/providers/dashscope-token-plan-headers.ts +84 -0
  294. package/src/providers/error-message.d.ts +27 -0
  295. package/src/providers/error-message.ts +21 -0
  296. package/src/providers/github-copilot-headers.d.ts +40 -0
  297. package/src/providers/github-copilot-headers.ts +140 -0
  298. package/src/providers/gitlab-duo.d.ts +27 -0
  299. package/src/providers/gitlab-duo.ts +393 -0
  300. package/src/providers/google-auth.d.ts +26 -0
  301. package/src/providers/google-auth.ts +262 -0
  302. package/src/providers/google-gemini-cli.d.ts +75 -0
  303. package/src/providers/google-gemini-cli.ts +969 -0
  304. package/src/providers/google-gemini-headers.d.ts +43 -0
  305. package/src/providers/google-gemini-headers.ts +100 -0
  306. package/src/providers/google-shared.d.ts +183 -0
  307. package/src/providers/google-shared.ts +1105 -0
  308. package/src/providers/google-types.d.ts +138 -0
  309. package/src/providers/google-types.ts +167 -0
  310. package/src/providers/google-vertex.d.ts +11 -0
  311. package/src/providers/google-vertex.ts +124 -0
  312. package/src/providers/google.d.ts +4 -0
  313. package/src/providers/google.ts +41 -0
  314. package/src/providers/grammar.d.ts +1 -0
  315. package/src/providers/grammar.ts +70 -0
  316. package/src/providers/kimi.d.ts +27 -0
  317. package/src/providers/kimi.ts +52 -0
  318. package/src/providers/kiro-api-key.d.ts +50 -0
  319. package/src/providers/kiro-api-key.ts +786 -0
  320. package/src/providers/kiro-codewhisperer.d.ts +11 -0
  321. package/src/providers/kiro-codewhisperer.ts +600 -0
  322. package/src/providers/mock.ts +526 -0
  323. package/src/providers/ollama.d.ts +41 -0
  324. package/src/providers/ollama.ts +645 -0
  325. package/src/providers/openai-anthropic-shim.d.ts +31 -0
  326. package/src/providers/openai-anthropic-shim.ts +156 -0
  327. package/src/providers/openai-bounded-rate-limits.d.ts +3 -0
  328. package/src/providers/openai-bounded-rate-limits.ts +57 -0
  329. package/src/providers/openai-chat-server-schema.ts +254 -0
  330. package/src/providers/openai-chat-server.ts +724 -0
  331. package/src/providers/openai-codex/constants.d.ts +26 -0
  332. package/src/providers/openai-codex/constants.ts +43 -0
  333. package/src/providers/openai-codex/request-transformer.d.ts +50 -0
  334. package/src/providers/openai-codex/request-transformer.ts +219 -0
  335. package/src/providers/openai-codex/response-handler.d.ts +18 -0
  336. package/src/providers/openai-codex/response-handler.ts +111 -0
  337. package/src/providers/openai-codex-responses.d.ts +71 -0
  338. package/src/providers/openai-codex-responses.ts +3288 -0
  339. package/src/providers/openai-completions-compat.d.ts +6 -0
  340. package/src/providers/openai-completions-compat.ts +6 -0
  341. package/src/providers/openai-completions.d.ts +35 -0
  342. package/src/providers/openai-completions.ts +2294 -0
  343. package/src/providers/openai-opencodex-responses.ts +174 -0
  344. package/src/providers/openai-request-transform.d.ts +4 -0
  345. package/src/providers/openai-request-transform.ts +136 -0
  346. package/src/providers/openai-responses-server-schema.ts +290 -0
  347. package/src/providers/openai-responses-server.ts +1268 -0
  348. package/src/providers/openai-responses-shared.d.ts +106 -0
  349. package/src/providers/openai-responses-shared.ts +1253 -0
  350. package/src/providers/openai-responses.d.ts +37 -0
  351. package/src/providers/openai-responses.ts +989 -0
  352. package/src/providers/pi-native-client.d.ts +29 -0
  353. package/src/providers/pi-native-client.ts +243 -0
  354. package/src/providers/pi-native-server.ts +488 -0
  355. package/src/providers/register-builtins.d.ts +59 -0
  356. package/src/providers/register-builtins.ts +544 -0
  357. package/src/providers/synthetic.d.ts +26 -0
  358. package/src/providers/synthetic.ts +50 -0
  359. package/src/providers/transform-messages.d.ts +33 -0
  360. package/src/providers/transform-messages.ts +408 -0
  361. package/src/providers/vision-guard.d.ts +8 -0
  362. package/src/providers/vision-guard.ts +31 -0
  363. package/src/rate-limit-utils.d.ts +19 -0
  364. package/src/rate-limit-utils.ts +102 -0
  365. package/src/stream.d.ts +45 -0
  366. package/src/stream.ts +1306 -0
  367. package/src/types.d.ts +1073 -0
  368. package/src/types.ts +1305 -0
  369. package/src/usage/claude.ts +449 -0
  370. package/src/usage/gemini.ts +250 -0
  371. package/src/usage/github-copilot.ts +421 -0
  372. package/src/usage/google-antigravity.ts +201 -0
  373. package/src/usage/grok-cli.ts +259 -0
  374. package/src/usage/kimi.ts +285 -0
  375. package/src/usage/minimax-code.ts +31 -0
  376. package/src/usage/openai-codex.ts +503 -0
  377. package/src/usage/shared.ts +10 -0
  378. package/src/usage/zai.ts +247 -0
  379. package/src/usage.ts +190 -0
  380. package/src/utils/abort.d.ts +19 -0
  381. package/src/utils/abort.ts +51 -0
  382. package/src/utils/anthropic-auth.ts +95 -0
  383. package/src/utils/block-symbols.d.ts +6 -0
  384. package/src/utils/block-symbols.ts +11 -0
  385. package/src/utils/discovery/antigravity.ts +275 -0
  386. package/src/utils/discovery/codex.ts +362 -0
  387. package/src/utils/discovery/cursor.ts +388 -0
  388. package/src/utils/discovery/gemini.ts +248 -0
  389. package/src/utils/discovery/index.ts +4 -0
  390. package/src/utils/discovery/openai-compatible.ts +379 -0
  391. package/src/utils/event-stream.d.ts +41 -0
  392. package/src/utils/event-stream.ts +269 -0
  393. package/src/utils/fallback-transport.d.ts +110 -0
  394. package/src/utils/fallback-transport.ts +411 -0
  395. package/src/utils/fireworks-model-id.d.ts +10 -0
  396. package/src/utils/fireworks-model-id.ts +30 -0
  397. package/src/utils/foundry.d.ts +11 -0
  398. package/src/utils/foundry.ts +18 -0
  399. package/src/utils/h2-fetch.ts +60 -0
  400. package/src/utils/http-inspector.d.ts +59 -0
  401. package/src/utils/http-inspector.ts +380 -0
  402. package/src/utils/idle-iterator.d.ts +122 -0
  403. package/src/utils/idle-iterator.ts +410 -0
  404. package/src/utils/json-parse.d.ts +98 -0
  405. package/src/utils/json-parse.ts +607 -0
  406. package/src/utils/oauth/alibaba-token-plan.ts +60 -0
  407. package/src/utils/oauth/anthropic.ts +233 -0
  408. package/src/utils/oauth/api-key-login.ts +98 -0
  409. package/src/utils/oauth/api-key-validation.ts +344 -0
  410. package/src/utils/oauth/bizrouter.ts +15 -0
  411. package/src/utils/oauth/callback-server.d.ts +80 -0
  412. package/src/utils/oauth/callback-server.ts +359 -0
  413. package/src/utils/oauth/cerebras.ts +16 -0
  414. package/src/utils/oauth/cloudflare-ai-gateway.ts +48 -0
  415. package/src/utils/oauth/commandcode.ts +17 -0
  416. package/src/utils/oauth/cursor.ts +157 -0
  417. package/src/utils/oauth/deepinfra.ts +15 -0
  418. package/src/utils/oauth/deepseek.ts +53 -0
  419. package/src/utils/oauth/firepass.ts +24 -0
  420. package/src/utils/oauth/fireworks.ts +15 -0
  421. package/src/utils/oauth/fugu.ts +15 -0
  422. package/src/utils/oauth/github-copilot.d.ts +38 -0
  423. package/src/utils/oauth/github-copilot.ts +362 -0
  424. package/src/utils/oauth/gitlab-duo.ts +123 -0
  425. package/src/utils/oauth/glm-zcode.d.ts +71 -0
  426. package/src/utils/oauth/glm-zcode.ts +433 -0
  427. package/src/utils/oauth/google-antigravity.ts +200 -0
  428. package/src/utils/oauth/google-gemini-cli.ts +256 -0
  429. package/src/utils/oauth/google-oauth-shared.ts +110 -0
  430. package/src/utils/oauth/huggingface.ts +62 -0
  431. package/src/utils/oauth/index.ts +558 -0
  432. package/src/utils/oauth/kagi.ts +47 -0
  433. package/src/utils/oauth/kilo.ts +87 -0
  434. package/src/utils/oauth/kimi.d.ts +17 -0
  435. package/src/utils/oauth/kimi.ts +275 -0
  436. package/src/utils/oauth/kiro.ts +448 -0
  437. package/src/utils/oauth/litellm.ts +47 -0
  438. package/src/utils/oauth/lm-studio.ts +38 -0
  439. package/src/utils/oauth/mara.ts +16 -0
  440. package/src/utils/oauth/minimax-code.ts +78 -0
  441. package/src/utils/oauth/moonshot.ts +16 -0
  442. package/src/utils/oauth/nanogpt.ts +15 -0
  443. package/src/utils/oauth/nvidia.ts +70 -0
  444. package/src/utils/oauth/oauth.html +199 -0
  445. package/src/utils/oauth/ollama-cloud.ts +28 -0
  446. package/src/utils/oauth/ollama.ts +47 -0
  447. package/src/utils/oauth/openai-codex.ts +299 -0
  448. package/src/utils/oauth/opencode.ts +49 -0
  449. package/src/utils/oauth/opengateway.ts +15 -0
  450. package/src/utils/oauth/openrouter.ts +16 -0
  451. package/src/utils/oauth/parallel.ts +46 -0
  452. package/src/utils/oauth/perplexity.ts +225 -0
  453. package/src/utils/oauth/pkce.ts +18 -0
  454. package/src/utils/oauth/qianfan.ts +58 -0
  455. package/src/utils/oauth/qwen-portal.ts +60 -0
  456. package/src/utils/oauth/sglang.ts +42 -0
  457. package/src/utils/oauth/synthetic.ts +15 -0
  458. package/src/utils/oauth/tavily.ts +46 -0
  459. package/src/utils/oauth/together.ts +16 -0
  460. package/src/utils/oauth/types.d.ts +56 -0
  461. package/src/utils/oauth/types.ts +122 -0
  462. package/src/utils/oauth/venice.ts +59 -0
  463. package/src/utils/oauth/vercel-ai-gateway.ts +47 -0
  464. package/src/utils/oauth/vllm.ts +42 -0
  465. package/src/utils/oauth/xai.ts +246 -0
  466. package/src/utils/oauth/xiaomi.ts +199 -0
  467. package/src/utils/oauth/zai.ts +60 -0
  468. package/src/utils/oauth/zenmux.ts +15 -0
  469. package/src/utils/overflow.ts +275 -0
  470. package/src/utils/parse-bind.ts +81 -0
  471. package/src/utils/provider-response.d.ts +6 -0
  472. package/src/utils/provider-response.ts +30 -0
  473. package/src/utils/provider-safety-stop.ts +8 -0
  474. package/src/utils/proxy.d.ts +7 -0
  475. package/src/utils/proxy.ts +652 -0
  476. package/src/utils/retry-after.d.ts +3 -0
  477. package/src/utils/retry-after.ts +110 -0
  478. package/src/utils/retry-budget.d.ts +1 -0
  479. package/src/utils/retry-budget.ts +4 -0
  480. package/src/utils/retry.d.ts +29 -0
  481. package/src/utils/retry.ts +67 -0
  482. package/src/utils/schema/CONSTRAINTS.md +164 -0
  483. package/src/utils/schema/adapt.d.ts +24 -0
  484. package/src/utils/schema/adapt.ts +36 -0
  485. package/src/utils/schema/compatibility.d.ts +30 -0
  486. package/src/utils/schema/compatibility.ts +435 -0
  487. package/src/utils/schema/dereference.d.ts +11 -0
  488. package/src/utils/schema/dereference.ts +98 -0
  489. package/src/utils/schema/draft.d.ts +10 -0
  490. package/src/utils/schema/draft.ts +341 -0
  491. package/src/utils/schema/equality.d.ts +4 -0
  492. package/src/utils/schema/equality.ts +97 -0
  493. package/src/utils/schema/fields.d.ts +49 -0
  494. package/src/utils/schema/fields.ts +190 -0
  495. package/src/utils/schema/index.d.ts +14 -0
  496. package/src/utils/schema/index.ts +14 -0
  497. package/src/utils/schema/json-schema-validator.d.ts +12 -0
  498. package/src/utils/schema/json-schema-validator.ts +577 -0
  499. package/src/utils/schema/meta-validator.d.ts +2 -0
  500. package/src/utils/schema/meta-validator.ts +167 -0
  501. package/src/utils/schema/normalize.d.ts +93 -0
  502. package/src/utils/schema/normalize.ts +1588 -0
  503. package/src/utils/schema/root-combinator.d.ts +12 -0
  504. package/src/utils/schema/root-combinator.ts +143 -0
  505. package/src/utils/schema/spill.d.ts +8 -0
  506. package/src/utils/schema/spill.ts +43 -0
  507. package/src/utils/schema/stamps.d.ts +25 -0
  508. package/src/utils/schema/stamps.ts +97 -0
  509. package/src/utils/schema/types.d.ts +4 -0
  510. package/src/utils/schema/types.ts +11 -0
  511. package/src/utils/schema/wire.d.ts +54 -0
  512. package/src/utils/schema/wire.ts +213 -0
  513. package/src/utils/schema/zod-decontaminate.d.ts +31 -0
  514. package/src/utils/schema/zod-decontaminate.ts +331 -0
  515. package/src/utils/sse-debug.d.ts +10 -0
  516. package/src/utils/sse-debug.ts +289 -0
  517. package/src/utils/tool-call-healing.d.ts +80 -0
  518. package/src/utils/tool-call-healing.ts +298 -0
  519. package/src/utils/tool-choice-capability.d.ts +57 -0
  520. package/src/utils/tool-choice-capability.ts +633 -0
  521. package/src/utils/tool-choice.d.ts +50 -0
  522. package/src/utils/tool-choice.ts +99 -0
  523. package/src/utils/validation.ts +1080 -0
  524. package/src/utils.d.ts +117 -0
  525. package/src/utils.ts +523 -0
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Proto builders for the modern Cursor CLI exec frames (`ExecServerMessage`
3
+ * 27-31, 36-38, 40-55).
4
+ *
5
+ * Split out of `cursor.ts` because these are pure `create(...)` shapes with no
6
+ * transport, stream, or block-state coupling: the dispatcher decides *which*
7
+ * answer a frame gets, this module knows *what* that answer looks like on the
8
+ * wire. Every builder returns a result whose oneof case is set — an
9
+ * `ExecClientMessage` carrying a result with an unset oneof is a fake success
10
+ * the server reads as "the tool ran and produced nothing".
11
+ */
12
+ import type { ToolResultMessage } from "../../types";
13
+ import { type ExecuteHookRequest, type ExecuteHookResult, type McpStateExecResult, type McpToolDefinition, type PiBashExecResult, type PiEditExecResult, type PiFindExecResult, type PiGrepExecResult, type PiLsExecResult, type PiReadExecResult, type PiTruncation, type PiWriteExecResult } from "./gen/agent_pb";
14
+ /**
15
+ * The pure arg translation lives in `../cursor-pi-args` so the legacy pi shim
16
+ * can share it without pulling this module's protobuf graph into the bundled
17
+ * virtual registry. Re-exported here because this is where the frame builders
18
+ * and their translation are consumed together.
19
+ */
20
+ export { omitUndefinedArgs, piEscapeRegexLiteral, piGrepSkip, piJoinPath, piLimit, piLsPath, piReadDisplayPath, piReadPath, piReadPathHasRange, piTimeout, } from "../cursor-pi-args";
21
+ /** Flatten a tool result's content into the single `output` string the Pi frames carry. */
22
+ export declare function piOutputText(toolResult: ToolResultMessage): string;
23
+ /**
24
+ * Translate a local tool's truncation summary into `PiTruncation`.
25
+ *
26
+ * Two shapes reach here. `read`/`grep` set `details.truncation`
27
+ * (`TruncationResult`), which carries an explicit `truncated` boolean. `bash`
28
+ * sets `details.meta.truncation` (`TruncationMeta`), which has **no** such
29
+ * flag — its presence *is* the signal, and requiring the boolean silently
30
+ * dropped every Bash truncation, handing Cursor clipped output with no notice
31
+ * that it was clipped.
32
+ *
33
+ * Returns `undefined` when nothing was truncated: the field is `optional` on
34
+ * every Pi success message, and emitting a zeroed `PiTruncation` would tell the
35
+ * server the output was trimmed to nothing.
36
+ */
37
+ export declare function piTruncation(toolResult: ToolResultMessage): PiTruncation | undefined;
38
+ export declare function buildPiReadResult(toolResult: ToolResultMessage): PiReadExecResult;
39
+ export declare function buildPiReadError(error: string): PiReadExecResult;
40
+ export declare function buildPiBashResult(toolResult: ToolResultMessage): PiBashExecResult;
41
+ export declare function buildPiBashError(error: string): PiBashExecResult;
42
+ /**
43
+ * `PiEditExecSuccess` requires `diff` and `patch` alongside `output`. The local
44
+ * `edit` tool reports them under `details`; when it does not, the strings stay
45
+ * empty rather than being faked from the output text.
46
+ */
47
+ export declare function buildPiEditResult(toolResult: ToolResultMessage): PiEditExecResult;
48
+ export declare function buildPiEditError(error: string): PiEditExecResult;
49
+ /**
50
+ * A refusal is not an execution failure: `PiEditExecResult` models them as
51
+ * separate variants, and answering a denied call with `error` reads as "the
52
+ * edit ran and broke", which invites a retry of an operation that was never
53
+ * permitted.
54
+ */
55
+ export declare function buildPiEditRejected(reason: string): PiEditExecResult;
56
+ export declare function buildPiWriteResult(toolResult: ToolResultMessage): PiWriteExecResult;
57
+ export declare function buildPiWriteError(error: string): PiWriteExecResult;
58
+ /** Same variant split as {@link buildPiEditRejected}. */
59
+ export declare function buildPiWriteRejected(reason: string): PiWriteExecResult;
60
+ export declare function buildPiGrepResult(toolResult: ToolResultMessage): PiGrepExecResult;
61
+ export declare function buildPiGrepError(error: string): PiGrepExecResult;
62
+ export declare function buildPiFindResult(toolResult: ToolResultMessage): PiFindExecResult;
63
+ export declare function buildPiFindError(error: string): PiFindExecResult;
64
+ export declare function buildPiLsResult(toolResult: ToolResultMessage): PiLsExecResult;
65
+ export declare function buildPiLsError(error: string): PiLsExecResult;
66
+ /**
67
+ * Answer `mcpStateExecArgs` (frame 36) from the catalog already advertised in
68
+ * `RequestContext.tools`.
69
+ *
70
+ * This client hosts no MCP servers of its own: every forwarded tool is a local
71
+ * pi-agent tool published under a synthetic `providerIdentifier`. Regrouping
72
+ * the same list keeps the server's view of "which servers exist and what do
73
+ * they expose" consistent with what it was told at context time, instead of
74
+ * claiming zero servers while tool calls for them keep arriving.
75
+ *
76
+ * `serverIdentifiers` filters the answer when the server asks about specific
77
+ * servers. `kickOnly` is a restart request — there is nothing to restart, so it
78
+ * is answered with the same state rather than an error.
79
+ */
80
+ export declare function buildMcpStateResult(tools: McpToolDefinition[], serverIdentifiers: readonly string[]): McpStateExecResult;
81
+ /**
82
+ * Build the neutral response for a hook query: the matching response case with
83
+ * every field unset.
84
+ *
85
+ * This client runs no Cursor hooks, and every field of every response variant
86
+ * is `optional` — so an empty response of the right case means "no hook had
87
+ * anything to say", which is exactly true. It is NOT the unset-oneof fake
88
+ * success: the case itself is set, only the payload is empty.
89
+ *
90
+ * `ExecuteHookRequest` and `ExecuteHookResponse` are parallel oneofs whose case
91
+ * names line up, but the two unions are unrelated to the compiler: a `switch`
92
+ * is what makes each pairing individually type-checked, and it forces a
93
+ * deliberate branch when a future regen adds a request case.
94
+ *
95
+ * Returns `null` for a request case this build does not model, which the
96
+ * dispatcher answers with `ExecClientThrow` rather than guessing a case.
97
+ */
98
+ export declare function buildNeutralHookResult(request: ExecuteHookRequest | undefined): ExecuteHookResult | null;
@@ -0,0 +1,497 @@
1
+ /**
2
+ * Proto builders for the modern Cursor CLI exec frames (`ExecServerMessage`
3
+ * 27-31, 36-38, 40-55).
4
+ *
5
+ * Split out of `cursor.ts` because these are pure `create(...)` shapes with no
6
+ * transport, stream, or block-state coupling: the dispatcher decides *which*
7
+ * answer a frame gets, this module knows *what* that answer looks like on the
8
+ * wire. Every builder returns a result whose oneof case is set — an
9
+ * `ExecClientMessage` carrying a result with an unset oneof is a fake success
10
+ * the server reads as "the tool ran and produced nothing".
11
+ */
12
+
13
+ import { create } from "@bufbuild/protobuf";
14
+ import type { ToolResultMessage } from "../../types";
15
+ import {
16
+ AfterAgentResponseRequestResponseSchema,
17
+ AfterAgentThoughtRequestResponseSchema,
18
+ BeforeSubmitPromptRequestResponseSchema,
19
+ type ExecuteHookRequest,
20
+ type ExecuteHookResponse,
21
+ ExecuteHookResponseSchema,
22
+ type ExecuteHookResult,
23
+ ExecuteHookResultSchema,
24
+ type McpStateExecResult,
25
+ McpStateExecResultSchema,
26
+ McpStateServerSchema,
27
+ McpStateSuccessSchema,
28
+ type McpToolDefinition,
29
+ PiBashExecErrorSchema,
30
+ type PiBashExecResult,
31
+ PiBashExecResultSchema,
32
+ PiBashExecSuccessSchema,
33
+ PiEditExecErrorSchema,
34
+ PiEditExecRejectedSchema,
35
+ type PiEditExecResult,
36
+ PiEditExecResultSchema,
37
+ PiEditExecSuccessSchema,
38
+ PiFindExecErrorSchema,
39
+ type PiFindExecResult,
40
+ PiFindExecResultSchema,
41
+ PiFindExecSuccessSchema,
42
+ PiGrepExecErrorSchema,
43
+ type PiGrepExecResult,
44
+ PiGrepExecResultSchema,
45
+ PiGrepExecSuccessSchema,
46
+ PiLsExecErrorSchema,
47
+ type PiLsExecResult,
48
+ PiLsExecResultSchema,
49
+ PiLsExecSuccessSchema,
50
+ PiReadExecErrorSchema,
51
+ type PiReadExecResult,
52
+ PiReadExecResultSchema,
53
+ PiReadExecSuccessSchema,
54
+ type PiTruncation,
55
+ PiTruncationSchema,
56
+ PiWriteExecErrorSchema,
57
+ PiWriteExecRejectedSchema,
58
+ type PiWriteExecResult,
59
+ PiWriteExecResultSchema,
60
+ PiWriteExecSuccessSchema,
61
+ PostToolUseFailureRequestResponseSchema,
62
+ PostToolUseRequestResponseSchema,
63
+ PreCompactRequestResponseSchema,
64
+ PreToolUseRequestResponseSchema,
65
+ StopRequestResponseSchema,
66
+ SubagentStartRequestResponseSchema,
67
+ SubagentStopRequestResponseSchema,
68
+ } from "./gen/agent_pb";
69
+
70
+ /**
71
+ * The pure arg translation lives in `../cursor-pi-args` so the legacy pi shim
72
+ * can share it without pulling this module's protobuf graph into the bundled
73
+ * virtual registry. Re-exported here because this is where the frame builders
74
+ * and their translation are consumed together.
75
+ */
76
+ export {
77
+ omitUndefinedArgs,
78
+ piEscapeRegexLiteral,
79
+ piGrepSkip,
80
+ piJoinPath,
81
+ piLimit,
82
+ piLsPath,
83
+ piReadDisplayPath,
84
+ piReadPath,
85
+ piReadPathHasRange,
86
+ piTimeout,
87
+ } from "../cursor-pi-args";
88
+
89
+ /** Flatten a tool result's content into the single `output` string the Pi frames carry. */
90
+ export function piOutputText(toolResult: ToolResultMessage): string {
91
+ return toolResult.content.map(item => (item.type === "text" ? item.text : `[${item.mimeType} image]`)).join("\n");
92
+ }
93
+
94
+ /**
95
+ * Read one field off a tool result's `details` bag, or off a nested object
96
+ * inside it.
97
+ *
98
+ * `details` is `unknown` by design — every tool ships its own shape — so each
99
+ * read is narrowed rather than asserted, and the caller decides what a value of
100
+ * the wrong type means.
101
+ */
102
+ function bagValue(bag: unknown, key: string): unknown {
103
+ if (!bag || typeof bag !== "object" || !(key in bag)) return undefined;
104
+ return Reflect.get(bag, key);
105
+ }
106
+
107
+ /**
108
+ * A positive integer count from `details`, or `undefined`.
109
+ *
110
+ * The Pi frames model their limit counters as `optional uint32`: zero means
111
+ * "the limit was reached at zero results", so a missing, non-numeric, or
112
+ * non-positive value must stay unset rather than be sent as 0.
113
+ */
114
+ function detailCount(toolResult: ToolResultMessage, key: string): number | undefined {
115
+ const value = bagValue(toolResult.details, key);
116
+ return positiveCount(value);
117
+ }
118
+
119
+ function positiveCount(value: unknown): number | undefined {
120
+ return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : undefined;
121
+ }
122
+
123
+ /**
124
+ * The entry cap a listing hit, from either shape a local tool records it in.
125
+ *
126
+ * `glob` sets a flat `details.resultLimitReached` alongside the structured
127
+ * meta; `read` — which serves `pi_ls` — records the cap only through
128
+ * `OutputMeta` at `details.meta.limits.resultLimit.reached`. Reading just the
129
+ * flat field dropped `entry_limit_reached` for every real listing, so Cursor
130
+ * received clipped output with no incompleteness signal.
131
+ */
132
+ function resultLimitReached(toolResult: ToolResultMessage): number | undefined {
133
+ const flat = detailCount(toolResult, "resultLimitReached");
134
+ if (flat !== undefined) return flat;
135
+ const limits = bagValue(bagValue(toolResult.details, "meta"), "limits");
136
+ return positiveCount(bagValue(bagValue(limits, "resultLimit"), "reached"));
137
+ }
138
+
139
+ /**
140
+ * Translate a local tool's truncation summary into `PiTruncation`.
141
+ *
142
+ * Two shapes reach here. `read`/`grep` set `details.truncation`
143
+ * (`TruncationResult`), which carries an explicit `truncated` boolean. `bash`
144
+ * sets `details.meta.truncation` (`TruncationMeta`), which has **no** such
145
+ * flag — its presence *is* the signal, and requiring the boolean silently
146
+ * dropped every Bash truncation, handing Cursor clipped output with no notice
147
+ * that it was clipped.
148
+ *
149
+ * Returns `undefined` when nothing was truncated: the field is `optional` on
150
+ * every Pi success message, and emitting a zeroed `PiTruncation` would tell the
151
+ * server the output was trimmed to nothing.
152
+ */
153
+ export function piTruncation(toolResult: ToolResultMessage): PiTruncation | undefined {
154
+ const direct = bagValue(toolResult.details, "truncation");
155
+ // `TruncationResult` is authoritative when present and explicitly false.
156
+ const truncation = direct !== undefined ? direct : bagValue(bagValue(toolResult.details, "meta"), "truncation");
157
+ if (truncation === undefined || truncation === null) return undefined;
158
+ // `TruncationResult` gates on its flag; `TruncationMeta` has none and is
159
+ // only ever attached when output was actually trimmed.
160
+ const flag = bagValue(truncation, "truncated");
161
+ if (flag !== undefined && flag !== true) return undefined;
162
+ const truncatedBy = bagValue(truncation, "truncatedBy");
163
+ const totalLines = bagValue(truncation, "totalLines");
164
+ const outputLines = bagValue(truncation, "outputLines");
165
+ const outputBytes = bagValue(truncation, "outputBytes");
166
+ return create(PiTruncationSchema, {
167
+ truncated: true,
168
+ truncatedBy: typeof truncatedBy === "string" ? truncatedBy : "",
169
+ totalLines: typeof totalLines === "number" ? totalLines : 0,
170
+ outputLines: typeof outputLines === "number" ? outputLines : 0,
171
+ outputBytes: typeof outputBytes === "number" ? outputBytes : 0,
172
+ firstLineExceedsLimit: bagValue(truncation, "firstLineExceedsLimit") === true,
173
+ lastLinePartial: bagValue(truncation, "lastLinePartial") === true,
174
+ });
175
+ }
176
+
177
+ export function buildPiReadResult(toolResult: ToolResultMessage): PiReadExecResult {
178
+ const text = piOutputText(toolResult);
179
+ if (toolResult.isError) return buildPiReadError(text || "Read failed");
180
+ return create(PiReadExecResultSchema, {
181
+ result: {
182
+ case: "success",
183
+ value: create(PiReadExecSuccessSchema, { output: text, truncation: piTruncation(toolResult) }),
184
+ },
185
+ });
186
+ }
187
+
188
+ export function buildPiReadError(error: string): PiReadExecResult {
189
+ return create(PiReadExecResultSchema, {
190
+ result: { case: "error", value: create(PiReadExecErrorSchema, { error }) },
191
+ });
192
+ }
193
+
194
+ export function buildPiBashResult(toolResult: ToolResultMessage): PiBashExecResult {
195
+ const text = piOutputText(toolResult);
196
+ const truncation = piTruncation(toolResult);
197
+ if (toolResult.isError) {
198
+ return create(PiBashExecResultSchema, {
199
+ result: {
200
+ case: "error",
201
+ value: create(PiBashExecErrorSchema, { error: text || "Command failed", truncation }),
202
+ },
203
+ });
204
+ }
205
+ return create(PiBashExecResultSchema, {
206
+ result: {
207
+ case: "success",
208
+ value: create(PiBashExecSuccessSchema, { output: text, truncation }),
209
+ },
210
+ });
211
+ }
212
+
213
+ export function buildPiBashError(error: string): PiBashExecResult {
214
+ return create(PiBashExecResultSchema, {
215
+ result: { case: "error", value: create(PiBashExecErrorSchema, { error }) },
216
+ });
217
+ }
218
+
219
+ /**
220
+ * `PiEditExecSuccess` requires `diff` and `patch` alongside `output`. The local
221
+ * `edit` tool reports them under `details`; when it does not, the strings stay
222
+ * empty rather than being faked from the output text.
223
+ */
224
+ export function buildPiEditResult(toolResult: ToolResultMessage): PiEditExecResult {
225
+ const text = piOutputText(toolResult);
226
+ if (toolResult.isError) return buildPiEditError(text || "Edit failed");
227
+ const diff = bagValue(toolResult.details, "diff");
228
+ const patch = bagValue(toolResult.details, "patch");
229
+ return create(PiEditExecResultSchema, {
230
+ result: {
231
+ case: "success",
232
+ value: create(PiEditExecSuccessSchema, {
233
+ output: text,
234
+ diff: typeof diff === "string" ? diff : "",
235
+ patch: typeof patch === "string" ? patch : "",
236
+ firstChangedLine: detailCount(toolResult, "firstChangedLine"),
237
+ }),
238
+ },
239
+ });
240
+ }
241
+
242
+ export function buildPiEditError(error: string): PiEditExecResult {
243
+ return create(PiEditExecResultSchema, {
244
+ result: { case: "error", value: create(PiEditExecErrorSchema, { error }) },
245
+ });
246
+ }
247
+
248
+ /**
249
+ * A refusal is not an execution failure: `PiEditExecResult` models them as
250
+ * separate variants, and answering a denied call with `error` reads as "the
251
+ * edit ran and broke", which invites a retry of an operation that was never
252
+ * permitted.
253
+ */
254
+ export function buildPiEditRejected(reason: string): PiEditExecResult {
255
+ return create(PiEditExecResultSchema, {
256
+ result: { case: "rejected", value: create(PiEditExecRejectedSchema, { reason }) },
257
+ });
258
+ }
259
+
260
+ export function buildPiWriteResult(toolResult: ToolResultMessage): PiWriteExecResult {
261
+ const text = piOutputText(toolResult);
262
+ if (toolResult.isError) return buildPiWriteError(text || "Write failed");
263
+ return create(PiWriteExecResultSchema, {
264
+ result: { case: "success", value: create(PiWriteExecSuccessSchema, { output: text }) },
265
+ });
266
+ }
267
+
268
+ export function buildPiWriteError(error: string): PiWriteExecResult {
269
+ return create(PiWriteExecResultSchema, {
270
+ result: { case: "error", value: create(PiWriteExecErrorSchema, { error }) },
271
+ });
272
+ }
273
+
274
+ /** Same variant split as {@link buildPiEditRejected}. */
275
+ export function buildPiWriteRejected(reason: string): PiWriteExecResult {
276
+ return create(PiWriteExecResultSchema, {
277
+ result: { case: "rejected", value: create(PiWriteExecRejectedSchema, { reason }) },
278
+ });
279
+ }
280
+
281
+ export function buildPiGrepResult(toolResult: ToolResultMessage): PiGrepExecResult {
282
+ const text = piOutputText(toolResult);
283
+ if (toolResult.isError) return buildPiGrepError(text || "Grep failed");
284
+ const matchLimitReached = detailCount(toolResult, "perFileLimitReached");
285
+ return create(PiGrepExecResultSchema, {
286
+ result: {
287
+ case: "success",
288
+ value: create(PiGrepExecSuccessSchema, {
289
+ output: text,
290
+ truncation: piTruncation(toolResult) ?? grepInternalCapTruncation(toolResult, text, matchLimitReached),
291
+ matchLimitReached,
292
+ linesTruncated: bagValue(toolResult.details, "linesTruncated") === true,
293
+ }),
294
+ },
295
+ });
296
+ }
297
+
298
+ /**
299
+ * The one grep cap that reaches Cursor through no other field.
300
+ *
301
+ * `GrepTool` folds every cap into the flat `details.truncated`, but only
302
+ * populates `details.truncation` when the output text itself was trimmed and
303
+ * `perFileLimitReached` when a per-file or explicit total cap fired. Its native
304
+ * backend's own ceiling (`INTERNAL_TOTAL_CAP`) sets neither, so a search that
305
+ * hit it answered as an unqualified success over incomplete results — the one
306
+ * failure mode a caller cannot detect and cannot retry around.
307
+ *
308
+ * Only consulted once the specific signals came back empty, so a cap that did
309
+ * report itself is never restated. `totalLines` stays 0: the flat flag says
310
+ * that results were dropped, not how many there were.
311
+ */
312
+ function grepInternalCapTruncation(
313
+ toolResult: ToolResultMessage,
314
+ text: string,
315
+ matchLimitReached: number | undefined,
316
+ ): PiTruncation | undefined {
317
+ if (matchLimitReached !== undefined) return undefined;
318
+ if (bagValue(toolResult.details, "truncated") !== true) return undefined;
319
+ return create(PiTruncationSchema, {
320
+ truncated: true,
321
+ truncatedBy: "matches",
322
+ totalLines: 0,
323
+ outputLines: text ? text.split("\n").length : 0,
324
+ outputBytes: Buffer.byteLength(text, "utf-8"),
325
+ firstLineExceedsLimit: false,
326
+ lastLinePartial: false,
327
+ });
328
+ }
329
+
330
+ export function buildPiGrepError(error: string): PiGrepExecResult {
331
+ return create(PiGrepExecResultSchema, {
332
+ result: { case: "error", value: create(PiGrepExecErrorSchema, { error }) },
333
+ });
334
+ }
335
+
336
+ export function buildPiFindResult(toolResult: ToolResultMessage): PiFindExecResult {
337
+ const text = piOutputText(toolResult);
338
+ if (toolResult.isError) return buildPiFindError(text || "Find failed");
339
+ return create(PiFindExecResultSchema, {
340
+ result: {
341
+ case: "success",
342
+ value: create(PiFindExecSuccessSchema, {
343
+ output: text,
344
+ truncation: piTruncation(toolResult),
345
+ resultLimitReached: resultLimitReached(toolResult),
346
+ }),
347
+ },
348
+ });
349
+ }
350
+
351
+ export function buildPiFindError(error: string): PiFindExecResult {
352
+ return create(PiFindExecResultSchema, {
353
+ result: { case: "error", value: create(PiFindExecErrorSchema, { error }) },
354
+ });
355
+ }
356
+
357
+ export function buildPiLsResult(toolResult: ToolResultMessage): PiLsExecResult {
358
+ const text = piOutputText(toolResult);
359
+ if (toolResult.isError) return buildPiLsError(text || "Ls failed");
360
+ return create(PiLsExecResultSchema, {
361
+ result: {
362
+ case: "success",
363
+ value: create(PiLsExecSuccessSchema, {
364
+ output: text,
365
+ truncation: piTruncation(toolResult),
366
+ entryLimitReached: resultLimitReached(toolResult),
367
+ }),
368
+ },
369
+ });
370
+ }
371
+
372
+ export function buildPiLsError(error: string): PiLsExecResult {
373
+ return create(PiLsExecResultSchema, {
374
+ result: { case: "error", value: create(PiLsExecErrorSchema, { error }) },
375
+ });
376
+ }
377
+
378
+ /**
379
+ * Answer `mcpStateExecArgs` (frame 36) from the catalog already advertised in
380
+ * `RequestContext.tools`.
381
+ *
382
+ * This client hosts no MCP servers of its own: every forwarded tool is a local
383
+ * pi-agent tool published under a synthetic `providerIdentifier`. Regrouping
384
+ * the same list keeps the server's view of "which servers exist and what do
385
+ * they expose" consistent with what it was told at context time, instead of
386
+ * claiming zero servers while tool calls for them keep arriving.
387
+ *
388
+ * `serverIdentifiers` filters the answer when the server asks about specific
389
+ * servers. `kickOnly` is a restart request — there is nothing to restart, so it
390
+ * is answered with the same state rather than an error.
391
+ */
392
+ export function buildMcpStateResult(
393
+ tools: McpToolDefinition[],
394
+ serverIdentifiers: readonly string[],
395
+ ): McpStateExecResult {
396
+ const byProvider = new Map<string, McpToolDefinition[]>();
397
+ for (const tool of tools) {
398
+ const identifier = tool.providerIdentifier;
399
+ const existing = byProvider.get(identifier);
400
+ if (existing) existing.push(tool);
401
+ else byProvider.set(identifier, [tool]);
402
+ }
403
+
404
+ const wanted = serverIdentifiers.length > 0 ? new Set(serverIdentifiers) : undefined;
405
+ const servers = [];
406
+ for (const [identifier, serverTools] of byProvider) {
407
+ if (wanted && !wanted.has(identifier)) continue;
408
+ servers.push(
409
+ create(McpStateServerSchema, {
410
+ serverName: identifier,
411
+ serverIdentifier: identifier,
412
+ tools: serverTools,
413
+ status: "connected",
414
+ }),
415
+ );
416
+ }
417
+
418
+ return create(McpStateExecResultSchema, {
419
+ result: { case: "success", value: create(McpStateSuccessSchema, { servers }) },
420
+ });
421
+ }
422
+
423
+ /**
424
+ * Build the neutral response for a hook query: the matching response case with
425
+ * every field unset.
426
+ *
427
+ * This client runs no Cursor hooks, and every field of every response variant
428
+ * is `optional` — so an empty response of the right case means "no hook had
429
+ * anything to say", which is exactly true. It is NOT the unset-oneof fake
430
+ * success: the case itself is set, only the payload is empty.
431
+ *
432
+ * `ExecuteHookRequest` and `ExecuteHookResponse` are parallel oneofs whose case
433
+ * names line up, but the two unions are unrelated to the compiler: a `switch`
434
+ * is what makes each pairing individually type-checked, and it forces a
435
+ * deliberate branch when a future regen adds a request case.
436
+ *
437
+ * Returns `null` for a request case this build does not model, which the
438
+ * dispatcher answers with `ExecClientThrow` rather than guessing a case.
439
+ */
440
+ export function buildNeutralHookResult(request: ExecuteHookRequest | undefined): ExecuteHookResult | null {
441
+ let response: ExecuteHookResponse;
442
+ switch (request?.request.case) {
443
+ case "preCompact":
444
+ response = create(ExecuteHookResponseSchema, {
445
+ response: { case: "preCompact", value: create(PreCompactRequestResponseSchema, {}) },
446
+ });
447
+ break;
448
+ case "subagentStart":
449
+ response = create(ExecuteHookResponseSchema, {
450
+ response: { case: "subagentStart", value: create(SubagentStartRequestResponseSchema, {}) },
451
+ });
452
+ break;
453
+ case "subagentStop":
454
+ response = create(ExecuteHookResponseSchema, {
455
+ response: { case: "subagentStop", value: create(SubagentStopRequestResponseSchema, {}) },
456
+ });
457
+ break;
458
+ case "preToolUse":
459
+ response = create(ExecuteHookResponseSchema, {
460
+ response: { case: "preToolUse", value: create(PreToolUseRequestResponseSchema, {}) },
461
+ });
462
+ break;
463
+ case "postToolUse":
464
+ response = create(ExecuteHookResponseSchema, {
465
+ response: { case: "postToolUse", value: create(PostToolUseRequestResponseSchema, {}) },
466
+ });
467
+ break;
468
+ case "postToolUseFailure":
469
+ response = create(ExecuteHookResponseSchema, {
470
+ response: { case: "postToolUseFailure", value: create(PostToolUseFailureRequestResponseSchema, {}) },
471
+ });
472
+ break;
473
+ case "beforeSubmitPrompt":
474
+ response = create(ExecuteHookResponseSchema, {
475
+ response: { case: "beforeSubmitPrompt", value: create(BeforeSubmitPromptRequestResponseSchema, {}) },
476
+ });
477
+ break;
478
+ case "afterAgentResponse":
479
+ response = create(ExecuteHookResponseSchema, {
480
+ response: { case: "afterAgentResponse", value: create(AfterAgentResponseRequestResponseSchema, {}) },
481
+ });
482
+ break;
483
+ case "afterAgentThought":
484
+ response = create(ExecuteHookResponseSchema, {
485
+ response: { case: "afterAgentThought", value: create(AfterAgentThoughtRequestResponseSchema, {}) },
486
+ });
487
+ break;
488
+ case "stop":
489
+ response = create(ExecuteHookResponseSchema, {
490
+ response: { case: "stop", value: create(StopRequestResponseSchema, {}) },
491
+ });
492
+ break;
493
+ default:
494
+ return null;
495
+ }
496
+ return create(ExecuteHookResultSchema, { response });
497
+ }