@xixka/dsh-hub 0.2.1-rc.9 → 0.2.2

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 (355) hide show
  1. package/README.md +60 -889
  2. package/lib/accio-adapter.d.ts.map +1 -1
  3. package/lib/accio-adapter.js +3 -1
  4. package/lib/accio-adapter.js.map +1 -1
  5. package/lib/account-pool.d.ts +128 -0
  6. package/lib/account-pool.d.ts.map +1 -1
  7. package/lib/account-pool.js +252 -15
  8. package/lib/account-pool.js.map +1 -1
  9. package/lib/aggregate-adapter.d.ts +38 -0
  10. package/lib/aggregate-adapter.d.ts.map +1 -1
  11. package/lib/aggregate-adapter.js +145 -12
  12. package/lib/aggregate-adapter.js.map +1 -1
  13. package/lib/aggregate-expiry.d.ts.map +1 -1
  14. package/lib/aggregate-expiry.js +4 -0
  15. package/lib/aggregate-expiry.js.map +1 -1
  16. package/lib/analyze-image.d.ts.map +1 -1
  17. package/lib/analyze-image.js.map +1 -1
  18. package/lib/astudio-adapter.d.ts.map +1 -1
  19. package/lib/astudio-adapter.js +3 -1
  20. package/lib/astudio-adapter.js.map +1 -1
  21. package/lib/buddy-adapter.d.ts.map +1 -1
  22. package/lib/buddy-adapter.js +22 -4
  23. package/lib/buddy-adapter.js.map +1 -1
  24. package/lib/buddy.d.ts +7 -2
  25. package/lib/buddy.d.ts.map +1 -1
  26. package/lib/buddy.js +7 -2
  27. package/lib/buddy.js.map +1 -1
  28. package/lib/canonical-models.d.ts.map +1 -1
  29. package/lib/canonical-models.js +20 -0
  30. package/lib/canonical-models.js.map +1 -1
  31. package/lib/chromium-session.d.ts +174 -0
  32. package/lib/chromium-session.d.ts.map +1 -1
  33. package/lib/chromium-session.js +418 -1
  34. package/lib/chromium-session.js.map +1 -1
  35. package/lib/client/jet-hub.js +287 -13918
  36. package/lib/codearts-credits.d.ts +123 -13
  37. package/lib/codearts-credits.d.ts.map +1 -1
  38. package/lib/codearts-credits.js +168 -25
  39. package/lib/codearts-credits.js.map +1 -1
  40. package/lib/codearts-vision.d.ts +95 -4
  41. package/lib/codearts-vision.d.ts.map +1 -1
  42. package/lib/codearts-vision.js +136 -5
  43. package/lib/codearts-vision.js.map +1 -1
  44. package/lib/codely-adapter.d.ts +36 -3
  45. package/lib/codely-adapter.d.ts.map +1 -1
  46. package/lib/codely-adapter.js +252 -11
  47. package/lib/codely-adapter.js.map +1 -1
  48. package/lib/codely-auth-service.d.ts +17 -0
  49. package/lib/codely-auth-service.d.ts.map +1 -1
  50. package/lib/codely-auth-service.js +40 -3
  51. package/lib/codely-auth-service.js.map +1 -1
  52. package/lib/codely-auth.d.ts.map +1 -1
  53. package/lib/codely-auth.js +23 -0
  54. package/lib/codely-auth.js.map +1 -1
  55. package/lib/codely-credits.d.ts.map +1 -1
  56. package/lib/codely-credits.js +18 -1
  57. package/lib/codely-credits.js.map +1 -1
  58. package/lib/codely-product.d.ts +10 -5
  59. package/lib/codely-product.d.ts.map +1 -1
  60. package/lib/codely-product.js +4 -2
  61. package/lib/codely-product.js.map +1 -1
  62. package/lib/credential-resolver.d.ts +41 -1
  63. package/lib/credential-resolver.d.ts.map +1 -1
  64. package/lib/credential-resolver.js +31 -6
  65. package/lib/credential-resolver.js.map +1 -1
  66. package/lib/image-budget.d.ts +3 -11
  67. package/lib/image-budget.d.ts.map +1 -1
  68. package/lib/image-budget.js +43 -5
  69. package/lib/image-budget.js.map +1 -1
  70. package/lib/image-data-cache.d.ts +87 -0
  71. package/lib/image-data-cache.d.ts.map +1 -0
  72. package/lib/image-data-cache.js +144 -0
  73. package/lib/image-data-cache.js.map +1 -0
  74. package/lib/index.d.ts +0 -51
  75. package/lib/index.d.ts.map +1 -1
  76. package/lib/index.js +290 -164
  77. package/lib/index.js.map +1 -1
  78. package/lib/jet-hub-rpc.d.ts +14 -19
  79. package/lib/jet-hub-rpc.d.ts.map +1 -1
  80. package/lib/jet-hub-rpc.js +812 -496
  81. package/lib/jet-hub-rpc.js.map +1 -1
  82. package/lib/jet-hub-store.d.ts +52 -0
  83. package/lib/jet-hub-store.d.ts.map +1 -1
  84. package/lib/jet-hub-store.js +52 -4
  85. package/lib/jet-hub-store.js.map +1 -1
  86. package/lib/llm-adapter.d.ts +96 -5
  87. package/lib/llm-adapter.d.ts.map +1 -1
  88. package/lib/llm-adapter.js +742 -62
  89. package/lib/llm-adapter.js.map +1 -1
  90. package/lib/lobsterai-adapter.d.ts.map +1 -1
  91. package/lib/lobsterai-adapter.js +54 -15
  92. package/lib/lobsterai-adapter.js.map +1 -1
  93. package/lib/login.d.ts +5 -13
  94. package/lib/login.d.ts.map +1 -1
  95. package/lib/login.js +75 -14
  96. package/lib/login.js.map +1 -1
  97. package/lib/loomy-adapter.d.ts +3 -0
  98. package/lib/loomy-adapter.d.ts.map +1 -1
  99. package/lib/loomy-adapter.js +11 -3
  100. package/lib/loomy-adapter.js.map +1 -1
  101. package/lib/loomy-auth.d.ts +51 -0
  102. package/lib/loomy-auth.d.ts.map +1 -1
  103. package/lib/loomy-auth.js +149 -2
  104. package/lib/loomy-auth.js.map +1 -1
  105. package/lib/loomy-oauth.d.ts +44 -0
  106. package/lib/loomy-oauth.d.ts.map +1 -1
  107. package/lib/loomy-oauth.js +48 -1
  108. package/lib/loomy-oauth.js.map +1 -1
  109. package/lib/loomy-sms-login.d.ts +61 -0
  110. package/lib/loomy-sms-login.d.ts.map +1 -0
  111. package/lib/loomy-sms-login.js +330 -0
  112. package/lib/loomy-sms-login.js.map +1 -0
  113. package/lib/loomy.d.ts +22 -0
  114. package/lib/loomy.d.ts.map +1 -1
  115. package/lib/loomy.js +10 -0
  116. package/lib/loomy.js.map +1 -1
  117. package/lib/magicrew-adapter.d.ts +201 -0
  118. package/lib/magicrew-adapter.d.ts.map +1 -0
  119. package/lib/magicrew-adapter.js +595 -0
  120. package/lib/magicrew-adapter.js.map +1 -0
  121. package/lib/magicrew-auth.d.ts +494 -0
  122. package/lib/magicrew-auth.d.ts.map +1 -0
  123. package/lib/magicrew-auth.js +951 -0
  124. package/lib/magicrew-auth.js.map +1 -0
  125. package/lib/magicrew-browser-login.d.ts +333 -0
  126. package/lib/magicrew-browser-login.d.ts.map +1 -0
  127. package/lib/magicrew-browser-login.js +740 -0
  128. package/lib/magicrew-browser-login.js.map +1 -0
  129. package/lib/magicrew-catalog.d.ts +19 -0
  130. package/lib/magicrew-catalog.d.ts.map +1 -0
  131. package/lib/magicrew-catalog.js +80 -0
  132. package/lib/magicrew-catalog.js.map +1 -0
  133. package/lib/magicrew-credits.d.ts +112 -0
  134. package/lib/magicrew-credits.d.ts.map +1 -0
  135. package/lib/magicrew-credits.js +319 -0
  136. package/lib/magicrew-credits.js.map +1 -0
  137. package/lib/magicrew-local-browser.d.ts +123 -0
  138. package/lib/magicrew-local-browser.d.ts.map +1 -0
  139. package/lib/magicrew-local-browser.js +321 -0
  140. package/lib/magicrew-local-browser.js.map +1 -0
  141. package/lib/magicrew-product.d.ts +127 -0
  142. package/lib/magicrew-product.d.ts.map +1 -0
  143. package/lib/magicrew-product.js +159 -0
  144. package/lib/magicrew-product.js.map +1 -0
  145. package/lib/magicrew-profile.d.ts +74 -0
  146. package/lib/magicrew-profile.d.ts.map +1 -0
  147. package/lib/magicrew-profile.js +148 -0
  148. package/lib/magicrew-profile.js.map +1 -0
  149. package/lib/magicrew.d.ts +185 -0
  150. package/lib/magicrew.d.ts.map +1 -0
  151. package/lib/magicrew.js +215 -0
  152. package/lib/magicrew.js.map +1 -0
  153. package/lib/model-catalog.d.ts +8 -0
  154. package/lib/model-catalog.d.ts.map +1 -1
  155. package/lib/model-catalog.js +127 -5
  156. package/lib/model-catalog.js.map +1 -1
  157. package/lib/models.d.ts +216 -32
  158. package/lib/models.d.ts.map +1 -1
  159. package/lib/models.js +500 -47
  160. package/lib/models.js.map +1 -1
  161. package/lib/modelscope-adapter.d.ts.map +1 -1
  162. package/lib/modelscope-adapter.js +7 -2
  163. package/lib/modelscope-adapter.js.map +1 -1
  164. package/lib/modelscope-product.d.ts +44 -6
  165. package/lib/modelscope-product.d.ts.map +1 -1
  166. package/lib/modelscope-product.js +98 -9
  167. package/lib/modelscope-product.js.map +1 -1
  168. package/lib/officeace-adapter.d.ts.map +1 -1
  169. package/lib/officeace-adapter.js +147 -21
  170. package/lib/officeace-adapter.js.map +1 -1
  171. package/lib/officeace-auth.d.ts +15 -0
  172. package/lib/officeace-auth.d.ts.map +1 -1
  173. package/lib/officeace-auth.js +99 -2
  174. package/lib/officeace-auth.js.map +1 -1
  175. package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
  176. package/lib/openai-gateway/tencent-fingerprint.js +28 -3
  177. package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
  178. package/lib/opencode-adapter.d.ts +27 -0
  179. package/lib/opencode-adapter.d.ts.map +1 -1
  180. package/lib/opencode-adapter.js +57 -8
  181. package/lib/opencode-adapter.js.map +1 -1
  182. package/lib/opencode-bun-tls.d.ts +103 -0
  183. package/lib/opencode-bun-tls.d.ts.map +1 -0
  184. package/lib/opencode-bun-tls.js +212 -0
  185. package/lib/opencode-bun-tls.js.map +1 -0
  186. package/lib/opencode-messages.d.ts +0 -19
  187. package/lib/opencode-messages.d.ts.map +1 -1
  188. package/lib/opencode-messages.js +30 -33
  189. package/lib/opencode-messages.js.map +1 -1
  190. package/lib/opencode-official-prompt.d.ts +62 -0
  191. package/lib/opencode-official-prompt.d.ts.map +1 -0
  192. package/lib/opencode-official-prompt.js +119 -0
  193. package/lib/opencode-official-prompt.js.map +1 -0
  194. package/lib/opencode-official-tools.d.ts +27 -0
  195. package/lib/opencode-official-tools.d.ts.map +1 -0
  196. package/lib/opencode-official-tools.js +340 -0
  197. package/lib/opencode-official-tools.js.map +1 -0
  198. package/lib/opencode-product.d.ts.map +1 -1
  199. package/lib/opencode-product.js +3 -2
  200. package/lib/opencode-product.js.map +1 -1
  201. package/lib/opencode-stream.d.ts.map +1 -1
  202. package/lib/opencode-stream.js +8 -7
  203. package/lib/opencode-stream.js.map +1 -1
  204. package/lib/product.d.ts +15 -3
  205. package/lib/product.d.ts.map +1 -1
  206. package/lib/product.js +44 -11
  207. package/lib/product.js.map +1 -1
  208. package/lib/provider-credits.d.ts +2 -0
  209. package/lib/provider-credits.d.ts.map +1 -1
  210. package/lib/provider-credits.js +46 -17
  211. package/lib/provider-credits.js.map +1 -1
  212. package/lib/provider-expiry.d.ts.map +1 -1
  213. package/lib/provider-expiry.js +29 -0
  214. package/lib/provider-expiry.js.map +1 -1
  215. package/lib/provider-http-pool.d.ts +85 -0
  216. package/lib/provider-http-pool.d.ts.map +1 -0
  217. package/lib/provider-http-pool.js +224 -0
  218. package/lib/provider-http-pool.js.map +1 -0
  219. package/lib/provider-registry.d.ts.map +1 -1
  220. package/lib/provider-registry.js +73 -39
  221. package/lib/provider-registry.js.map +1 -1
  222. package/lib/qiniu-adapter.d.ts +276 -0
  223. package/lib/qiniu-adapter.d.ts.map +1 -0
  224. package/lib/qiniu-adapter.js +689 -0
  225. package/lib/qiniu-adapter.js.map +1 -0
  226. package/lib/qiniu-auth.d.ts +130 -0
  227. package/lib/qiniu-auth.d.ts.map +1 -0
  228. package/lib/qiniu-auth.js +234 -0
  229. package/lib/qiniu-auth.js.map +1 -0
  230. package/lib/qiniu-messages.d.ts +96 -0
  231. package/lib/qiniu-messages.d.ts.map +1 -0
  232. package/lib/qiniu-messages.js +97 -0
  233. package/lib/qiniu-messages.js.map +1 -0
  234. package/lib/qiniu-product.d.ts +126 -0
  235. package/lib/qiniu-product.d.ts.map +1 -0
  236. package/lib/qiniu-product.js +269 -0
  237. package/lib/qiniu-product.js.map +1 -0
  238. package/lib/qiniu-rpc.d.ts +119 -0
  239. package/lib/qiniu-rpc.d.ts.map +1 -0
  240. package/lib/qiniu-rpc.js +214 -0
  241. package/lib/qiniu-rpc.js.map +1 -0
  242. package/lib/qiniu.d.ts +145 -0
  243. package/lib/qiniu.d.ts.map +1 -0
  244. package/lib/qiniu.js +164 -0
  245. package/lib/qiniu.js.map +1 -0
  246. package/lib/raccoon-adapter.d.ts +18 -2
  247. package/lib/raccoon-adapter.d.ts.map +1 -1
  248. package/lib/raccoon-adapter.js +154 -21
  249. package/lib/raccoon-adapter.js.map +1 -1
  250. package/lib/raccoon-auth.d.ts +6 -0
  251. package/lib/raccoon-auth.d.ts.map +1 -1
  252. package/lib/raccoon-auth.js +9 -1
  253. package/lib/raccoon-auth.js.map +1 -1
  254. package/lib/raccoon-credits.d.ts +38 -5
  255. package/lib/raccoon-credits.d.ts.map +1 -1
  256. package/lib/raccoon-credits.js +127 -6
  257. package/lib/raccoon-credits.js.map +1 -1
  258. package/lib/raccoon.d.ts +14 -2
  259. package/lib/raccoon.d.ts.map +1 -1
  260. package/lib/raccoon.js +14 -2
  261. package/lib/raccoon.js.map +1 -1
  262. package/lib/service.d.ts +46 -6
  263. package/lib/service.d.ts.map +1 -1
  264. package/lib/service.js +104 -16
  265. package/lib/service.js.map +1 -1
  266. package/lib/session-balance.d.ts +203 -0
  267. package/lib/session-balance.d.ts.map +1 -0
  268. package/lib/session-balance.js +279 -0
  269. package/lib/session-balance.js.map +1 -0
  270. package/lib/sign.d.ts +97 -1
  271. package/lib/sign.d.ts.map +1 -1
  272. package/lib/sign.js +174 -2
  273. package/lib/sign.js.map +1 -1
  274. package/lib/token-ledger-store.d.ts.map +1 -1
  275. package/lib/token-ledger-store.js +121 -27
  276. package/lib/token-ledger-store.js.map +1 -1
  277. package/lib/trae-adapter.d.ts.map +1 -1
  278. package/lib/trae-adapter.js +3 -1
  279. package/lib/trae-adapter.js.map +1 -1
  280. package/lib/types.d.ts +75 -15
  281. package/lib/types.d.ts.map +1 -1
  282. package/lib/types.js.map +1 -1
  283. package/lib/usage-badge.d.ts +77 -7
  284. package/lib/usage-badge.d.ts.map +1 -1
  285. package/lib/usage-badge.js +190 -28
  286. package/lib/usage-badge.js.map +1 -1
  287. package/lib/webdav-auto-sync.d.ts +96 -0
  288. package/lib/webdav-auto-sync.d.ts.map +1 -0
  289. package/lib/webdav-auto-sync.js +0 -0
  290. package/lib/webdav-auto-sync.js.map +1 -0
  291. package/lib/webdav-sync-crypto.d.ts +18 -0
  292. package/lib/webdav-sync-crypto.d.ts.map +1 -0
  293. package/lib/webdav-sync-crypto.js +72 -0
  294. package/lib/webdav-sync-crypto.js.map +1 -0
  295. package/lib/webdav-sync-merge.d.ts +31 -0
  296. package/lib/webdav-sync-merge.d.ts.map +1 -0
  297. package/lib/webdav-sync-merge.js +0 -0
  298. package/lib/webdav-sync-merge.js.map +1 -0
  299. package/lib/webdav-sync.d.ts +43 -7
  300. package/lib/webdav-sync.d.ts.map +1 -1
  301. package/lib/webdav-sync.js +72 -11
  302. package/lib/webdav-sync.js.map +1 -1
  303. package/lib/zcode-adapter.d.ts +4 -2
  304. package/lib/zcode-adapter.d.ts.map +1 -1
  305. package/lib/zcode-adapter.js +132 -37
  306. package/lib/zcode-adapter.js.map +1 -1
  307. package/lib/zcode-upstream.d.ts +59 -0
  308. package/lib/zcode-upstream.d.ts.map +1 -1
  309. package/lib/zcode-upstream.js +137 -2
  310. package/lib/zcode-upstream.js.map +1 -1
  311. package/package.json +5 -4
  312. package/lib/stepcode-adapter.d.ts +0 -158
  313. package/lib/stepcode-adapter.d.ts.map +0 -1
  314. package/lib/stepcode-adapter.js +0 -318
  315. package/lib/stepcode-adapter.js.map +0 -1
  316. package/lib/stepcode-auth.d.ts +0 -154
  317. package/lib/stepcode-auth.d.ts.map +0 -1
  318. package/lib/stepcode-auth.js +0 -287
  319. package/lib/stepcode-auth.js.map +0 -1
  320. package/lib/stepcode-oauth.d.ts +0 -194
  321. package/lib/stepcode-oauth.d.ts.map +0 -1
  322. package/lib/stepcode-oauth.js +0 -496
  323. package/lib/stepcode-oauth.js.map +0 -1
  324. package/lib/stepcode-product.d.ts +0 -255
  325. package/lib/stepcode-product.d.ts.map +0 -1
  326. package/lib/stepcode-product.js +0 -256
  327. package/lib/stepcode-product.js.map +0 -1
  328. package/lib/stepcode.d.ts +0 -230
  329. package/lib/stepcode.d.ts.map +0 -1
  330. package/lib/stepcode.js +0 -300
  331. package/lib/stepcode.js.map +0 -1
  332. package/lib/teleagent-adapter.d.ts +0 -116
  333. package/lib/teleagent-adapter.d.ts.map +0 -1
  334. package/lib/teleagent-adapter.js +0 -293
  335. package/lib/teleagent-adapter.js.map +0 -1
  336. package/lib/teleagent-auth.d.ts +0 -279
  337. package/lib/teleagent-auth.d.ts.map +0 -1
  338. package/lib/teleagent-auth.js +0 -512
  339. package/lib/teleagent-auth.js.map +0 -1
  340. package/lib/teleagent-cdp-login.d.ts +0 -100
  341. package/lib/teleagent-cdp-login.d.ts.map +0 -1
  342. package/lib/teleagent-cdp-login.js +0 -402
  343. package/lib/teleagent-cdp-login.js.map +0 -1
  344. package/lib/teleagent-credits.d.ts +0 -120
  345. package/lib/teleagent-credits.d.ts.map +0 -1
  346. package/lib/teleagent-credits.js +0 -288
  347. package/lib/teleagent-credits.js.map +0 -1
  348. package/lib/teleagent-product.d.ts +0 -196
  349. package/lib/teleagent-product.d.ts.map +0 -1
  350. package/lib/teleagent-product.js +0 -212
  351. package/lib/teleagent-product.js.map +0 -1
  352. package/lib/teleagent.d.ts +0 -288
  353. package/lib/teleagent.d.ts.map +0 -1
  354. package/lib/teleagent.js +0 -450
  355. package/lib/teleagent.js.map +0 -1
