@evandu/super-pi-server 0.0.0-stage → 0.1.259

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 (370) hide show
  1. package/README.md +248 -3
  2. package/agents/code-auditor.md +64 -0
  3. package/agents/code-designer.md +64 -0
  4. package/agents/coder.md +24 -0
  5. package/agents/critic.md +24 -0
  6. package/agents/document-organizer.md +48 -0
  7. package/agents/patcher.md +27 -0
  8. package/agents/planner.md +30 -0
  9. package/agents/project-leader.md +28 -0
  10. package/agents/reviewer.md +27 -0
  11. package/agents/scout.md +27 -0
  12. package/agents/solution-designer.md +62 -0
  13. package/agents/super-pi-documents/index.ts +92 -0
  14. package/agents/super-pi-feishu/index.ts +88 -0
  15. package/agents/super-pi-knowledge/index.ts +70 -0
  16. package/agents/super-pi-managed-model/index.ts +9 -0
  17. package/agents/super-pi-memory/index.ts +75 -0
  18. package/agents/super-pi-native-tools/index.ts +1 -0
  19. package/agents/super-pi-task/core.ts +2262 -0
  20. package/agents/super-pi-task/index.ts +814 -0
  21. package/agents/super-pi-task/workflow-schema.ts +34 -0
  22. package/agents/super-pi-web/index.ts +32 -0
  23. package/agents/verifier.md +25 -0
  24. package/assets/fonts/LICENSE +92 -0
  25. package/assets/fonts/NotoSansSC-Bold.otf +0 -0
  26. package/assets/fonts/NotoSansSC-Regular.otf +0 -0
  27. package/assets/knowledge-model/README.md +37 -0
  28. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/config.json +31 -0
  29. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/onnx/model_quantized.onnx +0 -0
  30. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/special_tokens_map.json +7 -0
  31. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/tokenizer.json +21278 -0
  32. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/tokenizer_config.json +15 -0
  33. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/vocab.txt +21128 -0
  34. package/bin/npm-prefix.d.ts +1 -0
  35. package/bin/npm-prefix.js +10 -0
  36. package/bin/super-pi.js +349 -0
  37. package/dist/client/.super-pi-client-sources.json +82 -0
  38. package/dist/client/assets/CodeMirrorEditor-mi9rGUce.js +2 -0
  39. package/dist/client/assets/GitDiffEditor-CpoDDQrA.css +1 -0
  40. package/dist/client/assets/GitDiffEditor-FQBfGxOY.js +29 -0
  41. package/dist/client/assets/diff-ChtP43wD.js +1 -0
  42. package/dist/client/assets/dist-AW5lyI3I.js +1 -0
  43. package/dist/client/assets/dist-B3-a6uF0.js +7 -0
  44. package/dist/client/assets/dist-BGxkyh6e.js +1 -0
  45. package/dist/client/assets/dist-BJxfd7yb.js +11 -0
  46. package/dist/client/assets/dist-BRVQKlcp.js +1 -0
  47. package/dist/client/assets/dist-BV64A9Ji.js +1 -0
  48. package/dist/client/assets/dist-BXAOrsjq.js +1 -0
  49. package/dist/client/assets/dist-CKF2Jksy.js +1 -0
  50. package/dist/client/assets/dist-CX_Hm4GS.js +1 -0
  51. package/dist/client/assets/dist-Cus6_oaF.js +2 -0
  52. package/dist/client/assets/dist-Cx00EZKR.js +23 -0
  53. package/dist/client/assets/dist-D71y2EI1.js +1 -0
  54. package/dist/client/assets/dist-D978o95T.js +5 -0
  55. package/dist/client/assets/dist-Dc1MBGAG.js +1 -0
  56. package/dist/client/assets/dist-Dds-qLxY.js +9 -0
  57. package/dist/client/assets/dist-DeD9copn.js +1 -0
  58. package/dist/client/assets/dist-DuvGReu-.js +6 -0
  59. package/dist/client/assets/dist-Dvb0SqcK.js +2 -0
  60. package/dist/client/assets/dist-J6XWqRpB.js +3 -0
  61. package/dist/client/assets/dist-QzbOCAU6.js +1 -0
  62. package/dist/client/assets/dist-moiMRpw_.js +1 -0
  63. package/dist/client/assets/dist-scBkrwv-.js +2 -0
  64. package/dist/client/assets/dockerfile-BDePf5PZ.js +1 -0
  65. package/dist/client/assets/index-Cn7hdrDw.js +350 -0
  66. package/dist/client/assets/index-UfzqdECL.css +1 -0
  67. package/dist/client/assets/powershell-D8WpQPaX.js +1 -0
  68. package/dist/client/assets/properties-C357ku5U.js +1 -0
  69. package/dist/client/assets/rolldown-runtime-XKyaHtl9.js +1 -0
  70. package/dist/client/assets/ruby-ChfNwlCY.js +1 -0
  71. package/dist/client/assets/shell-DwuoZtxw.js +1 -0
  72. package/dist/client/assets/swift-DKB6_1j6.js +1 -0
  73. package/dist/client/assets/toml-BPTmHmyx.js +1 -0
  74. package/dist/client/favicon.ico +0 -0
  75. package/dist/client/favicon.png +0 -0
  76. package/dist/client/favicon.svg +10 -0
  77. package/dist/client/index.html +18 -0
  78. package/dist/extension.d.ts +15 -0
  79. package/dist/extension.js +126 -0
  80. package/dist/server/active-memory.d.ts +247 -0
  81. package/dist/server/active-memory.js +669 -0
  82. package/dist/server/agents.d.ts +245 -0
  83. package/dist/server/agents.js +701 -0
  84. package/dist/server/application/catalog-service.d.ts +98 -0
  85. package/dist/server/application/catalog-service.js +245 -0
  86. package/dist/server/application/conversation-service.d.ts +245 -0
  87. package/dist/server/application/conversation-service.js +654 -0
  88. package/dist/server/application/document-service.d.ts +68 -0
  89. package/dist/server/application/document-service.js +120 -0
  90. package/dist/server/application/extension-ui-service.d.ts +44 -0
  91. package/dist/server/application/extension-ui-service.js +135 -0
  92. package/dist/server/application/feishu-service.d.ts +179 -0
  93. package/dist/server/application/feishu-service.js +358 -0
  94. package/dist/server/application/group-chat-service.d.ts +75 -0
  95. package/dist/server/application/group-chat-service.js +953 -0
  96. package/dist/server/application/group-execution.d.ts +15 -0
  97. package/dist/server/application/group-execution.js +77 -0
  98. package/dist/server/application/project-service.d.ts +464 -0
  99. package/dist/server/application/project-service.js +2523 -0
  100. package/dist/server/application/provider-service.d.ts +174 -0
  101. package/dist/server/application/provider-service.js +510 -0
  102. package/dist/server/application/run-service.d.ts +547 -0
  103. package/dist/server/application/run-service.js +2683 -0
  104. package/dist/server/application/scheduled-task-service.d.ts +184 -0
  105. package/dist/server/application/scheduled-task-service.js +391 -0
  106. package/dist/server/application/session-orchestrator-service.d.ts +388 -0
  107. package/dist/server/application/session-orchestrator-service.js +1146 -0
  108. package/dist/server/application/session-reminder-service.d.ts +59 -0
  109. package/dist/server/application/session-reminder-service.js +141 -0
  110. package/dist/server/application/session-watchdog.d.ts +171 -0
  111. package/dist/server/application/session-watchdog.js +284 -0
  112. package/dist/server/application/workspace-service.d.ts +52 -0
  113. package/dist/server/application/workspace-service.js +186 -0
  114. package/dist/server/application/worktree-service.d.ts +13 -0
  115. package/dist/server/application/worktree-service.js +76 -0
  116. package/dist/server/browser-access.d.ts +34 -0
  117. package/dist/server/browser-access.js +89 -0
  118. package/dist/server/capability.d.ts +105 -0
  119. package/dist/server/capability.js +170 -0
  120. package/dist/server/command-handler.d.ts +93 -0
  121. package/dist/server/command-handler.js +540 -0
  122. package/dist/server/content-search.d.ts +16 -0
  123. package/dist/server/content-search.js +235 -0
  124. package/dist/server/conversation-usage.d.ts +22 -0
  125. package/dist/server/conversation-usage.js +43 -0
  126. package/dist/server/documents.d.ts +152 -0
  127. package/dist/server/documents.js +998 -0
  128. package/dist/server/engineering-learning.d.ts +30 -0
  129. package/dist/server/engineering-learning.js +106 -0
  130. package/dist/server/exec-service.d.ts +45 -0
  131. package/dist/server/exec-service.js +167 -0
  132. package/dist/server/explicit-file-open.d.ts +34 -0
  133. package/dist/server/explicit-file-open.js +105 -0
  134. package/dist/server/failure-text.d.ts +18 -0
  135. package/dist/server/failure-text.js +44 -0
  136. package/dist/server/feishu-cli.d.ts +223 -0
  137. package/dist/server/feishu-cli.js +464 -0
  138. package/dist/server/file-changes.d.ts +119 -0
  139. package/dist/server/file-changes.js +280 -0
  140. package/dist/server/file-diff.d.ts +41 -0
  141. package/dist/server/file-diff.js +97 -0
  142. package/dist/server/file-index.d.ts +100 -0
  143. package/dist/server/file-index.js +296 -0
  144. package/dist/server/file-name-index.d.ts +160 -0
  145. package/dist/server/file-name-index.js +411 -0
  146. package/dist/server/files.d.ts +269 -0
  147. package/dist/server/files.js +748 -0
  148. package/dist/server/git.d.ts +245 -0
  149. package/dist/server/git.js +903 -0
  150. package/dist/server/http-server.d.ts +45 -0
  151. package/dist/server/http-server.js +3830 -0
  152. package/dist/server/index.d.ts +1 -0
  153. package/dist/server/index.js +485 -0
  154. package/dist/server/inline-thinking.d.ts +90 -0
  155. package/dist/server/inline-thinking.js +181 -0
  156. package/dist/server/json-comments.d.ts +14 -0
  157. package/dist/server/json-comments.js +71 -0
  158. package/dist/server/knowledge-embedding-worker.d.ts +1 -0
  159. package/dist/server/knowledge-embedding-worker.js +27 -0
  160. package/dist/server/knowledge-vectors.d.ts +150 -0
  161. package/dist/server/knowledge-vectors.js +385 -0
  162. package/dist/server/knowledge.d.ts +273 -0
  163. package/dist/server/knowledge.js +848 -0
  164. package/dist/server/length-continuation.d.ts +83 -0
  165. package/dist/server/length-continuation.js +118 -0
  166. package/dist/server/logging.d.ts +32 -0
  167. package/dist/server/logging.js +185 -0
  168. package/dist/server/managed-http-tunnel.d.ts +6 -0
  169. package/dist/server/managed-http-tunnel.js +85 -0
  170. package/dist/server/managed-http.d.ts +4 -0
  171. package/dist/server/managed-http.js +85 -0
  172. package/dist/server/managed-model-adapter.d.ts +17 -0
  173. package/dist/server/managed-model-adapter.js +75 -0
  174. package/dist/server/managed-model-gateway.d.ts +49 -0
  175. package/dist/server/managed-model-gateway.js +73 -0
  176. package/dist/server/managed-servers.d.ts +55 -0
  177. package/dist/server/managed-servers.js +392 -0
  178. package/dist/server/managed-ssh.d.ts +26 -0
  179. package/dist/server/managed-ssh.js +73 -0
  180. package/dist/server/manager-vault.d.ts +11 -0
  181. package/dist/server/manager-vault.js +67 -0
  182. package/dist/server/memory-recall.d.ts +25 -0
  183. package/dist/server/memory-recall.js +45 -0
  184. package/dist/server/memory.d.ts +67 -0
  185. package/dist/server/memory.js +216 -0
  186. package/dist/server/message-media.d.ts +7 -0
  187. package/dist/server/message-media.js +54 -0
  188. package/dist/server/model-context-window.d.ts +186 -0
  189. package/dist/server/model-context-window.js +444 -0
  190. package/dist/server/model-filter.d.ts +23 -0
  191. package/dist/server/model-filter.js +48 -0
  192. package/dist/server/models-store.d.ts +36 -0
  193. package/dist/server/models-store.js +132 -0
  194. package/dist/server/native-tool-settings.d.ts +25 -0
  195. package/dist/server/native-tool-settings.js +41 -0
  196. package/dist/server/native-tools-extension.d.ts +2 -0
  197. package/dist/server/native-tools-extension.js +39 -0
  198. package/dist/server/native-tools-service.d.ts +39 -0
  199. package/dist/server/native-tools-service.js +240 -0
  200. package/dist/server/persistence/app-state-repository.d.ts +65 -0
  201. package/dist/server/persistence/app-state-repository.js +1 -0
  202. package/dist/server/persistence/json-state-repository.d.ts +14 -0
  203. package/dist/server/persistence/json-state-repository.js +43 -0
  204. package/dist/server/persistence/open-state-store.d.ts +3 -0
  205. package/dist/server/persistence/open-state-store.js +35 -0
  206. package/dist/server/persistence/rename.d.ts +22 -0
  207. package/dist/server/persistence/rename.js +44 -0
  208. package/dist/server/persistence/sqlite-state-repository.d.ts +12 -0
  209. package/dist/server/persistence/sqlite-state-repository.js +264 -0
  210. package/dist/server/pi-command.d.ts +94 -0
  211. package/dist/server/pi-command.js +265 -0
  212. package/dist/server/pi-native.d.ts +12 -0
  213. package/dist/server/pi-native.js +16 -0
  214. package/dist/server/pi-session-events.d.ts +158 -0
  215. package/dist/server/pi-session-events.js +373 -0
  216. package/dist/server/pi-session-pool.d.ts +233 -0
  217. package/dist/server/pi-session-pool.js +382 -0
  218. package/dist/server/pi-session.d.ts +642 -0
  219. package/dist/server/pi-session.js +655 -0
  220. package/dist/server/presentations/schema.d.ts +120 -0
  221. package/dist/server/presentations/schema.js +128 -0
  222. package/dist/server/provider-network.d.ts +16 -0
  223. package/dist/server/provider-network.js +106 -0
  224. package/dist/server/provider-proxy.d.ts +18 -0
  225. package/dist/server/provider-proxy.js +200 -0
  226. package/dist/server/providers.d.ts +333 -0
  227. package/dist/server/providers.js +989 -0
  228. package/dist/server/remote-bootstrap.d.ts +17 -0
  229. package/dist/server/remote-bootstrap.js +119 -0
  230. package/dist/server/rpc-channel.d.ts +131 -0
  231. package/dist/server/rpc-channel.js +135 -0
  232. package/dist/server/runtime.d.ts +1393 -0
  233. package/dist/server/runtime.js +3286 -0
  234. package/dist/server/scheduled-tasks.d.ts +101 -0
  235. package/dist/server/scheduled-tasks.js +138 -0
  236. package/dist/server/server-context.d.ts +119 -0
  237. package/dist/server/server-context.js +1 -0
  238. package/dist/server/session-cwd.d.ts +19 -0
  239. package/dist/server/session-cwd.js +58 -0
  240. package/dist/server/session-ledger.d.ts +67 -0
  241. package/dist/server/session-ledger.js +76 -0
  242. package/dist/server/session-memory-scope.d.ts +4 -0
  243. package/dist/server/session-memory-scope.js +30 -0
  244. package/dist/server/session-repository.d.ts +100 -0
  245. package/dist/server/session-repository.js +246 -0
  246. package/dist/server/session-tree-scope.d.ts +125 -0
  247. package/dist/server/session-tree-scope.js +337 -0
  248. package/dist/server/skills.d.ts +23 -0
  249. package/dist/server/skills.js +190 -0
  250. package/dist/server/store.d.ts +1062 -0
  251. package/dist/server/store.js +3305 -0
  252. package/dist/server/subagent-runs.d.ts +185 -0
  253. package/dist/server/subagent-runs.js +383 -0
  254. package/dist/server/subagents.d.ts +200 -0
  255. package/dist/server/subagents.js +619 -0
  256. package/dist/server/task-tool.d.ts +282 -0
  257. package/dist/server/task-tool.js +507 -0
  258. package/dist/server/tavily.d.ts +32 -0
  259. package/dist/server/tavily.js +136 -0
  260. package/dist/server/team-context.d.ts +12 -0
  261. package/dist/server/team-context.js +180 -0
  262. package/dist/server/terminal.d.ts +163 -0
  263. package/dist/server/terminal.js +557 -0
  264. package/dist/server/thinking-level-discovery.d.ts +38 -0
  265. package/dist/server/thinking-level-discovery.js +183 -0
  266. package/dist/server/time-zone.d.ts +20 -0
  267. package/dist/server/time-zone.js +32 -0
  268. package/dist/server/tool-calls.d.ts +130 -0
  269. package/dist/server/tool-calls.js +341 -0
  270. package/dist/server/tool-llm.d.ts +72 -0
  271. package/dist/server/tool-llm.js +146 -0
  272. package/dist/server/tool-registry.d.ts +129 -0
  273. package/dist/server/tool-registry.js +249 -0
  274. package/dist/server/tool-runner.d.ts +112 -0
  275. package/dist/server/tool-runner.js +306 -0
  276. package/dist/server/turn-failure.d.ts +48 -0
  277. package/dist/server/turn-failure.js +148 -0
  278. package/dist/server/types.d.ts +2315 -0
  279. package/dist/server/types.js +11 -0
  280. package/dist/server/update-status.d.ts +14 -0
  281. package/dist/server/update-status.js +69 -0
  282. package/dist/server/update.d.ts +46 -0
  283. package/dist/server/update.js +104 -0
  284. package/dist/server/upload.d.ts +35 -0
  285. package/dist/server/upload.js +177 -0
  286. package/dist/server/version.d.ts +33 -0
  287. package/dist/server/version.js +111 -0
  288. package/dist/server/web.d.ts +27 -0
  289. package/dist/server/web.js +183 -0
  290. package/dist/server/workflow-engine.d.ts +47 -0
  291. package/dist/server/workflow-engine.js +255 -0
  292. package/dist/server/workflow.d.ts +329 -0
  293. package/dist/server/workflow.js +469 -0
  294. package/dist/server/workspace-file-indexes.d.ts +2 -0
  295. package/dist/server/workspace-file-indexes.js +61 -0
  296. package/dist/server/workspace-file-operations.d.ts +36 -0
  297. package/dist/server/workspace-file-operations.js +281 -0
  298. package/dist/server/workspace-file-response.d.ts +7 -0
  299. package/dist/server/workspace-file-response.js +79 -0
  300. package/dist/server/ws-server.d.ts +149 -0
  301. package/dist/server/ws-server.js +640 -0
  302. package/dist/shared/agent-order.d.ts +44 -0
  303. package/dist/shared/agent-order.js +50 -0
  304. package/dist/shared/archive-decisions.d.ts +44 -0
  305. package/dist/shared/archive-decisions.js +98 -0
  306. package/dist/shared/background-task.d.ts +25 -0
  307. package/dist/shared/background-task.js +183 -0
  308. package/dist/shared/child-session-lock.d.ts +37 -0
  309. package/dist/shared/child-session-lock.js +59 -0
  310. package/dist/shared/content-search.d.ts +22 -0
  311. package/dist/shared/content-search.js +1 -0
  312. package/dist/shared/conversation-title.d.ts +4 -0
  313. package/dist/shared/conversation-title.js +4 -0
  314. package/dist/shared/file-mentions.d.ts +17 -0
  315. package/dist/shared/file-mentions.js +91 -0
  316. package/dist/shared/git-commit.d.ts +11 -0
  317. package/dist/shared/git-commit.js +1 -0
  318. package/dist/shared/git-graph.d.ts +42 -0
  319. package/dist/shared/git-graph.js +30 -0
  320. package/dist/shared/group-chat.d.ts +132 -0
  321. package/dist/shared/group-chat.js +6 -0
  322. package/dist/shared/managed-servers.d.ts +36 -0
  323. package/dist/shared/managed-servers.js +1 -0
  324. package/dist/shared/message-media.d.ts +12 -0
  325. package/dist/shared/message-media.js +27 -0
  326. package/dist/shared/model-window-label.d.ts +39 -0
  327. package/dist/shared/model-window-label.js +55 -0
  328. package/dist/shared/native-tools.d.ts +43 -0
  329. package/dist/shared/native-tools.js +1 -0
  330. package/dist/shared/pi-cache-warming.d.ts +9 -0
  331. package/dist/shared/pi-cache-warming.js +4 -0
  332. package/dist/shared/project-overview.d.ts +107 -0
  333. package/dist/shared/project-overview.js +92 -0
  334. package/dist/shared/project-presentation.d.ts +55 -0
  335. package/dist/shared/project-presentation.js +111 -0
  336. package/dist/shared/provider-network.d.ts +30 -0
  337. package/dist/shared/provider-network.js +1 -0
  338. package/dist/shared/session-reporting.d.ts +40 -0
  339. package/dist/shared/session-reporting.js +97 -0
  340. package/dist/shared/session-search.d.ts +14 -0
  341. package/dist/shared/session-search.js +1 -0
  342. package/dist/shared/team-context-view.d.ts +33 -0
  343. package/dist/shared/team-context-view.js +49 -0
  344. package/dist/shared/team-context.d.ts +59 -0
  345. package/dist/shared/team-context.js +3 -0
  346. package/dist/shared/terminal-protocol.d.ts +71 -0
  347. package/dist/shared/terminal-protocol.js +1 -0
  348. package/dist/shared/thinking-levels.d.ts +53 -0
  349. package/dist/shared/thinking-levels.js +85 -0
  350. package/dist/shared/tool-glyph.d.ts +7 -0
  351. package/dist/shared/tool-glyph.js +19 -0
  352. package/dist/shared/transcript-order.d.ts +7 -0
  353. package/dist/shared/transcript-order.js +12 -0
  354. package/dist/shared/update-status.d.ts +28 -0
  355. package/dist/shared/update-status.js +1 -0
  356. package/dist/shared/workspace-file-preview.d.ts +4 -0
  357. package/dist/shared/workspace-file-preview.js +28 -0
  358. package/package.json +448 -4
  359. package/scripts/diagnose.mjs +603 -0
  360. package/scripts/patch-brace-expansion.mjs +260 -0
  361. package/scripts/restart-server.mjs +104 -0
  362. package/skills/presentation/SKILL.md +30 -0
  363. package/skills/presentation/references/data.md +10 -0
  364. package/skills/presentation/references/quality.md +12 -0
  365. package/skills/presentation/references/story.md +12 -0
  366. package/skills/presentation/references/templates-and-editing.md +11 -0
  367. package/skills/presentation/references/visual-system.md +10 -0
  368. package/skills/super-pi-agent-development/SKILL.md +25 -0
  369. package/skills/super-pi-development/SKILL.md +31 -0
  370. package/skills/super-pi-tool-development/SKILL.md +39 -0