@@ -0,0 +1,494 @@
1
+ /**
2
+ * Magicrew 的三层凭证与续期。
3
+ *
4
+ * ## 三层凭证(有效期完全不同,实测 2026-10-28)
5
+ *
6
+ * | 层 | 有效期 | 用途 | 续期方式 |
7
+ * |---|---|---|---|
8
+ * | 网页 JWT | 30 天 | 业务 API(目录/计费/积分) | 手机号+密码重登 |
9
+ * | `mgw_` api_key | **2 小时** | 模型网关(推理) | `PUT /tokens` |
10
+ * | refresh_token | 7 天,**一次性轮换** | 换 api_key | 同上,**必须串行** |
11
+ *
12
+ * ## ⚠️ 两条不能违反的规则(magpie 侧真实事故换来的,AGENTS.md 坑 #3 / #4)
13
+ *
14
+ * 1. **签新 key 会吊销旧 key** ⇒ 绝不在热路径上签发。只允许「登录」与「续期」两个入口。
15
+ * 2. **refresh_token 只能有一个出口** ⇒ 只允许本文件的 `refreshMagicrewKey` 持有,
16
+ * 别的模块不得自持第二份(分叉的后果是两处 token 不一致、用户莫名掉登录)。
17
+ */
18
+ import { Service, type Context } from '@deepseek-ai/cordis';
19
+ import { type CredentialRef } from '@deepseek-ai/dsh-credentials';
20
+ import type { AccountPool } from './account-pool.js';
21
+ import { type MagicrewBrowserLogin } from './magicrew-browser-login.js';
22
+ import { type MagicrewProfile } from './magicrew-profile.js';
23
+ import { type MagicrewProduct } from './magicrew-product.js';
24
+ /** 一个账号的完整凭据。**不存密码**(JWT 30 天 + refresh_token 自滚,存密码得不偿失)。 */
25
+ export interface MagicrewCredential {
26
+ /** 网页 JWT(业务 API 用)。 */
27
+ jwt: string;
28
+ /** 组织码 —— **必须与 apiKey 配对**(错配会得到 HTTP 200 + `code:403`)。 */
29
+ organizationCode: string;
30
+ /** 模型网关 key(2 小时);缺失时可通过 refreshToken 救回。 */
31
+ apiKey?: string;
32
+ apiKeyExpiresAt?: number;
33
+ /** 换 key 用,一次性轮换。 */
34
+ refreshToken?: string;
35
+ refreshTokenExpiresAt?: number;
36
+ /** 手机号(仅展示,不参与鉴权)。 */
37
+ phone?: string;
38
+ /**
39
+ * 上游昵称(**仅展示**;登录时取自 {@link fetchMagicrewProfile})。
40
+ *
41
+ * ⚠️ 与 `phone` 同级:卡片的展示名按 `nickname → 脱敏手机号 → displayName` 判
42
+ * (见 {@link magicrewDisplayNickname}),它**不参与**任何鉴权。
43
+ *
44
+ * ⚠️ 可选字段,**老凭据里没有它** —— 这是刻意的向后兼容:没有本字段时展示判据
45
+ * 逐字节回到改动前的行为。
46
+ */
47
+ nickname?: string;
48
+ }
49
+ /**
50
+ * 把账号池里的 `unknown` 收窄成 {@link MagicrewCredential}。
51
+ *
52
+ * 判据:**`jwt` 是唯一必需字段**(业务 API 全靠它;api_key 缺失可由 refresh_token 救回,
53
+ * 而 jwt 缺失意味着连目录都拉不到)⇒ 此时返回 `undefined`(账号不可用)。
54
+ */
55
+ export declare function parseMagicrewCredential(raw: unknown): MagicrewCredential | undefined;
56
+ /**
57
+ * 凭据指纹(**按 jwt 算**)—— 用于「同一账号是否已存在」的判重。
58
+ *
59
+ * ⚠️ 不能用 `apiKey`:它 2 小时一换,会把同一个账号认成新账号。
60
+ * jwt 的 payload 在 30 天内稳定(`refresh` 不改它)。
61
+ */
62
+ export declare function magicrewCredentialFingerprint(jwt: string): string;
63
+ /**
64
+ * 展示昵称:**上游昵称 → 手机号脱敏(`130****2222`) → 渠道名**。
65
+ *
66
+ * ## ⚠️ 优先级为什么是这个顺序(真机报障 2026-10-29)
67
+ *
68
+ * 原先只有后两条腿,而**浏览器登录**(本机浏览器导入 / 网页版登录)落库的凭据里
69
+ * **没有 `phone`** ⇒ 卡片恒显示 `product.displayName`(=「超级麦吉」),
70
+ * 而用户自己的昵称是 `Nick`(上游 `/api/v1/contact/accounts/me/users` 实测返回)。
71
+ * ⇒ 登录时把昵称写进凭据({@link MagicrewAuthOptions.profileFetcher}),这里优先用它。
72
+ *
73
+ * ## ⚠️⚠️ 向后兼容是硬约束:老凭据(无 `nickname`)必须逐字节不变
74
+ *
75
+ * 老凭据没有 `nickname` ⇒ 第一腿不成立,后两腿的判据与顺序**一字未改**:
76
+ * 11 位手机号仍出脱敏号、其余仍回落 `displayName`。这个「老凭据」格是本次改动
77
+ * 最重要的用例(改坏它 = 所有存量账号的卡片一起变样)。
78
+ *
79
+ * ⚠️ 昵称判据用 `trim()` 只为**判空**(全空白不算昵称),返回值**原样**给出去 ——
80
+ * 上游昵称里的空格是上游的事,展示层不替它改写。
81
+ */
82
+ export declare function magicrewDisplayNickname(credential: MagicrewCredential, product?: MagicrewProduct): string;
83
+ /**
84
+ * 账号卡片上「有效期」该取哪个时刻(`undefined` = 如实显示「未知」)。
85
+ *
86
+ * ## 判据
87
+ *
88
+ * 1. `apiKeyExpiresAt` 有值 ⇒ 用它(精确,且续期成功后被不断刷新);
89
+ * 2. 否则用 **JWT 的 `exp`**(本家**登录会话**的寿命,实测 30 天、可离线解出);
90
+ * 3. 都拿不到 ⇒ `undefined`(**不编造** —— 卡片如实显示「未知」,不写 0/NaN)。
91
+ *
92
+ * ## ⚠️⚠️ 为什么不能只取 `apiKeyExpiresAt`(真机报障:卡片「有效期 未知」)
93
+ *
94
+ * `mgw_` key 只有 **2 小时**且会自动续期,而**浏览器登录**落库的凭据里
95
+ * **根本没有 `apiKeyExpiresAt` 这个字段**(实测 `~/.dsh/.credentials.yaml` 只有
96
+ * `apiKey`/`jwt`/`organizationCode`/`refreshToken`)⇒ `account.create` 写池时那一格
97
+ * 是 `{}` ⇒ 卡片恒显示「未知」。
98
+ *
99
+ * ⚠️ 反过来也不能只用 JWT exp:JWT 过期(30 天)之后 `refresh_token` 仍可能有效,
100
+ * `apiKeyExpiresAt` 是「更近的真相」⇒ 两条腿**各管一段**,顺序不能换。
101
+ *
102
+ * ⚠️ JWT 解不出来时 `jwtTimes` 返回 `exp = 0`(**不猜**)⇒ 这里同样返回 `undefined`。
103
+ */
104
+ export declare function magicrewExpiresAtMs(credential: MagicrewCredential): number | undefined;
105
+ /**
106
+ * 取账号资料(昵称)的**小超时**:6 秒。
107
+ *
108
+ * ⚠️⚠️ 这个值刻意**远短于** `product.requestTimeoutMs`(30 秒,业务 API 口径):
109
+ * 资料只用来给卡片取个昵称,而它挂在**登录**这条用户正盯着屏幕等的路径上 ——
110
+ * 30 秒的静默等待与「点了登录没反应」同形。
111
+ *
112
+ * 兑现方式:调用方把 `product.requestTimeoutMs` **换成这个值**再交给
113
+ * `fetchMagicrewProfile`(它的 `AbortSignal.timeout(product.requestTimeoutMs)` 是
114
+ * 唯一超时出口,不为「小超时」另开一个参数 —— 两处超时门是漂移源)。
115
+ */
116
+ export declare const MAGICREW_PROFILE_TIMEOUT_MS = 6000;
117
+ /** 签发结果(三层凭证的第 2、3 层)。 */
118
+ export interface MagicrewGatewayKey {
119
+ readonly apiKey: string;
120
+ readonly refreshToken?: string;
121
+ readonly apiKeyExpiresAt?: number;
122
+ readonly refreshTokenExpiresAt?: number;
123
+ }
124
+ /**
125
+ * 用登录 JWT 签发一把 `mgw_` key(2 小时)。
126
+ *
127
+ * ⚠️⚠️ **签新 key 会吊销旧 key**(magpie 坑 #3)⇒ 本函数**只允许**在
128
+ * 「登录成功」与「续期」两个入口调用,**绝不在热路径**(推理前)调用。
129
+ * 热路径上签一次,正在并发的另一次请求立刻拿到死 key(症状:偶发「token无效」,
130
+ * 而重试又能成 —— 极难复现的那种)。
131
+ */
132
+ export declare function issueMagicrewGatewayKey(params: {
133
+ jwt: string;
134
+ organizationCode: string;
135
+ product?: MagicrewProduct;
136
+ fetchImpl?: typeof fetch;
137
+ }): Promise<MagicrewGatewayKey>;
138
+ /**
139
+ * 用 refresh_token 换新的 api_key。**不需要登录态**(JWT 过期也能续)。
140
+ *
141
+ * ⚠️⚠️ refresh_token 是**一次性**的(每换一次就轮换)⇒ 调用方**必须串行**,
142
+ * 并发两次会让其中一个的 token 立即失效(表现为「账号突然掉登录」,而重登又好了)。
143
+ *
144
+ * ⚠️ **本函数是全仓唯一持有 refresh_token 的地方**(magpie 坑 #4):
145
+ * 别处再存一份就会分叉。
146
+ */
147
+ export declare function refreshMagicrewKey(params: {
148
+ refreshToken: string;
149
+ product?: MagicrewProduct;
150
+ fetchImpl?: typeof fetch;
151
+ }): Promise<MagicrewGatewayKey>;
152
+ /**
153
+ * 判断一个错误是否是「api_key 失效」(应当续期重试,而不是判账号死)。
154
+ *
155
+ * ⚠️ 只判**消息文本**:上游把鉴权失败装在业务码里(HTTP 200 + `code:403` +
156
+ * `message:"token无效"`)⇒ 状态码根本不是判据。
157
+ *
158
+ * ⚠️ **刻意不把 HTTP 401 / 403 塞进来**:那两类是**传输层**的失败(可能是网关抖动、
159
+ * 出口 IP 被拦、甚至 `organization-code` 错配),把它们当成「key 失效」会触发续期
160
+ * ⇒ 而续期**会吊销当前 key** ⇒ 一次误判就把本来能用的凭据烧掉。
161
+ */
162
+ export declare function isMagicrewApiKeyDeadError(error: unknown): boolean;
163
+ /**
164
+ * 一个账号的**续期内存态**(per-ref,由 `MagicrewAuth.states` 强持)。
165
+ *
166
+ * ⚠️ 它不是凭据的副本,而是「下次该拿哪个 refresh_token 去换」的唯一答案:
167
+ * 轮换成功后立即就地更新,因此它可能比凭据库**新**(写回还没发生/失败)。
168
+ */
169
+ export interface MagicrewRefreshState {
170
+ refreshToken?: string;
171
+ apiKey?: string;
172
+ apiKeyExpiresAt?: number;
173
+ /**
174
+ * **上次写回失败时,凭据库里那条已被消费的旧 token**(`undefined` = 库与内存一致)。
175
+ *
176
+ * 用途有两个,都不可省:
177
+ * 1. `stateOf` 用存储值刷新内存态时**跳过它**;
178
+ * 2. `refreshAll` 的 lead-time 门**放行**(见 `refreshAll` 内的注释)。
179
+ *
180
+ * ⚠️⚠️ 为什么必须有(单向门):refresh_token 一次性轮换。若「轮换成功 → `store.set`
181
+ * 抛错」(磁盘满 / 凭据库被锁),内存已是新 token、存储仍是旧 token。下一轮
182
+ * `stateOf` 若照「存储优先」把内存改回那条**上游已消费**的旧 token,续期从此
183
+ * 必然失败 ⇒ 只能重新登录。
184
+ *
185
+ * ⚠️⚠️ **登记点必须跟着「写回失败」走,不能放在「轮换成功」处**:库里的值可以被
186
+ * **别的写入方**改(备份导入 / 合并写入同一 ref / 另一实例 / 复用同一 ref 的重登),
187
+ * 那条路径的通式是「两次瞬时失败**夹一次外部写入**」——
188
+ * `t1` 轮换 rtA→rtB 失败(marker=rtA)→ `t2` 外部写入 rtL(`stateOf` 采纳,正确)
189
+ * → `t3` 轮换 rtL→rtC 又失败,但「只记第一条」的守卫让 marker 仍是 rtA ⇒
190
+ * `t4` 存储值 rtL ≠ marker rtA ⇒ 把**已消费的 rtL** 抬回内存 ⇒ 门重开。
191
+ * 改成「失败时无条件记下**当时读到的库值**(`credential.refreshToken`)」后,
192
+ * marker 恒与库同步:每次失败重新上膛、成功即清空 ⇒ 上面每一轮都闭合。
193
+ */
194
+ staleRefreshToken?: string;
195
+ }
196
+ /**
197
+ * 一次性 refresh_token 的**串行续期器**。
198
+ *
199
+ * ⚠️⚠️ 为什么必须串行:refresh_token **一次性轮换**(每换一次就作废旧的)。
200
+ * 两个并发请求会拿同一个 token 去换 ⇒ 第二个必然失败,而**前一个已经把新 token
201
+ * 写回了** ⇒ 表面上「莫名掉登录」,实际是竞态。
202
+ *
203
+ * ⚠️ 这里刻意做成「共享同一个 state 对象」而不是闭包变量:调用方(`MagicrewAuth`)
204
+ * 持有那份 state,续期成功后**就地更新** `refreshToken`,下一轮才有得用。
205
+ *
206
+ * 并发到来时**后来的等前一个的结果**(而不是各发一次)—— `SerialQueue` 保证
207
+ * 「同一刻只有一个 PUT 在飞」,`inFlight` 保证**同一次续期只真发一次请求**。
208
+ *
209
+ * ⚠️⚠️ `inFlight` **必须按 `state` 分键**(`WeakMap`),不能是一个裸变量:
210
+ * 本实例由 `MagicrewAuth` 构造时**只创建一份**、被全部账号共用,裸变量会让
211
+ * 「账号 A 续期中、账号 B 同时要续期」变成**B 直接拿到 A 的新 key**
212
+ * (`fetch` 只发一次、B 的凭据被写成 A 的 `mgw_` 密钥 ⇒ 跨账号串号,
213
+ * 症状是 B 偶发「token无效」而 A 一切正常)。同一个 `state` 才该去重。
214
+ */
215
+ export declare function createMagicrewRefreshOnce(deps: {
216
+ fetchImpl?: typeof fetch;
217
+ product?: MagicrewProduct;
218
+ }): (state: MagicrewRefreshState) => Promise<MagicrewGatewayKey | undefined>;
219
+ /** `MagicrewAuth` 的注入项(测试全套可注入)。 */
220
+ export interface MagicrewAuthOptions {
221
+ readonly product?: MagicrewProduct;
222
+ readonly fetchImpl?: typeof fetch;
223
+ /** 告警出口;缺省走 `ctx.logger?.warn`(单测注入以便断言「不许静默」)。 */
224
+ readonly warn?: (message: string) => void;
225
+ /**
226
+ * 注入的凭据库。⚠️:**形状必须与宿主 `ctx.credentials` 一致**。
227
+ *
228
+ * 实测(`astudio-auth.ts:395-399`)它是三个方法、值是**字符串**:
229
+ *
230
+ * ```ts
231
+ * resolve(ref: CredentialRef): Promise<{ value: string } | undefined>
232
+ * set(ref: CredentialRef, value: string): Promise<void>
233
+ * unset(ref: CredentialRef): Promise<void>
234
+ * ```
235
+ *
236
+ * ⇒ 序列化要自己做(`JSON.stringify` / `JSON.parse`),且 ref 要过
237
+ * `credentialRef(refName)` 转一下(从 `@deepseek-ai/dsh-credentials` 导入)。
238
+ * ⚠️ 别自己发明 `read` / `write` 两个方法名 —— 那与宿主接口不匹配,`ctx.credentials` 直接風在类型上。
239
+ */
240
+ readonly store?: {
241
+ resolve(ref: CredentialRef): Promise<{
242
+ value: string;
243
+ } | undefined>;
244
+ set(ref: CredentialRef, value: string): Promise<void>;
245
+ unset(ref: CredentialRef): Promise<void>;
246
+ };
247
+ /**
248
+ * 注入的浏览器 User Data 根目录(**单测专用**,见 `magicrew-local-browser.ts`)。
249
+ *
250
+ * ⚠️⚠️ 缺省时扫**真实**浏览器目录 —— 单测若不注入就会读到开发机上用户的真实
251
+ * 登录态(用例结果随机器而变,还会泄漏真实凭据)。本字段存在的唯一目的就是
252
+ * 「用例传临时目录」。
253
+ */
254
+ readonly browserRoots?: readonly string[];
255
+ /**
256
+ * 网页版登录的**会话工厂**(注入点,单测专用 —— 绝不真起浏览器)。
257
+ *
258
+ * ## ⚠️⚠️ 为什么必须是 auth 层的注入点(而不是让单测调 `startMagicrewBrowserLogin`)
259
+ *
260
+ * `loginViaBrowser` 是**完整的一条登录腿**(开窗 → 等用户 → 签发 key → 落库),
261
+ * 而它最容易错的两个判据都在**外面**:① 签发的**次数**(多签一次就吊销了在用的
262
+ * key);② 写回的 ref(写错就是「凭据在、账号读不到」)。这两条只有把整条腿
263
+ * 跑一遍才能断言 —— 若工厂不可注入,用例就只能真起一个浏览器窗口(本仓库已
264
+ * 记过两次「单测弹出真实浏览器窗口」的污染)。
265
+ *
266
+ * ⚠️ 缺省 = `startMagicrewBrowserLogin`(真起浏览器)。**不要**把它换成
267
+ * 「测试里也安全」的假实现:那样生产路径就再没有用例覆盖了。
268
+ */
269
+ readonly browserLoginFactory?: (options?: {
270
+ product?: MagicrewProduct;
271
+ timeoutMs?: number;
272
+ }) => Promise<MagicrewBrowserLogin>;
273
+ /**
274
+ * 账号资料(昵称)取数器 —— **注入点,单测专用**(缺省 = {@link fetchMagicrewProfile})。
275
+ *
276
+ * ⚠️ 为什么需要注入:两条登录腿都会在签发 key 之后取一次昵称,而那是**第二次网络
277
+ * 往返**。不注入的话,「取昵称成功写进凭据」「取昵称失败不挡登录且留痕」这两条
278
+ * 判据就只能靠真发请求或靠数 fetch 调用次数来断言(后者对 URL 极其敏感)。
279
+ *
280
+ * ⚠️ 缺省**必须**是真的取数器(不要塞一个「测试也安全」的空实现):昵称这条路
281
+ * 是本任务的正题,缺省假实现会让生产路径没有用例覆盖。
282
+ */
283
+ readonly profileFetcher?: (params: {
284
+ jwt: string;
285
+ organizationCode: string;
286
+ product: MagicrewProduct;
287
+ }) => Promise<MagicrewProfile>;
288
+ }
289
+ declare module '@deepseek-ai/cordis' {
290
+ interface Context {
291
+ magicrewAuth: MagicrewAuth;
292
+ }
293
+ }
294
+ /**
295
+ * 账号池侧的续期入口(`index.ts` 的 `auths.magicrew` 用它)。
296
+ *
297
+ * ## ⚠️ 四条铁律(照 `AstudioAuth` 的既有口径,全部来自真实事故)
298
+ *
299
+ * 1. **续期成功后必须把新 `expiresAt` 写回账号池** —— 否则凭据续好了、
300
+ * 界面纹丝不动,用户没有任何自救手段(issue !IKIRTT)。
301
+ * 2. **`refreshAll` 只按凭据材料过滤**:不看 `enabled`(停用只影响自动选号,
302
+ * 与「凭据该不该保持新鲜」无关 —— 按它过滤会让停用期间的 token 一路放到失效,
303
+ * 用户重新启用后拿到死凭据),也不看池里的 `refreshable`(那是**对账结果**,
304
+ * 拿它当门禁会把一次瞬时失败固化成**单向门**)。
305
+ * 3. **串行**:走 {@link createMagicrewRefreshOnce},不要自己 `await refreshMagicrewKey`。
306
+ * 4. ⚠️⚠️ **`refreshAll` 必须带 lead-time 过滤**(`shouldRefreshNow(apiKeyExpiresAt)`),
307
+ * 且**只有**这一层带:本家 `mgw_` key TTL 仅 **2 小时**、调度器 **30 分钟**一轮
308
+ * (`src/index.ts` 的 `REFRESH_INTERVAL_MS`),无条件续期等于每 2 小时窗口
309
+ * **白签 4 次**,而**签新 key 会吊销旧 key**(本文件头第 1 条硬约束)⇒ 轮换瞬间
310
+ * 在途的推理请求可能拿到刚被吊销的 key。其余轮换型 provider 同样走
311
+ * `src/expiry-sync.ts:112` 的 `shouldRefreshNow`。
312
+ * ⚠️ 但**不能**把它挪进 {@link refreshAccountCredential}:那是
313
+ * `account.refresh`(用户点了按钮就要刷)的入口 —— 加进去等于按钮变哑的。
314
+ * ⚠️ 唯一的例外是**写回失败态**(`MagicrewRefreshState.staleRefreshToken` 非空):
315
+ * 此时凭据库里的 `expiresAt` 是上一轮的陈旧值,按它判会把这个账号的自愈推迟到
316
+ * 库里那个时刻进入 lead 窗口(≤1 小时)⇒ `refreshAll` 对这类账号**跳过 lead-time 门**。
317
+ */
318
+ export declare class MagicrewAuth extends Service {
319
+ readonly product: MagicrewProduct;
320
+ private readonly fetchImpl;
321
+ private readonly warnImpl;
322
+ private readonly store;
323
+ /** 注入的浏览器 User Data 根目录(单测);`undefined` = 扫真实浏览器目录。 */
324
+ private readonly browserRoots;
325
+ /** 网页版登录的会话工厂(单测注入;缺省真起浏览器)。 */
326
+ private readonly browserLoginFactory;
327
+ /** 账号资料(昵称)取数器(单测注入;缺省真发一次 GET)。 */
328
+ private readonly profileFetcher;
329
+ private readonly refreshOnce;
330
+ /** 每账号一份在途状态(含最新 refresh_token)。 */
331
+ private readonly states;
332
+ /**
333
+ * 登录态是否活跃。`stop()` / `logout()` 置 false,**阻止在途续期回写**。
334
+ *
335
+ * ⚠️ 为什么必须有:续期是**异步**的(一次网络往返)。用户中途登出或插件被停用时,
336
+ * 那个在途请求回来若照常 `store.set` + `pool.updateAccount`,就会把凭据写回
337
+ * 一个**已被删除/已登出**的账号(症状:删了账号又「复活」,或登出后仍能调用)。
338
+ * 照 `astudio-auth.ts` 的同款(`:429` / `:926` / `:936`)。
339
+ */
340
+ private active;
341
+ constructor(ctx: Context, options?: MagicrewAuthOptions);
342
+ /**
343
+ * 给凭据补上**上游昵称**(`credential.nickname`)。
344
+ *
345
+ * ## 调用时机:签发 gateway key **之后**
346
+ *
347
+ * 两条登录腿都在这之后调它。刻意放在签发那段的 `try/catch` **外面**:昵称只需要
348
+ * `jwt` + `organizationCode`,与「key 签发成功没有」无关 —— 放在里面会让
349
+ * 「签发失败(网关抖动)」顺带把昵称也丢掉,而那种情况下卡片本可以显示对的名字。
350
+ *
351
+ * ## ⚠️⚠️ 失败**不挡登录**,但**必须留痕**
352
+ *
353
+ * 昵称只是展示名:取不到时卡片回落「脱敏手机号 / 渠道名」,登录本身完全不受影响。
354
+ * 但**不许静默** —— 本仓库记过「静默停摆、功能上线起一次都没成功过」的教训
355
+ * (本文件里 `importFromLocalBrowser` / `loginViaBrowser` 的签发失败走同一条纪律)。
356
+ *
357
+ * ⚠️ 代价受 {@link MAGICREW_PROFILE_TIMEOUT_MS}(6 秒)约束,不给登录加长等待。
358
+ */
359
+ private withProfileNickname;
360
+ /**
361
+ * 读本账号的**展示昵称** —— `account.list` 的自愈回填用(2026-10-30)。
362
+ *
363
+ * ## 为什么要有这个公开入口(而不是让 RPC 层直接调 `fetchMagicrewProfile`)
364
+ *
365
+ * ⚠️ 必须与登录走**同一个注入点**({@link MagicrewAuthOptions.profileFetcher}):
366
+ * ① 单测要能注入假取数器(否则「回填」那条腿只能真发网络 ⇒ 不可测);
367
+ * ② 超时与告警纪律只有这一份 —— 另起一条调用链必然与登录那条分叉
368
+ * (本仓库「一语义一套判据」的红线)。
369
+ *
370
+ * ⚠️ 读不到 ⇒ `undefined`,**不抛**:回填是尽力而为,调用方(`account.list`)
371
+ * 不该因为一个展示名取不到而让整个列表失败。
372
+ * ⚠️ 但仍然**留痕**(与 {@link withProfileNickname} 同一条纪律:不许静默 ——
373
+ * 本仓库记过「静默停摆、功能上线起一次都没成功过」的教训)。
374
+ */
375
+ readProfileNickname(credential: {
376
+ jwt: string;
377
+ organizationCode: string;
378
+ }): Promise<string | undefined>;
379
+ /** 告警出口(`warnImpl` 优先,否则宿主 logger)。 */
380
+ private warn;
381
+ /**
382
+ * 续期**指定账号**并写回账号池。
383
+ *
384
+ * ⚠️ `pool` 与 `accountId` **必须都传**(issue !IKIRTT 的修法)。
385
+ */
386
+ refreshAccountCredential(refName: string, pool: AccountPool, accountId: string): Promise<void>;
387
+ /**
388
+ * 批量续期该 provider 的**全部账号**(`src/index.ts` 的定时器/首轮入口)。
389
+ *
390
+ * ⚠️ 过滤口径见类注释第 2、4 条:**不看** `enabled` / `refreshable`,
391
+ * **但要看 lead-time**(`shouldRefreshNow`)。
392
+ */
393
+ refreshAll(pool: AccountPool): Promise<void>;
394
+ /** 登出:置非活跃,**阻止在途续期回写**(否则会把凭据写回一个已删的账号)。 */
395
+ /**
396
+ * 从本机浏览器读取已登录的凭据(**不开窗口**)。读不到 ⇒ `undefined`。
397
+ *
398
+ * ## 为什么需要它
399
+ *
400
+ * magicrew 没有 OAuth 回调:用户在自己浏览器里登录成功后,插件**收不到任何通知**
401
+ * (那是另一个浏览器)。而凭据本来就明文躺在 Chromium 系的
402
+ * `<User Data>/<Default|Profile N>/Local Storage/leveldb/` 里
403
+ * ⇒ 直接读文件即可,既不用开窗口也不用让用户粘任何东西。
404
+ *
405
+ * ## 语义上这就是一次「登录」
406
+ *
407
+ * 读到 jwt 之后**签发一次 `mgw_` key**(与 {@link login} 同一条腿):不签的话
408
+ * 池里会出现一个「有账号、每请求都抛 `AUTH`」的幽灵条目(适配器缺 api_key 时
409
+ * 恒抛「账号未登录或缺少 api_key」),用户只会看到「明明导入成功却不回复」。
410
+ * 签发失败**不吞掉导入结果**(jwt 能拉目录 / 积分,api_key 可由续期或重登救回),
411
+ * 但**不许静默** —— 走 `warn`(与 {@link login} 一字不差的纪律)。
412
+ *
413
+ * ⚠️ 签新 key 会吊销旧 key 是本家硬约束(模块头第 1 条)。这里等同「重新登录」,
414
+ * 故仍在允许的范围内;但**不要在热路径上重试本方法**。
415
+ *
416
+ * ⚠️ 写回的 ref 是 {@link MagicrewProduct.defaultCredentialRef}(**不是**某个
417
+ * `MAGICREW_ACCOUNT_*`):账号 id / ref 由 `account.create` 分配,本方法只管
418
+ * 「把这台机器上已登录的那份凭据取回来并落库」。
419
+ */
420
+ importFromLocalBrowser(): Promise<MagicrewCredential | undefined>;
421
+ /**
422
+ * **网页版登录**:开一个独立 profile 的浏览器窗口 → 等用户在里面登完 →
423
+ * 把凭据取回来(并签发一次 `mgw_` key)。
424
+ *
425
+ * ## 三条登录路径里的第 ② 条
426
+ *
427
+ * | # | 路径 | 门槛 | 方法 |
428
+ * |---|---|---|---|
429
+ * | ① | 本机浏览器已登录态 | 零 | {@link importFromLocalBrowser} |
430
+ * | ② | **网页版登录(本方法)** | 低(开窗,用户自己登) | 本方法 |
431
+ * | ③ | 手机号 + 密码 | 要密码 + 上游风控 | **已下线**(见 `jet-hub-rpc.ts`) |
432
+ *
433
+ * ② 存在的理由:①在「用户从没在本机浏览器登过这个站」「用户用的是另一个
434
+ * profile」两种情形下读不到,而它与「没登录」在结果上同形;③要用户交出密码、
435
+ * 且参考实现里那条 `phone_password` 是**零调用者**的探索代码。
436
+ * ② 是唯一「用户看着官方页面自己登、凭据自然落盘」的路径。
437
+ *
438
+ * ## ⚠️⚠️ 成功后**必须**签发一次 `mgw_` key(与 ① 同一条腿)
439
+ *
440
+ * 本仓库适配器在 `credential.apiKey` 缺失时**恒抛** `AUTH`
441
+ * 「超级麦吉账号未登录或缺少 api_key,请重新登录」⇒ 只落 jwt 的池条目 =
442
+ * 「登录成功但每请求都不回复」的**幽灵账号**,用户只会以为插件坏了。
443
+ * 派生细节逐条同 {@link importFromLocalBrowser}(签发失败**不吞掉**结果、
444
+ * 只 warn —— jwt 能拉目录 / 积分,api_key 可由续期救回)。
445
+ *
446
+ * ## 返回 `undefined` 的两种情形(都**不是**错误)
447
+ *
448
+ * 1. 用户在 `timeoutMs` 内没登完(关掉了窗口 / 还在输密码);
449
+ * 2. 用户在等的时候插件被停用({@link stop})—— 见下面的 `isStopped` 闸门。
450
+ *
451
+ * ⚠️ 调用方**不得**把 `undefined` 当失败弹错:那是**正常的「还没登完」**。
452
+ * 真正失败(浏览器起不来 / 签发网络异常)才抛错,且文案可读。
453
+ *
454
+ * ⚠️ `close()` 在 `finally` 里 —— 不调就会留下一个可见的浏览器窗口 + 200-400MB
455
+ * 的进程树(`ChromiumSession.dispose()` 里那套 `taskkill /T` 才是唯一正确的收法)。
456
+ */
457
+ loginViaBrowser(options?: {
458
+ timeoutMs?: number;
459
+ }): Promise<MagicrewCredential | undefined>;
460
+ /**
461
+ * 读本机浏览器里的凭据(纯读,无网络)。
462
+ *
463
+ * ⚠️⚠️ **先试网页 origin、再试 API host**:localStorage 的 key 是
464
+ * `_https://<origin>\x00\x01<name>`,而 magicrew 的网页在 `www.letsmagic.cn`、
465
+ * API 在 `i-magic-service.letsmagic.cn`(`product.host`)—— 用户登录发生在
466
+ * **网页**那个 origin 上 ⇒ 只按 `product.host` 找会**恒读不到**(且完全静默)。
467
+ * 两个都试,谁命中用谁。
468
+ */
469
+ private readLocalBrowserCreds;
470
+ /** 候选站点 host(网页 origin 优先,见 {@link readLocalBrowserCreds})。 */
471
+ private localBrowserHostnames;
472
+ logout(): Promise<void>;
473
+ /** 插件被停用时调用(与 {@link logout} 同因)。 */
474
+ stop(): void;
475
+ /**
476
+ * 拉目录(供适配器注入 `fetchRemoteModels`)。
477
+ *
478
+ * ⚠️ 任务 3b 刻意省略过它(当时 `magicrew-catalog.ts` 还不存在),4a 该文件已落地
479
+ * ⇒ 4d 加回。**参数是显式的 `jwt` + `organizationCode`**(不是「读当前凭据」):
480
+ * 目录是**按账号**下发的,调用方必须能指定用哪个账号的 jwt;这也让单测可以
481
+ * 完全不碰凭据库(零真实凭据)。
482
+ *
483
+ * ⚠️ 动态 `import()` 是刻意的:`magicrew-catalog.ts` 只在**真的拉目录**时才需要,
484
+ * 而本文件在插件启动路径上。
485
+ */
486
+ fetchCatalogModels(jwt: string, organizationCode: string): Promise<readonly import("./magicrew-catalog.js").MagicrewCatalogModel[]>;
487
+ /** 读当前凭据(账号池未提供 ref 时用默认 ref)。 */
488
+ currentCredential(refName?: string): Promise<MagicrewCredential | undefined>;
489
+ /** 凭据库:注入的替身优先,否则用宿主 `ctx.credentials`(与 `astudio-auth.ts:451` 同款)。 */
490
+ private storeFor;
491
+ /** 取(或建)某 ref 的续期状态 —— 让最新 refresh_token 在内存里只有一份。 */
492
+ private stateOf;
493
+ }
494
+ //# sourceMappingURL=magicrew-auth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"magicrew-auth.d.ts","sourceRoot":"","sources":["../src/magicrew-auth.ts"],"names":[],"mappings":"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"}