@@ -0,0 +1,183 @@
1
+ import { PI_THINKING_LEVELS } from "../shared/thinking-levels.js";
2
+ /**
3
+ * THE API THE LEVELS BELONG TO, and the one the form means when it says nothing.
4
+ *
5
+ * The form's API list starts with `openai-completions`, and an empty field is that one - which is
6
+ * why an absent API is read as this one rather than as "unknown".
7
+ */
8
+ const DEFAULT_API = "openai-completions";
9
+ /**
10
+ * THE EFFORT NAME Pi KNOWS, AND THE Pi LEVEL IT IS.
11
+ *
12
+ * The provider's `reasoning_effort` values and Pi's levels are the same words, with one addition:
13
+ * OpenAI's `none` is Pi's `off` (thinking switched off, sent as `none`). A value that is not in
14
+ * this table is NOT translated - a provider that calls its levels `ultra` or `high_intensity` gets
15
+ * no map at all rather than a map that guesses what `ultra` means.
16
+ *
17
+ * A MAP, NOT AN OBJECT, because the keys come from a provider's answer. An object literal would
18
+ * answer `EFFORT_TO_LEVEL["constructor"]` with `Object.prototype.constructor` - a function, which
19
+ * is truthy - and `__proto__` with the prototype itself, so a provider that published the word
20
+ * "constructor" would have been believed about a level Pi does not have. A Map has no prototype to
21
+ * inherit from, and `has` asks whether the KEY is one of ours.
22
+ */
23
+ const EFFORT_TO_LEVEL = new Map([
24
+ ["none", "off"],
25
+ ["minimal", "minimal"],
26
+ ["low", "low"],
27
+ ["medium", "medium"],
28
+ ["high", "high"],
29
+ ["xhigh", "xhigh"],
30
+ ["max", "max"],
31
+ ]);
32
+ /**
33
+ * MiniMax's OFFICIAL OpenAI-compatible endpoint.
34
+ *
35
+ * The reference is MiniMax's own documentation for the OpenAI-compatible text API
36
+ * (https://platform.minimax.io/docs/api-reference/text-openai-api), which publishes the base URL
37
+ * `https://api.minimax.io/v1` and the `reasoning_effort` values of `MiniMax-M3.1-Flash`.
38
+ *
39
+ * EXACTLY THIS ORIGIN. A proxy that serves a model called `MiniMax-M3.1-Flash` is a different
40
+ * endpoint with a different answer, and it does not get these levels. The path is part of the
41
+ * match too, because the same host serves other paths - `/anthropic` is a different API with
42
+ * different parameters.
43
+ */
44
+ const MINIMAX_ORIGIN = "https://api.minimax.io";
45
+ /**
46
+ * THE PATHS THAT ARE THE OFFICIAL OPENAI-COMPATIBLE TEXT API.
47
+ *
48
+ * `/v1` is the documented base URL, and `/v1/models` is the URL the model list is actually
49
+ * requested from - the discovery is told which URL ANSWERED, and that is the one that ends in
50
+ * `/models`. The bare origin is the same endpoint with the `/v1` left off.
51
+ */
52
+ const MINIMAX_PATHS = new Set(["", "/v1", "/v1/models"]);
53
+ /** The model MiniMax's documentation names for these levels. */
54
+ const MINIMAX_FLASH_MODEL = "minimax-m3.1-flash";
55
+ /**
56
+ * MiniMax-M3.1-Flash's levels, as its documentation states them: `low`, `medium`, `high`, `xhigh`,
57
+ * `max`, and nothing else. `off` is `null` because the same documentation says `none` is NOT
58
+ * supported and returns 400 - there is no way to switch this model's thinking off.
59
+ *
60
+ * `minimal` is `null` because MiniMax does not publish it. And MiniMax-M3 - the general model -
61
+ * is NOT here: its documentation does not give it these levels, so copying them onto it would be
62
+ * exactly the "copy a same-named model's levels" mistake this file exists to prevent.
63
+ */
64
+ const MINIMAX_FLASH_LEVELS = {
65
+ off: null,
66
+ minimal: null,
67
+ low: "low",
68
+ medium: "medium",
69
+ high: "high",
70
+ xhigh: "xhigh",
71
+ max: "max",
72
+ };
73
+ const KIMI_K31_PRO_MODEL = "kimi-k3.1-pro";
74
+ const KIMI_API_ORIGINS = new Set(["https://api.moonshot.ai", "https://api.moonshot.cn"]);
75
+ const KIMI_API_PATHS = new Set(["", "/v1", "/v1/models"]);
76
+ const KIMI_K31_PRO_LEVELS = {
77
+ off: null,
78
+ minimal: null,
79
+ low: "low",
80
+ medium: null,
81
+ high: "high",
82
+ xhigh: null,
83
+ max: "max",
84
+ };
85
+ /**
86
+ * The official endpoint, or undefined.
87
+ *
88
+ * THE URL THAT ANSWERED, NOT THE ONE THAT WAS ASKED FOR. A fetch follows redirects, so the URL
89
+ * that answered can be a different endpoint from the one in the form - and it is the one that
90
+ * published whatever is being read.
91
+ */
92
+ function officialMinimaxEndpoint(baseUrl) {
93
+ try {
94
+ const parsed = new URL(baseUrl.trim());
95
+ if (parsed.origin !== MINIMAX_ORIGIN)
96
+ return false;
97
+ const path = parsed.pathname.replace(/\/+$/, "");
98
+ return MINIMAX_PATHS.has(path);
99
+ }
100
+ catch {
101
+ return false;
102
+ }
103
+ }
104
+ function officialKimiEndpoint(baseUrl) {
105
+ try {
106
+ const parsed = new URL(baseUrl.trim());
107
+ return KIMI_API_ORIGINS.has(parsed.origin) && KIMI_API_PATHS.has(parsed.pathname.replace(/\/+$/, ""));
108
+ }
109
+ catch {
110
+ return false;
111
+ }
112
+ }
113
+ /**
114
+ * The levels a provider DECLARED for a model, when it declared them properly.
115
+ *
116
+ * THE DECLARATION IS A LIST OF LEVEL NAMES - `supported_reasoning_efforts: ["low","medium","high"]`
117
+ * on the model's own entry in the model list. That is the endpoint naming the values its model
118
+ * accepts, in the parameter's own vocabulary.
119
+ */
120
+ function declaredLevels(entry) {
121
+ const raw = entry.supported_reasoning_efforts;
122
+ if (!Array.isArray(raw))
123
+ return undefined;
124
+ const names = raw
125
+ .filter((value) => typeof value === "string")
126
+ .map((value) => value.trim())
127
+ .filter((value) => value.length > 0);
128
+ // AN EMPTY LIST IS NOT A DECLARATION. It is a field nobody filled in, and reading it as "this
129
+ // model has no levels" would switch off thinking for a model that has it.
130
+ if (!names.length)
131
+ return undefined;
132
+ const found = {};
133
+ for (const name of names) {
134
+ // ONLY THE EXACT NAMES Pi KNOWS. A name that is not one of them is DROPPED, not translated:
135
+ // guessing what a provider means by `ultra` is how a picker ends up offering a level the
136
+ // model does not have.
137
+ const level = EFFORT_TO_LEVEL.get(name);
138
+ if (!level)
139
+ continue;
140
+ found[level] = name;
141
+ }
142
+ if (!Object.keys(found).length)
143
+ return undefined;
144
+ // ALL SEVEN, every one of them. The levels nobody declared are `null`, because Pi enables the
145
+ // ordinary ones when the map is silent about them.
146
+ const map = {};
147
+ for (const level of PI_THINKING_LEVELS)
148
+ map[level] = found[level] ?? null;
149
+ return map;
150
+ }
151
+ /**
152
+ * THE LEVELS A MODEL OFFERS, or `undefined` when nobody said.
153
+ *
154
+ * `undefined` is not "no levels" - it is "nobody said", and the caller keeps whatever behaviour it
155
+ * had. A model that nobody described keeps Pi's own defaults, exactly as before.
156
+ */
157
+ export function discoverThinkingLevels(entry, context) {
158
+ // ONLY THE COMPATIBLE API. A level belongs to the API that published it: the same word means
159
+ // different things over different APIs, so an answer about one is never read as an answer about
160
+ // another. The API the form leaves empty is the default one, which is this one.
161
+ const api = (context.api ?? "").trim() || DEFAULT_API;
162
+ if (api !== DEFAULT_API)
163
+ return undefined;
164
+ // A PAYLOAD THAT SAYS THE MODEL DOES NOT THINK, AND ALSO PUBLISHES LEVELS, CONTRADICTS ITSELF.
165
+ // The explicit answer wins: the levels are dropped, because a map on a model that does not
166
+ // reason would offer levels Pi never shows (it offers `off` and nothing else).
167
+ if (entry.reasoning === false)
168
+ return undefined;
169
+ const declared = declaredLevels(entry);
170
+ if (declared)
171
+ return declared;
172
+ const id = typeof entry.id === "string" ? entry.id.trim().toLowerCase() : "";
173
+ if (id === KIMI_K31_PRO_MODEL && officialKimiEndpoint(context.baseUrl)) {
174
+ return { ...KIMI_K31_PRO_LEVELS };
175
+ }
176
+ // THE OFFICIAL MINIMAX ENDPOINT, AND ONLY THAT ONE - the origin and the path both, because a map
177
+ // is only true of the endpoint it was learned from.
178
+ if (!officialMinimaxEndpoint(context.baseUrl))
179
+ return undefined;
180
+ if (id !== MINIMAX_FLASH_MODEL)
181
+ return undefined;
182
+ return { ...MINIMAX_FLASH_LEVELS };
183
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * THE CLOCK THIS PROCESS SCHEDULES BY.
3
+ *
4
+ * A scheduled task's 「每天 09:00」 is a WALL CLOCK, and the wall clock it means is the one this
5
+ * process runs on - the machine holding the server. The browser that reads the result may be on a
6
+ * different clock entirely, so a moment computed here and rendered there says one thing in one place
7
+ * and another thing in the other.
8
+ *
9
+ * The name is the IANA zone rather than an offset, because an offset is ambiguous twice a year: it
10
+ * does not say whether 「09:00」 is the summer or the winter offset, and a task that drifts by an
11
+ * hour twice a year is the kind of bug nobody reports.
12
+ */
13
+ export declare function serverTimeZone(): string;
14
+ /**
15
+ * The zone's short name for the moment, the way a person would say it: 「GMT+8」, 「UTC」.
16
+ *
17
+ * Used in the panel next to a time, so the reader can tell WHICH clock they are looking at without
18
+ * having to know what 「Asia/Shanghai」 means.
19
+ */
20
+ export declare function timeZoneLabel(at?: number): string;
@@ -0,0 +1,32 @@
1
+ /**
2
+ * THE CLOCK THIS PROCESS SCHEDULES BY.
3
+ *
4
+ * A scheduled task's 「每天 09:00」 is a WALL CLOCK, and the wall clock it means is the one this
5
+ * process runs on - the machine holding the server. The browser that reads the result may be on a
6
+ * different clock entirely, so a moment computed here and rendered there says one thing in one place
7
+ * and another thing in the other.
8
+ *
9
+ * The name is the IANA zone rather than an offset, because an offset is ambiguous twice a year: it
10
+ * does not say whether 「09:00」 is the summer or the winter offset, and a task that drifts by an
11
+ * hour twice a year is the kind of bug nobody reports.
12
+ */
13
+ export function serverTimeZone() {
14
+ return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
15
+ }
16
+ /**
17
+ * The zone's short name for the moment, the way a person would say it: 「GMT+8」, 「UTC」.
18
+ *
19
+ * Used in the panel next to a time, so the reader can tell WHICH clock they are looking at without
20
+ * having to know what 「Asia/Shanghai」 means.
21
+ */
22
+ export function timeZoneLabel(at = Date.now()) {
23
+ const zone = serverTimeZone();
24
+ try {
25
+ const parts = new Intl.DateTimeFormat("en-US", { timeZone: zone, timeZoneName: "shortOffset" }).formatToParts(at);
26
+ const name = parts.find((part) => part.type === "timeZoneName")?.value;
27
+ return name ?? zone;
28
+ }
29
+ catch {
30
+ return zone;
31
+ }
32
+ }
@@ -0,0 +1,130 @@
1
+ import type { ToolCallArg, ToolCallQuestion, ToolResultSummary } from "./types.js";
2
+ /**
3
+ * Turning one Pi tool call into something a human reads, and nothing more.
4
+ *
5
+ * WHY THIS IS ITS OWN MODULE. Two drain loops need exactly this derivation - the sub-agent supervisor
6
+ * (`subagents.ts`) and the PRIMARY agent's runtime (`runtime.ts`) - and `subagents.ts` already imports
7
+ * `runtime.ts` for `RpcChannel`, so the reverse import would be a cycle. One definition of "what does
8
+ * this call show" therefore has to live below both of them, or the two surfaces would drift: a `read`
9
+ * labelled by its path on a card and by its working directory on a call block is worse than either.
10
+ *
11
+ * The rule the whole module exists to enforce: DERIVED AND BOUNDED, NEVER COPIED. What Pi sends in
12
+ * `args` is an arbitrary object that may hold a file's contents, a multi-kilobyte patch or an entire
13
+ * shell script. What leaves here is short strings with a hard character cap, or a bare type word.
14
+ */
15
+ /**
16
+ * The longest label one tool call may contribute. See `SubagentToolCall.detail` and `ToolCallBlock.detail`
17
+ * for why the argument is summarised rather than carried: the cap is what makes the bound structural
18
+ * instead of aspirational, because nothing downstream can grow past it.
19
+ */
20
+ export declare const TOOL_DETAIL_CAP = 120;
21
+ /**
22
+ * How many parameters one call block may list.
23
+ *
24
+ * A bound on the COUNT as well as on each value, for the same reason `TOOL_DETAIL_CAP` exists: without
25
+ * it, a tool that Pi sends a dozen arguments to would put twelve rows - and twelve times the cap - into a
26
+ * field that is rewritten on every text delta of the message it belongs to. Six covers every call shape
27
+ * this project has seen (`read`'s path/offset/limit, `bash`'s command/description/timeout) and truncating
28
+ * past it is announced by the caller through the row count rather than silently.
29
+ */
30
+ export declare const TOOL_ARG_CAP = 6;
31
+ /**
32
+ * The longest tool OUTPUT this module lets through, in characters. Eight kilobytes is a screenful of
33
+ * scroll for one call; a `bash` that prints more is still legible because what it found is usually at the
34
+ * end, which is why the cut keeps the tail.
35
+ */
36
+ export declare const TOOL_RESULT_CAP: number;
37
+ /**
38
+ * REDUCE PI'S `tool_execution_end.result` TO WHAT A PERSON READS, or `undefined`.
39
+ *
40
+ * This is the ONLY path from a raw Pi result to anything downstream, and that is the whole reason it is
41
+ * safe for the result to be persisted at all: the untrusted object stops here. Four rules, each for a
42
+ * concrete failure it prevents:
43
+ *
44
+ * 1. TEXT BLOCKS ONLY, IMAGES DROPPED. A `read` of a PNG returns base64 megabytes, and the state file it
45
+ * would land in is rewritten on every text delta of the message it belongs to.
46
+ * 2. THE TAIL, CUT ON A LINE BOUNDARY. Cutting mid-line leaves a final row that is half a sentence and
47
+ * reads as corruption. The tail also beats the head: what a tool just found is at the end.
48
+ * 3. `details.truncation` / `details.fullOutputPath` ARE READ, never inferred. "This was cut" is a fact
49
+ * only Pi knows; deriving it from length would claim Pi truncated something it returned in full.
50
+ * 4. IT RETURNS `undefined` AND NEVER THROWS. These records arrive on an open event family, so a shape
51
+ * this function does not recognise is a fact to decline, not a crash to propagate.
52
+ */
53
+ /**
54
+ * Extract text from a Pi tool result, WITHOUT the 8KB tail-cap.
55
+ *
56
+ * Used for `partialResult` in streaming `tool_execution_update` events, where Pi sends the accumulated
57
+ * output so far and truncating it would discard the head of a long-running command's output.
58
+ * The final result still goes through `extractToolResultText` (which applies the cap) because that
59
+ * is what gets persisted into `state.json`.
60
+ */
61
+ export declare function extractPartialResultText(result: unknown): string | undefined;
62
+ export declare function extractToolResultText(result: unknown): ToolResultSummary | undefined;
63
+ /**
64
+ * The one line that tells a reader what a tool call was FOR: the file it opened, the pattern it searched
65
+ * for, the command it ran.
66
+ *
67
+ * Returns `undefined` rather than a placeholder when nothing is recognised, so a row omits the column
68
+ * instead of rendering a column of emptiness.
69
+ *
70
+ * Exported so the mapping can be asserted without spawning a child, which is the only way a table this
71
+ * shape can be regression-tested at all.
72
+ */
73
+ export declare function describeToolCall(name: string, args: unknown): string | undefined;
74
+ /**
75
+ * THE SAME LINE, READ OUT OF A CALL THAT IS STILL BEING WRITTEN.
76
+ *
77
+ * The block for a call appears the instant the model starts writing it, and for an `edit` that is several
78
+ * seconds before the arguments are complete. Showing 「工具 · 正在生成参数…」 through all of it says the
79
+ * reader nothing they can act on - not WHICH tool, and not what it is aimed at, which are the two things
80
+ * the finished block is going to say. So the same `describeToolCall` mapping runs against the fragments
81
+ * that have arrived so far.
82
+ *
83
+ * TWO STEPS, because a partial JSON document almost never parses. The fragments are tried whole first -
84
+ * that is the case where the last one closed the object. Failing that, the FIRST `"key": "value"` pair in
85
+ * the text is read out on its own, and its value does not have to be CLOSED - a fragment usually stops
86
+ * mid-string, and a path that has arrived half-written still says more than a placeholder does. A fragment
87
+ * that has produced neither yet yields `undefined`, and the caller decides what an unknown call says
88
+ * rather than this module inventing a word for it.
89
+ *
90
+ * The pair is read with a pattern rather than by parsing a repaired document: repairing JSON is a parser's
91
+ * job, and a half-repaired document here would risk naming the wrong file - the one thing this line must
92
+ * never do.
93
+ */
94
+ export declare function describeToolCallInProgress(name: string, argumentsSoFar: string): string | undefined;
95
+ /**
96
+ * Every parameter of one call, as a bounded list of `key`/`value` pairs a block can show when expanded.
97
+ *
98
+ * THIS IS THE SAME LINE `describeToolCall` DRAWS, APPLIED PER KEY. `describeToolCall` answers "what was
99
+ * this aimed at" with one label; this answers "what was this given" with the whole bounded list, which is
100
+ * the difference between a row that says `bash` and a block that says which command, plus its timeout
101
+ * and description. Both are derived: a string is whitespace-collapsed and capped at `TOOL_DETAIL_CAP`, and
102
+ * anything that is not a string or a number or a boolean becomes a type word (see `describeShape`).
103
+ *
104
+ * Order is Pi's own key order rather than this module's table order, because once every key is listed the
105
+ * per-tool table has said everything it knows - and a reader scanning a list wants the order the caller
106
+ * wrote it in, not one this file invented.
107
+ *
108
+ * Capped at `TOOL_ARG_CAP` ENTRIES, and the cap is applied by taking the first N rather than by sampling
109
+ * across the object: a truncated tail is a prefix of the real argument list, so what is shown is never
110
+ * a selection that implies the omitted keys did not exist.
111
+ *
112
+ * Returns `undefined` when there is nothing readable at all, so a call with no usable arguments renders
113
+ * no parameter section rather than an empty one.
114
+ */
115
+ export declare function describeToolCallArgs(args: unknown): ToolCallArg[] | undefined;
116
+ /**
117
+ * READS A `question` CALL'S ARGUMENTS INTO THE SHAPE THE TRANSCRIPT RENDERS, OR NOTHING.
118
+ *
119
+ * Both shapes are accepted because the two references differ and both are in the wild: OpenCode sends
120
+ * `questions: [{ question, header, options: [{label, description}], multiple }]`
121
+ * (`packages/core/src/tool/question.ts:25`) and this project's own extension sends
122
+ * `{ question, options: string[], multiple?, extraNote? }`. A question with no options, or options that
123
+ * are not a list of strings, is not a question - so it returns nothing and the call renders as the
124
+ * ordinary tool call it is, rather than as a card with nothing in it.
125
+ *
126
+ * Ids are MINTED HERE when the caller did not send one, and that is what makes the answer pair by
127
+ * identity rather than by position: a person answering question 2 must not be recorded as answering
128
+ * question 1 because one of them was dropped.
129
+ */
130
+ export declare function readQuestionCall(name: string, args: unknown): ToolCallQuestion | undefined;