dsh-e-comet-skills 2026.11.1 → 2026.11.3

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 (288) hide show
  1. package/deepseek/adapters/account/account-rpc.mjs +20 -0
  2. package/deepseek/adapters/account/account-service.mjs +39 -0
  3. package/deepseek/adapters/account/account.mjs +282 -0
  4. package/deepseek/adapters/account/oauth.mjs +260 -0
  5. package/deepseek/adapters/account/remote-client.mjs +42 -0
  6. package/deepseek/adapters/account/retry.mjs +48 -0
  7. package/deepseek/adapters/account/runtime.mjs +457 -0
  8. package/deepseek/adapters/account/status-context.mjs +56 -0
  9. package/deepseek/adapters/feedback/handoff.mjs +275 -0
  10. package/deepseek/adapters/feedback/services.mjs +183 -0
  11. package/deepseek/adapters/tool-runtime/runtime.mjs +182 -0
  12. package/deepseek/client.js +528 -377
  13. package/deepseek/index.mjs +97 -63
  14. package/deepseek/skills/e-comet-doctor/SKILL.md +2 -3
  15. package/package.json +1 -1
  16. package/plugins/e-comet-skills/.codex-plugin/plugin.json +1 -1
  17. package/plugins/e-comet-skills/hooks/browser-job-handoff.mjs +17 -560
  18. package/plugins/e-comet-skills/hooks/check-update.mjs +298 -229
  19. package/plugins/e-comet-skills/hooks/feedback-handoff.mjs +24 -1242
  20. package/plugins/e-comet-skills/hooks/hooks.json +1 -1
  21. package/plugins/e-comet-skills/mcp/DIAGNOSTICS.md +3 -3
  22. package/plugins/e-comet-skills/mcp/README.md +4 -3
  23. package/plugins/e-comet-skills/mcp/src/bridge/broker/correlation.mjs +363 -0
  24. package/plugins/e-comet-skills/mcp/src/{transport-events.mjs → bridge/broker/events.mjs} +8 -10
  25. package/plugins/e-comet-skills/mcp/src/bridge/broker/messages.mjs +254 -0
  26. package/plugins/e-comet-skills/mcp/src/bridge/broker/routes.mjs +18 -0
  27. package/plugins/e-comet-skills/mcp/src/bridge/broker/sanitize.mjs +22 -0
  28. package/plugins/e-comet-skills/mcp/src/{bridge-cause.mjs → bridge/cause.mjs} +149 -106
  29. package/plugins/e-comet-skills/mcp/src/{broker-client.mjs → bridge/client/broker-client.mjs} +123 -104
  30. package/plugins/e-comet-skills/mcp/src/{connection-state.mjs → bridge/client/connection-state.mjs} +10 -9
  31. package/plugins/e-comet-skills/mcp/src/{bridge-client-runtime.mjs → bridge/client/session-runtime.mjs} +163 -120
  32. package/plugins/e-comet-skills/mcp/src/bridge/limits.mjs +34 -0
  33. package/plugins/e-comet-skills/mcp/src/{browser-extension-install.mjs → bridge/profile/extension-install.mjs} +167 -85
  34. package/plugins/e-comet-skills/mcp/src/{extension-log.mjs → bridge/profile/extension-log.mjs} +95 -85
  35. package/plugins/e-comet-skills/mcp/src/{leveldb-read.mjs → bridge/profile/leveldb.mjs} +158 -133
  36. package/plugins/e-comet-skills/mcp/src/{bridge-registration.mjs → bridge/registration.mjs} +277 -177
  37. package/plugins/e-comet-skills/mcp/src/{bridge-diagnostics.mjs → bridge/route-state.mjs} +45 -21
  38. package/plugins/e-comet-skills/mcp/src/broker.mjs +152 -111
  39. package/plugins/e-comet-skills/mcp/src/catalog.mjs +61 -0
  40. package/plugins/e-comet-skills/mcp/src/composition/device-evidence.composition.mjs +17 -0
  41. package/plugins/e-comet-skills/mcp/src/composition/extension-protocol.composition.mjs +186 -0
  42. package/plugins/e-comet-skills/mcp/src/composition/feedback-handoff.composition.mjs +13 -0
  43. package/plugins/e-comet-skills/mcp/src/composition/feedback.composition.mjs +53 -0
  44. package/plugins/e-comet-skills/mcp/src/composition/module-names.composition.mjs +33 -0
  45. package/plugins/e-comet-skills/mcp/src/composition/ozon-seller.composition.mjs +69 -0
  46. package/plugins/e-comet-skills/mcp/src/composition/request-broker.composition.mjs +288 -0
  47. package/plugins/e-comet-skills/mcp/src/composition/support.composition.mjs +105 -0
  48. package/plugins/e-comet-skills/mcp/src/composition/tool-names.composition.mjs +9 -0
  49. package/plugins/e-comet-skills/mcp/src/composition/wb-client.composition.mjs +40 -0
  50. package/plugins/e-comet-skills/mcp/src/composition/wb-seller.composition.mjs +25 -0
  51. package/plugins/e-comet-skills/mcp/src/doctor.mjs +30 -86
  52. package/plugins/e-comet-skills/mcp/src/handoff/browser-job.mjs +220 -0
  53. package/plugins/e-comet-skills/mcp/src/handoff/call-result.mjs +145 -0
  54. package/plugins/e-comet-skills/mcp/src/handoff/diagnostics.mjs +92 -0
  55. package/plugins/e-comet-skills/mcp/src/handoff/grants/file-store.mjs +235 -0
  56. package/plugins/e-comet-skills/mcp/src/handoff/grants/memory-store.mjs +33 -0
  57. package/plugins/e-comet-skills/mcp/src/handoff/grants/policy.mjs +34 -0
  58. package/plugins/e-comet-skills/mcp/src/handoff/hook-io.mjs +53 -0
  59. package/plugins/e-comet-skills/mcp/src/handoff/session.mjs +7 -0
  60. package/plugins/e-comet-skills/mcp/src/{hook-signature.mjs → handoff/signature.mjs} +77 -86
  61. package/plugins/e-comet-skills/mcp/src/mcp-protocol/client-info.mjs +4 -0
  62. package/plugins/e-comet-skills/mcp/src/mcp-protocol/framing.mjs +5 -0
  63. package/plugins/e-comet-skills/mcp/src/mcp-protocol/generic-tools.mjs +61 -0
  64. package/plugins/e-comet-skills/mcp/src/mcp-protocol/registry/dispatcher.mjs +126 -0
  65. package/plugins/e-comet-skills/mcp/src/mcp-protocol/registry/router.mjs +64 -0
  66. package/plugins/e-comet-skills/mcp/src/mcp-protocol/registry/runs.mjs +131 -0
  67. package/plugins/e-comet-skills/mcp/src/mcp-protocol/registry/validate.mjs +18 -0
  68. package/plugins/e-comet-skills/mcp/src/mcp-protocol/results/links.mjs +76 -0
  69. package/plugins/e-comet-skills/mcp/src/mcp-protocol/results/receipts.mjs +124 -0
  70. package/plugins/e-comet-skills/mcp/src/mcp-protocol/results/serialize.mjs +46 -0
  71. package/plugins/e-comet-skills/mcp/src/{stdio-transport.mjs → mcp-protocol/stdio.mjs} +15 -21
  72. package/plugins/e-comet-skills/mcp/src/native-framing.mjs +23 -23
  73. package/plugins/e-comet-skills/mcp/src/ozon-seller/application/analytics.mjs +83 -0
  74. package/plugins/e-comet-skills/mcp/src/ozon-seller/application/job-limits.mjs +95 -0
  75. package/plugins/e-comet-skills/mcp/src/ozon-seller/application/package.mjs +294 -0
  76. package/plugins/e-comet-skills/mcp/src/ozon-seller/application/promotion.mjs +148 -0
  77. package/plugins/e-comet-skills/mcp/src/ozon-seller/application/search-positions.mjs +158 -0
  78. package/plugins/e-comet-skills/mcp/src/ozon-seller/contract/analytics-report.contract.mjs +51 -0
  79. package/plugins/e-comet-skills/mcp/src/ozon-seller/contract/promotion-report.contract.mjs +93 -0
  80. package/plugins/e-comet-skills/mcp/src/ozon-seller/contract/promotion-reports.contract.mjs +37 -0
  81. package/plugins/e-comet-skills/mcp/src/ozon-seller/contract/reports.mjs +146 -0
  82. package/plugins/e-comet-skills/mcp/src/ozon-seller/contract/search-positions.contract.mjs +116 -0
  83. package/plugins/e-comet-skills/mcp/src/ozon-seller/domain/constants/errors.const.mjs +46 -0
  84. package/plugins/e-comet-skills/mcp/src/ozon-seller/domain/constants/limits.const.mjs +22 -0
  85. package/plugins/e-comet-skills/mcp/src/ozon-seller/domain/converters/errors.converter.mjs +185 -0
  86. package/plugins/e-comet-skills/mcp/src/{ozon-report-package-result.mjs → ozon-seller/domain/converters/package-result.converter.mjs} +19 -33
  87. package/plugins/e-comet-skills/mcp/src/{ozon-analytics-domain.mjs → ozon-seller/domain/policies/analytics.policy.mjs} +28 -47
  88. package/plugins/e-comet-skills/mcp/src/ozon-seller/domain/policies/package.policy.mjs +32 -0
  89. package/plugins/e-comet-skills/mcp/src/{ozon-promotion-domain.mjs → ozon-seller/domain/policies/promotion.policy.mjs} +15 -11
  90. package/plugins/e-comet-skills/mcp/src/{ozon-search-positions-domain.mjs → ozon-seller/domain/policies/search-positions.policy.mjs} +21 -18
  91. package/plugins/e-comet-skills/mcp/src/ozon-seller/in/mcp/authorize.mjs +80 -0
  92. package/plugins/e-comet-skills/mcp/src/ozon-seller/in/mcp/package.tool.mjs +124 -0
  93. package/plugins/e-comet-skills/mcp/src/ozon-seller/in/mcp/promotion-report.tool.mjs +132 -0
  94. package/plugins/e-comet-skills/mcp/src/ozon-seller/in/mcp/search-positions.tool.mjs +64 -0
  95. package/plugins/e-comet-skills/mcp/src/ozon-seller/out/artifacts/xlsx.mjs +12 -0
  96. package/plugins/e-comet-skills/mcp/src/ozon-seller/out/extension/authorization.mjs +14 -0
  97. package/plugins/e-comet-skills/mcp/src/ozon-seller/out/extension/package.mjs +449 -0
  98. package/plugins/e-comet-skills/mcp/src/ozon-seller/out/extension/promotion-route.mjs +52 -0
  99. package/plugins/e-comet-skills/mcp/src/ozon-seller/out/extension/promotion.mjs +225 -0
  100. package/plugins/e-comet-skills/mcp/src/ozon-seller/out/extension/validators.mjs +204 -0
  101. package/plugins/e-comet-skills/mcp/src/ozon-seller/ports/out/artifacts.port.mjs +1 -0
  102. package/plugins/e-comet-skills/mcp/src/ozon-seller/ports/out/authorization.port.mjs +1 -0
  103. package/plugins/e-comet-skills/mcp/src/ozon-seller/ports/out/foreign-jobs.port.mjs +1 -0
  104. package/plugins/e-comet-skills/mcp/src/ozon-seller/ports/out/lease.port.mjs +1 -0
  105. package/plugins/e-comet-skills/mcp/src/ozon-seller/ports/out/package.port.mjs +1 -0
  106. package/plugins/e-comet-skills/mcp/src/ozon-seller/ports/out/promotion.port.mjs +1 -0
  107. package/plugins/e-comet-skills/mcp/src/server.mjs +204 -121
  108. package/plugins/e-comet-skills/mcp/src/shared/coded-error.mjs +24 -0
  109. package/plugins/e-comet-skills/mcp/src/shared/run-progress.mjs +21 -0
  110. package/plugins/e-comet-skills/mcp/src/{schema-validation.mjs → shared/schema-validate.mjs} +64 -46
  111. package/plugins/e-comet-skills/mcp/src/shared/storage-unavailable.mjs +12 -0
  112. package/plugins/e-comet-skills/mcp/src/shared/timeouts.mjs +6 -0
  113. package/plugins/e-comet-skills/mcp/src/shared/values.mjs +31 -0
  114. package/plugins/e-comet-skills/mcp/src/storage/delivery.mjs +157 -0
  115. package/plugins/e-comet-skills/mcp/src/storage/files/layout.mjs +113 -0
  116. package/plugins/e-comet-skills/mcp/src/{file-retention.mjs → storage/files/retention.mjs} +18 -13
  117. package/plugins/e-comet-skills/mcp/src/{state-paths.mjs → storage/files/state-paths.mjs} +10 -10
  118. package/plugins/e-comet-skills/mcp/src/storage/files/transient-retry.mjs +22 -0
  119. package/plugins/e-comet-skills/mcp/src/storage/limits.mjs +7 -0
  120. package/plugins/e-comet-skills/mcp/src/{artifact-store.mjs → storage/writers/artifacts.mjs} +73 -107
  121. package/plugins/e-comet-skills/mcp/src/{result-store.mjs → storage/writers/results.mjs} +35 -41
  122. package/plugins/e-comet-skills/mcp/src/{xlsx-package.mjs → storage/writers/xlsx.mjs} +193 -164
  123. package/plugins/e-comet-skills/mcp/src/{feedback-zip.mjs → storage/writers/zip.mjs} +18 -62
  124. package/plugins/e-comet-skills/mcp/src/support/contract/evidence.mjs +23 -0
  125. package/plugins/e-comet-skills/mcp/src/support/diagnostics/application/diagnose.mjs +125 -0
  126. package/plugins/e-comet-skills/mcp/src/support/diagnostics/application/doctor.mjs +74 -0
  127. package/plugins/e-comet-skills/mcp/src/support/diagnostics/contract/diagnose.contract.mjs +55 -0
  128. package/plugins/e-comet-skills/mcp/src/support/diagnostics/contract/status.contract.mjs +218 -0
  129. package/plugins/e-comet-skills/mcp/src/support/diagnostics/in/mcp/diagnose.tool.mjs +40 -0
  130. package/plugins/e-comet-skills/mcp/src/support/diagnostics/in/mcp/status.tool.mjs +7 -0
  131. package/plugins/e-comet-skills/mcp/src/support/diagnostics/out/bridge/facts.mjs +15 -0
  132. package/plugins/e-comet-skills/mcp/src/support/diagnostics/out/codex/app-server.mjs +109 -0
  133. package/plugins/e-comet-skills/mcp/src/support/diagnostics/out/codex/hook-permissions.mjs +170 -0
  134. package/plugins/e-comet-skills/mcp/src/support/diagnostics/out/codex/mcp-auth.mjs +149 -0
  135. package/plugins/e-comet-skills/mcp/src/support/diagnostics/out/fs-probe/installation.mjs +46 -0
  136. package/plugins/e-comet-skills/mcp/src/support/diagnostics/out/fs-probe/storage.mjs +126 -0
  137. package/plugins/e-comet-skills/mcp/src/support/diagnostics/ports/out/bridge-facts.port.mjs +1 -0
  138. package/plugins/e-comet-skills/mcp/src/support/diagnostics/ports/out/codex.port.mjs +1 -0
  139. package/plugins/e-comet-skills/mcp/src/support/diagnostics/ports/out/installation.port.mjs +1 -0
  140. package/plugins/e-comet-skills/mcp/src/support/diagnostics/ports/out/storage-probe.port.mjs +1 -0
  141. package/plugins/e-comet-skills/mcp/src/support/feedback/application/evidence.mjs +105 -0
  142. package/plugins/e-comet-skills/mcp/src/support/feedback/application/flows.mjs +11 -0
  143. package/plugins/e-comet-skills/mcp/src/support/feedback/application/handoff.mjs +141 -0
  144. package/plugins/e-comet-skills/mcp/src/support/feedback/application/prepare.mjs +207 -0
  145. package/plugins/e-comet-skills/mcp/src/support/feedback/application/submit.mjs +144 -0
  146. package/plugins/e-comet-skills/mcp/src/support/feedback/contract/prepare.contract.mjs +93 -0
  147. package/plugins/e-comet-skills/mcp/src/support/feedback/contract/report.mjs +91 -0
  148. package/plugins/e-comet-skills/mcp/src/support/feedback/contract/results.mjs +122 -0
  149. package/plugins/e-comet-skills/mcp/src/support/feedback/contract/submit.contract.mjs +64 -0
  150. package/plugins/e-comet-skills/mcp/src/support/feedback/contract/tool-calls.mjs +50 -0
  151. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/constants/limits.const.mjs +25 -0
  152. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/converters/denial.converter.mjs +55 -0
  153. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/converters/errors.converter.mjs +97 -0
  154. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/converters/metadata.converter.mjs +42 -0
  155. package/plugins/e-comet-skills/mcp/src/{feedback-report.mjs → support/feedback/domain/converters/report.converter.mjs} +97 -71
  156. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/converters/snapshot.converter.mjs +453 -0
  157. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/converters/tool-outcome.converter.mjs +111 -0
  158. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/policies/evidence.policy.mjs +48 -0
  159. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/policies/handoff.policy.mjs +320 -0
  160. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/policies/transcript-tail.policy.mjs +42 -0
  161. package/plugins/e-comet-skills/mcp/src/support/feedback/domain/policies/upload-destination.policy.mjs +43 -0
  162. package/plugins/e-comet-skills/mcp/src/support/feedback/in/hook/envelopes.mjs +21 -0
  163. package/plugins/e-comet-skills/mcp/src/support/feedback/in/hook/events.mjs +184 -0
  164. package/plugins/e-comet-skills/mcp/src/support/feedback/in/mcp/prepare.tool.mjs +39 -0
  165. package/plugins/e-comet-skills/mcp/src/support/feedback/in/mcp/routes.mjs +117 -0
  166. package/plugins/e-comet-skills/mcp/src/support/feedback/in/mcp/submit.tool.mjs +48 -0
  167. package/plugins/e-comet-skills/mcp/src/support/feedback/out/artifacts/archive.mjs +44 -0
  168. package/plugins/e-comet-skills/mcp/src/{feedback-artifact-store.mjs → support/feedback/out/artifacts/store.mjs} +122 -86
  169. package/plugins/e-comet-skills/mcp/src/support/feedback/out/grants/handoff.mjs +310 -0
  170. package/plugins/e-comet-skills/mcp/src/support/feedback/out/transcript/file.mjs +67 -0
  171. package/plugins/e-comet-skills/mcp/src/support/feedback/out/transcript/tool-calls.mjs +150 -0
  172. package/plugins/e-comet-skills/mcp/src/support/feedback/out/upload/http.mjs +165 -0
  173. package/plugins/e-comet-skills/mcp/src/support/feedback/ports/in/feedback.port.mjs +1 -0
  174. package/plugins/e-comet-skills/mcp/src/support/feedback/ports/out/archive.port.mjs +1 -0
  175. package/plugins/e-comet-skills/mcp/src/support/feedback/ports/out/device-evidence.port.mjs +1 -0
  176. package/plugins/e-comet-skills/mcp/src/support/feedback/ports/out/grants.port.mjs +1 -0
  177. package/plugins/e-comet-skills/mcp/src/support/feedback/ports/out/tool-names.port.mjs +1 -0
  178. package/plugins/e-comet-skills/mcp/src/support/feedback/ports/out/transcript.port.mjs +1 -0
  179. package/plugins/e-comet-skills/mcp/src/support/feedback/ports/out/upload.port.mjs +1 -0
  180. package/plugins/e-comet-skills/mcp/src/{bridge-codes.mjs → transport/diagnostics/bridge-codes.mjs} +28 -22
  181. package/plugins/e-comet-skills/mcp/src/{diagnostic-facts.mjs → transport/diagnostics/facts.mjs} +99 -95
  182. package/plugins/e-comet-skills/mcp/src/transport/diagnostics/vocabulary.mjs +63 -0
  183. package/plugins/e-comet-skills/mcp/src/transport/extension/events.mjs +9 -0
  184. package/plugins/e-comet-skills/mcp/src/transport/extension/identity.mjs +4 -0
  185. package/plugins/e-comet-skills/mcp/src/{extension-vocabulary.mjs → transport/extension/wire.mjs} +65 -63
  186. package/plugins/e-comet-skills/mcp/src/transport/failures/evidence.mjs +205 -0
  187. package/plugins/e-comet-skills/mcp/src/transport/failures/rejection.mjs +79 -0
  188. package/plugins/e-comet-skills/mcp/src/transport/failures/vocabulary.mjs +183 -0
  189. package/plugins/e-comet-skills/mcp/src/transport/mcp/hook-status.mjs +7 -0
  190. package/plugins/e-comet-skills/mcp/src/transport/mcp/limits.mjs +7 -0
  191. package/plugins/e-comet-skills/mcp/src/transport/mcp/prose.mjs +39 -0
  192. package/plugins/e-comet-skills/mcp/src/transport/mcp/results.mjs +257 -0
  193. package/plugins/e-comet-skills/mcp/src/transport/mcp/schema.mjs +21 -0
  194. package/plugins/e-comet-skills/mcp/src/transport/mcp/tool-contract.mjs +1 -0
  195. package/plugins/e-comet-skills/mcp/src/wb-client/application/concurrency.mjs +39 -0
  196. package/plugins/e-comet-skills/mcp/src/wb-client/application/job-limits.mjs +237 -0
  197. package/plugins/e-comet-skills/mcp/src/wb-client/application/product-images.mjs +120 -0
  198. package/plugins/e-comet-skills/mcp/src/wb-client/application/run-buyer-job.mjs +631 -0
  199. package/plugins/e-comet-skills/mcp/src/wb-client/contract/check.contract.mjs +67 -0
  200. package/plugins/e-comet-skills/mcp/src/wb-client/contract/filters.contract.mjs +72 -0
  201. package/plugins/e-comet-skills/mcp/src/wb-client/contract/images.contract.mjs +67 -0
  202. package/plugins/e-comet-skills/mcp/src/wb-client/contract/live.mjs +128 -0
  203. package/plugins/e-comet-skills/mcp/src/wb-client/contract/product-card.contract.mjs +87 -0
  204. package/plugins/e-comet-skills/mcp/src/wb-client/contract/recommendations.contract.mjs +76 -0
  205. package/plugins/e-comet-skills/mcp/src/wb-client/contract/search.contract.mjs +65 -0
  206. package/plugins/e-comet-skills/mcp/src/wb-client/domain/constants/descriptors.const.mjs +23 -0
  207. package/plugins/e-comet-skills/mcp/src/wb-client/domain/constants/limits.const.mjs +40 -0
  208. package/plugins/e-comet-skills/mcp/src/wb-client/domain/converters/descriptor-urls.converter.mjs +48 -0
  209. package/plugins/e-comet-skills/mcp/src/{wb-filters-domain.mjs → wb-client/domain/converters/filters.converter.mjs} +49 -37
  210. package/plugins/e-comet-skills/mcp/src/wb-client/domain/converters/images.converter.mjs +10 -0
  211. package/plugins/e-comet-skills/mcp/src/wb-client/domain/converters/products.converter.mjs +121 -0
  212. package/plugins/e-comet-skills/mcp/src/wb-client/domain/policies/response.policy.mjs +16 -0
  213. package/plugins/e-comet-skills/mcp/src/wb-client/domain/policies/wb-url.policy.mjs +35 -0
  214. package/plugins/e-comet-skills/mcp/src/wb-client/domain/types/job.types.mjs +1 -0
  215. package/plugins/e-comet-skills/mcp/src/wb-client/in/mcp/buyer.tool.mjs +182 -0
  216. package/plugins/e-comet-skills/mcp/src/wb-client/in/mcp/images.tool.mjs +108 -0
  217. package/plugins/e-comet-skills/mcp/src/wb-client/out/extension/authorization.mjs +15 -0
  218. package/plugins/e-comet-skills/mcp/src/wb-client/out/extension/wb-fetch.mjs +67 -0
  219. package/plugins/e-comet-skills/mcp/src/wb-client/out/results/ndjson.mjs +32 -0
  220. package/plugins/e-comet-skills/mcp/src/wb-client/out/wb-cdn/images.mjs +41 -0
  221. package/plugins/e-comet-skills/mcp/src/wb-client/ports/out/authorization.port.mjs +1 -0
  222. package/plugins/e-comet-skills/mcp/src/wb-client/ports/out/images.port.mjs +1 -0
  223. package/plugins/e-comet-skills/mcp/src/wb-client/ports/out/results.port.mjs +1 -0
  224. package/plugins/e-comet-skills/mcp/src/wb-client/ports/out/wb-fetch.port.mjs +1 -0
  225. package/plugins/e-comet-skills/mcp/src/wb-seller/application/export-reviews.mjs +457 -0
  226. package/plugins/e-comet-skills/mcp/src/wb-seller/application/job-limits.mjs +89 -0
  227. package/plugins/e-comet-skills/mcp/src/wb-seller/contract/reviews.contract.mjs +93 -0
  228. package/plugins/e-comet-skills/mcp/src/wb-seller/domain/constants/limits.const.mjs +38 -0
  229. package/plugins/e-comet-skills/mcp/src/wb-seller/in/mcp/reviews.tool.mjs +100 -0
  230. package/plugins/e-comet-skills/mcp/src/wb-seller/out/artifacts/xlsx.mjs +12 -0
  231. package/plugins/e-comet-skills/mcp/src/wb-seller/out/extension/authorization.mjs +14 -0
  232. package/plugins/e-comet-skills/mcp/src/wb-seller/out/extension/operations.mjs +181 -0
  233. package/plugins/e-comet-skills/mcp/src/wb-seller/out/extension/validators.mjs +38 -0
  234. package/plugins/e-comet-skills/mcp/src/wb-seller/ports/out/artifacts.port.mjs +1 -0
  235. package/plugins/e-comet-skills/mcp/src/wb-seller/ports/out/authorization.port.mjs +1 -0
  236. package/plugins/e-comet-skills/mcp/src/wb-seller/ports/out/seller-operations.port.mjs +1 -0
  237. package/README.md +0 -361
  238. package/deepseek/src/account-rpc.mjs +0 -13
  239. package/deepseek/src/account-service.mjs +0 -37
  240. package/deepseek/src/account.mjs +0 -192
  241. package/deepseek/src/adapter.mjs +0 -166
  242. package/deepseek/src/feedback-services.mjs +0 -132
  243. package/deepseek/src/feedback.mjs +0 -174
  244. package/deepseek/src/oauth.mjs +0 -164
  245. package/deepseek/src/private-result.mjs +0 -22
  246. package/deepseek/src/remote-client.mjs +0 -33
  247. package/deepseek/src/retry.mjs +0 -30
  248. package/deepseek/src/runtime.mjs +0 -325
  249. package/deepseek/src/status-context.mjs +0 -56
  250. package/deepseek/src/update-install.mjs +0 -46
  251. package/deepseek/src/update-policy.mjs +0 -56
  252. package/deepseek/src/updates.mjs +0 -125
  253. package/deepseek/src/version.mjs +0 -3
  254. package/plugins/e-comet-skills/hooks/hook-diagnostics.mjs +0 -85
  255. package/plugins/e-comet-skills/hooks/transient-file-operation.mjs +0 -14
  256. package/plugins/e-comet-skills/mcp/src/browser-job.mjs +0 -1589
  257. package/plugins/e-comet-skills/mcp/src/codex-app-server.mjs +0 -60
  258. package/plugins/e-comet-skills/mcp/src/codex-hook-permissions.mjs +0 -81
  259. package/plugins/e-comet-skills/mcp/src/codex-mcp-auth.mjs +0 -87
  260. package/plugins/e-comet-skills/mcp/src/config.mjs +0 -187
  261. package/plugins/e-comet-skills/mcp/src/diagnose.mjs +0 -157
  262. package/plugins/e-comet-skills/mcp/src/extension-protocol.mjs +0 -612
  263. package/plugins/e-comet-skills/mcp/src/feedback-device-diagnostics.mjs +0 -257
  264. package/plugins/e-comet-skills/mcp/src/feedback-device-evidence.mjs +0 -144
  265. package/plugins/e-comet-skills/mcp/src/feedback-diagnostics.mjs +0 -78
  266. package/plugins/e-comet-skills/mcp/src/feedback-errors.mjs +0 -44
  267. package/plugins/e-comet-skills/mcp/src/feedback-metadata.mjs +0 -42
  268. package/plugins/e-comet-skills/mcp/src/feedback-tool-calls.mjs +0 -321
  269. package/plugins/e-comet-skills/mcp/src/feedback-tools.mjs +0 -435
  270. package/plugins/e-comet-skills/mcp/src/feedback-upload.mjs +0 -181
  271. package/plugins/e-comet-skills/mcp/src/mcp-dispatcher.mjs +0 -1237
  272. package/plugins/e-comet-skills/mcp/src/mcp-protocol.mjs +0 -28
  273. package/plugins/e-comet-skills/mcp/src/operation-diagnostics.mjs +0 -79
  274. package/plugins/e-comet-skills/mcp/src/ozon-analytics-job.mjs +0 -81
  275. package/plugins/e-comet-skills/mcp/src/ozon-promotion-job.mjs +0 -172
  276. package/plugins/e-comet-skills/mcp/src/ozon-report-package-domain.mjs +0 -33
  277. package/plugins/e-comet-skills/mcp/src/ozon-report-package-job.mjs +0 -277
  278. package/plugins/e-comet-skills/mcp/src/ozon-search-positions-job.mjs +0 -125
  279. package/plugins/e-comet-skills/mcp/src/report-delivery.mjs +0 -131
  280. package/plugins/e-comet-skills/mcp/src/request-broker.mjs +0 -1539
  281. package/plugins/e-comet-skills/mcp/src/run-registry.mjs +0 -88
  282. package/plugins/e-comet-skills/mcp/src/server-routing.mjs +0 -92
  283. package/plugins/e-comet-skills/mcp/src/storage-layout.mjs +0 -115
  284. package/plugins/e-comet-skills/mcp/src/tool-catalog.mjs +0 -277
  285. package/plugins/e-comet-skills/mcp/src/tool-contracts.mjs +0 -375
  286. package/plugins/e-comet-skills/mcp/src/tool-errors.mjs +0 -346
  287. package/plugins/e-comet-skills/mcp/src/tool-schemas.mjs +0 -1231
  288. package/plugins/e-comet-skills/mcp/src/wb-domain.mjs +0 -304
@@ -0,0 +1,20 @@
1
+ /** Browser-safe descriptors for the native account API. No model tools expose these methods. */
2
+ export const ACCOUNT_REMOTE = {
3
+ package: 'dsh-e-comet-skills',
4
+ descriptors: ['getStatus', 'startLogin', 'cancelLogin', 'disconnect'].map((method) => ({
5
+ id: `dsh-e-comet-skills#eCometAccount/${method}`,
6
+ service: 'eCometAccount',
7
+ namespace: 'eCometAccount',
8
+ method,
9
+ invocation: { kind: 'direct' },
10
+ parameters: [],
11
+ result: { mode: 'src-json' },
12
+ })),
13
+ };
14
+ export const ACCOUNT_HOST = {
15
+ package: ACCOUNT_REMOTE.package,
16
+ face: 'host',
17
+ schemas: [],
18
+ model: { services: [], events: [], objects: [] },
19
+ invocations: ACCOUNT_REMOTE.descriptors,
20
+ };
@@ -0,0 +1,39 @@
1
+ import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
2
+ import { ACCOUNT_HOST } from './account-rpc.mjs';
3
+ // The root always passes the account; a call without one fails, as reading through it always did.
4
+ const present = (value) => {
5
+ if (value === undefined)
6
+ throw new TypeError('The e-Comet account service is missing a dependency.');
7
+ return value;
8
+ };
9
+ export class AccountService extends TypertRemoteService {
10
+ static inject = ['typert'];
11
+ constructor(ctx, { account, connections, localStatus } = {}) {
12
+ super(ctx, 'eCometAccount', { namespace: 'eCometAccount' });
13
+ this.account = account;
14
+ this.connections = connections;
15
+ this.localStatus = localStatus;
16
+ // The fixed gateway name assumes one live plugin instance: see "Native DeepSeek registrations assume one live
17
+ // plugin instance" in docs/architecture/residuals/deepseek.md.
18
+ ctx.effect(() => ctx.typert.register(ACCOUNT_HOST));
19
+ }
20
+ async getStatus() {
21
+ const local = this.connections && this.localStatus ? await this.localStatus() : undefined;
22
+ // Recovery may finish during the bridge read; snapshot all synchronous state afterward.
23
+ const connections = this.connections ? { ...this.connections, ...(this.localStatus ? { local } : {}) } : undefined;
24
+ return {
25
+ ...present(this.account).getStatus(),
26
+ ...(connections ? { connections } : {}),
27
+ };
28
+ }
29
+ // The account resolves as soon as the browser URL exists or the attempt ends.
30
+ startLogin() {
31
+ return present(this.account).startLogin();
32
+ }
33
+ cancelLogin() {
34
+ return present(this.account).cancelLogin();
35
+ }
36
+ disconnect() {
37
+ return present(this.account).disconnect();
38
+ }
39
+ }
@@ -0,0 +1,282 @@
1
+ import { auth } from '@modelcontextprotocol/sdk/client/auth.js';
2
+ import { mkdir, mkdtemp, rm } from 'node:fs/promises';
3
+ import { join } from 'node:path';
4
+ import { isRecord } from '../../../plugins/e-comet-skills/mcp/src/shared/values.mjs';
5
+ import { RETRY_POLICIES, retryTransientFileOperation } from '../../../plugins/e-comet-skills/mcp/src/storage/files/transient-retry.mjs';
6
+ import { FileOAuthProvider, CREDENTIAL_DIRECTORY, REMOTE_URL, OAUTH_ISSUER_ORIGIN, createTrustedFetch, startCallback, } from './oauth.mjs';
7
+ import { isLoginRequired } from './remote-client.mjs';
8
+ import { createRetry, RECONNECT_DELAYS_MS } from './retry.mjs';
9
+ const CONNECTION_FAILED = 'connection-failed';
10
+ // A saved account whose connection dropped: the Host keeps retrying with the saved credentials.
11
+ const RECONNECTING = 'reconnecting';
12
+ const LOGIN_EXPIRED = 'login-expired';
13
+ /** Host-only account owner. Its public views never contain credentials. */
14
+ export function createAccount({ directory = CREDENTIAL_DIRECTORY, fetchImpl = fetch, connectRemote, disconnectRemote, isRemoteConnected = () => true, timeoutMs = 300_000, retryDelaysMs = RECONNECT_DELAYS_MS, }) {
15
+ const saved = new FileOAuthProvider({ directory });
16
+ let status = { state: 'checking' };
17
+ let attempt;
18
+ let disposed = false;
19
+ const getStatus = () => {
20
+ if (status.state === 'connected' && !isRemoteConnected())
21
+ status = { state: 'error', errorCode: CONNECTION_FAILED };
22
+ return { ...status };
23
+ };
24
+ const hasSavedLogin = async () => Boolean((await saved.tokens())?.access_token);
25
+ // Reconnecting with saved credentials has no side effect beyond the connection itself, so it
26
+ // never waits for a click. An expired sign-in or an explicit login attempt stops it.
27
+ const reconnect = createRetry(async () => {
28
+ if (disposed || attempt || status.errorCode !== RECONNECTING)
29
+ return true;
30
+ const recovering = status;
31
+ const ownsRecovery = () => !disposed && !attempt && status === recovering;
32
+ const savedLogin = await hasSavedLogin();
33
+ if (!ownsRecovery())
34
+ return true;
35
+ if (!savedLogin) {
36
+ status = { state: 'logged_out' };
37
+ return true;
38
+ }
39
+ try {
40
+ await connectRemote();
41
+ }
42
+ catch (error) {
43
+ if (!ownsRecovery())
44
+ return true;
45
+ if (isLoginRequired(error)) {
46
+ status = { state: 'error', errorCode: LOGIN_EXPIRED };
47
+ return true;
48
+ }
49
+ return false;
50
+ }
51
+ if (ownsRecovery())
52
+ status = { state: 'connected' };
53
+ return true;
54
+ }, { delays: retryDelaysMs });
55
+ function connectionLost() {
56
+ status = { state: 'error', errorCode: RECONNECTING };
57
+ reconnect.schedule();
58
+ }
59
+ async function initialize() {
60
+ if (disposed || attempt)
61
+ return getStatus();
62
+ const checking = (status = { state: 'checking' });
63
+ // Startup runs independently of Host readiness. A manual action or disposal
64
+ // owns its newer state even when the saved-account handshake finishes later.
65
+ const ownsStatus = () => !disposed && !attempt && status === checking;
66
+ try {
67
+ const savedLogin = await hasSavedLogin();
68
+ if (!ownsStatus())
69
+ return getStatus();
70
+ if (!savedLogin) {
71
+ status = { state: 'logged_out' };
72
+ return getStatus();
73
+ }
74
+ await connectRemote();
75
+ if (ownsStatus())
76
+ status = { state: 'connected' };
77
+ }
78
+ catch (error) {
79
+ if (ownsStatus()) {
80
+ if (isLoginRequired(error))
81
+ status = { state: 'error', errorCode: LOGIN_EXPIRED };
82
+ else
83
+ connectionLost();
84
+ }
85
+ }
86
+ return getStatus();
87
+ }
88
+ /** The Host reports a remote connection that ended without an account action. */
89
+ function remoteLost(reason) {
90
+ if (disposed || attempt || status.state !== 'connected')
91
+ return;
92
+ if (reason === 'login_required') {
93
+ reconnect.reset();
94
+ status = { state: 'error', errorCode: LOGIN_EXPIRED };
95
+ return;
96
+ }
97
+ connectionLost();
98
+ }
99
+ async function cancelLogin() {
100
+ const current = attempt;
101
+ if (current) {
102
+ current.cancelled = true;
103
+ current.abort.abort();
104
+ current.callback?.close();
105
+ await current.done;
106
+ if (attempt === current)
107
+ attempt = undefined;
108
+ status = { state: 'logged_out' };
109
+ }
110
+ else if (status.state !== 'connected') {
111
+ // The card can cancel while the initial credential read is still pending.
112
+ reconnect.reset();
113
+ status = { state: 'logged_out' };
114
+ }
115
+ return getStatus();
116
+ }
117
+ async function startLogin() {
118
+ if (disposed)
119
+ throw new Error('e-Comet account service has stopped.');
120
+ // Keep an automatic recovery alive until the manual credential read succeeds.
121
+ // Startup still loses ownership immediately when a manual login begins.
122
+ if (status.errorCode !== RECONNECTING)
123
+ status = { ...status };
124
+ if (attempt)
125
+ await cancelLogin();
126
+ if (getStatus().state === 'connected')
127
+ return getStatus();
128
+ const starting = status;
129
+ const retrySavedConnection = status.errorCode === RECONNECTING;
130
+ const savedLogin = await hasSavedLogin();
131
+ if (disposed || status !== starting)
132
+ return getStatus();
133
+ // A temporary credential read failure must leave automatic recovery scheduled.
134
+ reconnect.reset();
135
+ let resolveReady;
136
+ const ready = new Promise((resolve) => {
137
+ resolveReady = resolve;
138
+ });
139
+ const current = { abort: new AbortController(), cancelled: false };
140
+ const signal = AbortSignal.any([current.abort.signal, AbortSignal.timeout(timeoutMs)]);
141
+ attempt = current;
142
+ status = { state: 'connecting' };
143
+ current.done = (async () => {
144
+ let temporary;
145
+ try {
146
+ if (savedLogin) {
147
+ // A valid saved login reconnects without sending the user through the browser again.
148
+ let restored = false;
149
+ try {
150
+ await connectRemote();
151
+ restored = true;
152
+ }
153
+ catch (error) {
154
+ // An outage does not invalidate the saved login. Only a classified refusal needs OAuth.
155
+ if (!isLoginRequired(error)) {
156
+ if (!current.cancelled)
157
+ status = { state: 'error', errorCode: RECONNECTING };
158
+ return;
159
+ }
160
+ }
161
+ if (current.cancelled) {
162
+ if (restored)
163
+ await disconnectRemote();
164
+ return;
165
+ }
166
+ if (restored) {
167
+ status = { state: 'connected' };
168
+ return;
169
+ }
170
+ }
171
+ await mkdir(directory, { recursive: true, mode: 0o700 });
172
+ temporary = await mkdtemp(join(directory, 'login-'));
173
+ const provider = new FileOAuthProvider({
174
+ directory: temporary,
175
+ onAuthorization(url) {
176
+ if (url.origin !== OAUTH_ISSUER_ORIGIN)
177
+ throw new Error('Untrusted authorization URL.');
178
+ if (current.cancelled)
179
+ throw new Error('OAuth login cancelled.');
180
+ status = { state: 'connecting', authorizationUrl: url.href };
181
+ resolveReady({ state: 'connecting', authorizationUrl: url.href });
182
+ },
183
+ });
184
+ current.callback = await startCallback(await provider.state(), { timeoutMs });
185
+ // The same deadline owns discovery and token exchange, not just the browser wait.
186
+ current.callback.code.catch((error) => current.abort.abort(error));
187
+ if (current.cancelled) {
188
+ current.callback.close();
189
+ throw new Error('OAuth login cancelled.');
190
+ }
191
+ provider.callbackUrl = current.callback.url;
192
+ const fetchFn = createTrustedFetch((input, options) => fetchImpl(input, { ...options, signal }));
193
+ const result = await auth(provider, { serverUrl: REMOTE_URL, fetchFn });
194
+ if (result === 'REDIRECT')
195
+ await auth(provider, { serverUrl: REMOTE_URL, authorizationCode: await current.callback.code, fetchFn });
196
+ if (current.cancelled)
197
+ throw new Error('OAuth login cancelled.');
198
+ await provider.invalidateCredentials('verifier');
199
+ await saved.update(await provider.read());
200
+ if (current.cancelled) {
201
+ await saved.invalidateCredentials('all');
202
+ return;
203
+ }
204
+ // Remote bootstrap still uses the SDK's bounded timeout; cancellation
205
+ // at this stage may await that deadline; cancellation is not instantaneous here.
206
+ try {
207
+ await connectRemote();
208
+ }
209
+ catch (error) {
210
+ // OAuth is already saved: a bootstrap outage must recover with those
211
+ // credentials instead of requiring another browser login.
212
+ // Cancellation owns this fresh login even when bootstrap fails; otherwise
213
+ // the next startup would silently restore the cancelled credentials.
214
+ if (current.cancelled)
215
+ await saved.invalidateCredentials('all');
216
+ else
217
+ status = { state: 'error', errorCode: isLoginRequired(error) ? LOGIN_EXPIRED : RECONNECTING };
218
+ return;
219
+ }
220
+ if (current.cancelled) {
221
+ await disconnectRemote();
222
+ await saved.invalidateCredentials('all');
223
+ return;
224
+ }
225
+ status = { state: 'connected' };
226
+ }
227
+ catch (error) {
228
+ const failed = isRecord(error) ? error : {};
229
+ if (!current.cancelled)
230
+ status = {
231
+ state: 'error',
232
+ errorCode: failed.errorCode === 'authorization-declined'
233
+ ? 'authorization-declined'
234
+ : retrySavedConnection
235
+ ? RECONNECTING
236
+ : failed.name === 'TimeoutError' || failed.errorCode === 'connection-timeout'
237
+ ? 'connection-timeout'
238
+ : CONNECTION_FAILED,
239
+ };
240
+ }
241
+ finally {
242
+ current.callback?.close();
243
+ // This attempt owns only its login directory; other profiles may still be signing in.
244
+ // Permanent refusal is an accepted residual in docs/architecture/residuals/deepseek.md.
245
+ const owned = temporary;
246
+ if (owned)
247
+ await retryTransientFileOperation(() => rm(owned, { recursive: true, force: true }), RETRY_POLICIES.FEEDBACK).catch(() => console.warn('[e-Comet] Login temporary cleanup failed.'));
248
+ resolveReady(getStatus());
249
+ if (attempt === current)
250
+ attempt = undefined;
251
+ // Failed manual recovery must not cancel saved-account retries. Schedule
252
+ // only after cleanup: an earlier timer can observe the active attempt and stop.
253
+ if (!disposed && !current.cancelled && status.errorCode === RECONNECTING)
254
+ reconnect.schedule();
255
+ }
256
+ })();
257
+ return ready;
258
+ }
259
+ async function disconnect() {
260
+ status = { ...status }; // A pending startup read must not begin another connection.
261
+ reconnect.reset();
262
+ await cancelLogin();
263
+ await disconnectRemote({ forgetLogin: true });
264
+ try {
265
+ await saved.invalidateCredentials('all');
266
+ }
267
+ catch (error) {
268
+ // Respect the explicit unlink: retained credentials must not trigger recovery here.
269
+ // See "Native DeepSeek failed unlink" in docs/architecture/residuals/deepseek.md.
270
+ status = { state: 'error', errorCode: 'unlink-failed' };
271
+ throw error;
272
+ }
273
+ status = { state: 'logged_out' };
274
+ return getStatus();
275
+ }
276
+ async function dispose() {
277
+ disposed = true;
278
+ reconnect.stop();
279
+ await cancelLogin();
280
+ }
281
+ return { initialize, getStatus, startLogin, waitForLogin: () => attempt?.done, cancelLogin, disconnect, dispose, remoteLost };
282
+ }
@@ -0,0 +1,260 @@
1
+ import { randomBytes } from 'node:crypto';
2
+ import { mkdir, readFile, writeFile, rename, chmod, rm } from 'node:fs/promises';
3
+ import { createServer } from 'node:http';
4
+ import { homedir } from 'node:os';
5
+ import { join } from 'node:path';
6
+ import { isRecord } from '../../../plugins/e-comet-skills/mcp/src/shared/values.mjs';
7
+ import { RETRY_POLICIES, retryTransientFileOperation } from '../../../plugins/e-comet-skills/mcp/src/storage/files/transient-retry.mjs';
8
+ // Any object reads as a store: only this process writes the file, and its fields keep the shapes it wrote.
9
+ const isCredentials = (value) => isRecord(value);
10
+ export const REMOTE_URL = 'https://mcp.e-comet.io/mcp';
11
+ export const OAUTH_ISSUER_ORIGIN = 'https://auth.mcp.e-comet.io';
12
+ export const CREDENTIAL_DIRECTORY = join(homedir(), '.e-comet-deepseek-harness', 'account');
13
+ export class LoginRequiredError extends Error {
14
+ constructor() {
15
+ super('e-Comet login required. Open Plugins → e-Comet Skills in DeepSeek and connect your account.');
16
+ this.name = 'LoginRequiredError';
17
+ }
18
+ }
19
+ /** SDK OAuthClientProvider. Credentials are never returned as MCP content. */
20
+ export class FileOAuthProvider {
21
+ #savingStopped = false;
22
+ #writes = new Set();
23
+ constructor({ directory = CREDENTIAL_DIRECTORY, redirectUrl, onAuthorization, } = {}) {
24
+ this.directory = directory;
25
+ this.file = join(directory, 'credentials.json');
26
+ this.callbackUrl = redirectUrl;
27
+ this.onAuthorization = onAuthorization;
28
+ this.oauthState = randomBytes(32).toString('hex');
29
+ }
30
+ get redirectUrl() {
31
+ return this.callbackUrl ?? 'http://127.0.0.1/callback';
32
+ }
33
+ get clientMetadata() {
34
+ return {
35
+ client_name: 'e-Comet DeepSeek Harness',
36
+ redirect_uris: [this.redirectUrl],
37
+ grant_types: ['authorization_code', 'refresh_token'],
38
+ response_types: ['code'],
39
+ token_endpoint_auth_method: 'client_secret_post',
40
+ };
41
+ }
42
+ state() {
43
+ return this.oauthState;
44
+ }
45
+ async read() {
46
+ try {
47
+ const state = JSON.parse(await readFile(this.file, 'utf8'));
48
+ return isCredentials(state) ? state : {};
49
+ }
50
+ catch (error) {
51
+ if ((isRecord(error) && error.code === 'ENOENT') || error instanceof SyntaxError)
52
+ return {};
53
+ // Other failures keep automatic reconnection: "Native DeepSeek unreadable credential store"
54
+ // in docs/architecture/residuals/deepseek.md.
55
+ throw new Error('Cannot read e-Comet login state. Check access to the credentials directory.', { cause: error });
56
+ }
57
+ }
58
+ async stopSaving() {
59
+ this.#savingStopped = true;
60
+ // A rename already in flight must finish before the account owner deletes credentials.
61
+ await Promise.allSettled(this.#writes);
62
+ }
63
+ update(patch) {
64
+ if (this.#savingStopped)
65
+ return Promise.resolve();
66
+ const writing = this.#write(patch);
67
+ this.#writes.add(writing);
68
+ writing.then(() => this.#writes.delete(writing), () => this.#writes.delete(writing));
69
+ return writing;
70
+ }
71
+ async #write(patch) {
72
+ await mkdir(this.directory, { recursive: true, mode: 0o700 });
73
+ await chmod(this.directory, 0o700);
74
+ const temporary = join(this.directory, `credentials-${randomBytes(8).toString('hex')}.tmp`);
75
+ try {
76
+ await writeFile(temporary, JSON.stringify({ ...(await this.read()), ...patch }), { mode: 0o600, flag: 'wx' });
77
+ await retryTransientFileOperation(() => rename(temporary, this.file), RETRY_POLICIES.FEEDBACK);
78
+ await chmod(this.file, 0o600);
79
+ }
80
+ finally {
81
+ // Preserve the publication error and other profiles' active files; see
82
+ // docs/architecture/residuals/deepseek.md for permanent refusal and refresh races.
83
+ await retryTransientFileOperation(() => rm(temporary, { force: true }), RETRY_POLICIES.FEEDBACK).catch(() => { });
84
+ }
85
+ }
86
+ async tokens() {
87
+ return (await this.read()).tokens;
88
+ }
89
+ async saveTokens(tokens) {
90
+ await this.update({ tokens });
91
+ }
92
+ async clientInformation() {
93
+ return (await this.read()).clientInformation;
94
+ }
95
+ async saveClientInformation(clientInformation) {
96
+ await this.update({ clientInformation, redirectUrl: this.redirectUrl });
97
+ }
98
+ async saveCodeVerifier(codeVerifier) {
99
+ await this.update({ codeVerifier });
100
+ }
101
+ async codeVerifier() {
102
+ const verifier = (await this.read()).codeVerifier;
103
+ if (!verifier)
104
+ throw new LoginRequiredError();
105
+ return verifier;
106
+ }
107
+ async redirectToAuthorization(url) {
108
+ if (!this.onAuthorization) {
109
+ // The SDK also reaches this fallback after an unavailable refresh; rejected
110
+ // grants/clients are cleared first. Retained credentials do not prove expiry.
111
+ if ((await this.tokens())?.refresh_token)
112
+ throw new Error('e-Comet token refresh could not complete. Check connection diagnostics before retrying.');
113
+ throw new LoginRequiredError();
114
+ }
115
+ if (url.protocol !== 'https:' || url.username || url.password)
116
+ throw new Error('Invalid OAuth authorization URL.');
117
+ await this.onAuthorization(url);
118
+ }
119
+ async validateResourceURL(serverUrl, resource) {
120
+ if (new URL(serverUrl).origin !== new URL(REMOTE_URL).origin)
121
+ throw new Error('Untrusted MCP resource.');
122
+ if (resource && new URL(resource).origin !== new URL(REMOTE_URL).origin)
123
+ throw new Error('Untrusted OAuth resource.');
124
+ return new URL(resource ?? REMOTE_URL);
125
+ }
126
+ async invalidateCredentials(scope) {
127
+ const patch = {};
128
+ if (scope === 'all' || scope === 'tokens')
129
+ patch.tokens = undefined;
130
+ if (scope === 'all' || scope === 'client')
131
+ patch.clientInformation = undefined;
132
+ if (scope === 'all' || scope === 'verifier')
133
+ patch.codeVerifier = undefined;
134
+ await this.update(patch);
135
+ }
136
+ }
137
+ // e-Comet's MCP log tells hosts apart only by User-Agent, and Node's default `node` is also every script's.
138
+ export const CLIENT_NAME = 'e-comet-deepseek-harness';
139
+ /** Only e-Comet and the HTTPS issuer advertised by its protected-resource metadata. */
140
+ export function createTrustedFetch(fetchImpl = fetch, userAgent = CLIENT_NAME) {
141
+ const resourceOrigin = new URL(REMOTE_URL).origin;
142
+ const allowedOrigins = new Set([resourceOrigin]);
143
+ let issuer;
144
+ // The URL parser reads any value as its string form.
145
+ function secure(value) {
146
+ const url = new URL(String(value));
147
+ if (url.protocol !== 'https:' || url.username || url.password)
148
+ throw new Error('OAuth requires HTTPS without embedded credentials.');
149
+ return url;
150
+ }
151
+ return async (input, options = {}) => {
152
+ const url = secure(typeof input === 'object' && 'url' in input ? input.url : String(input));
153
+ if (!allowedOrigins.has(url.origin))
154
+ throw new Error('OAuth endpoint is not trusted by e-Comet discovery.');
155
+ const headers = new Headers(options.headers ?? (input instanceof Request ? input.headers : undefined));
156
+ headers.set('User-Agent', userAgent);
157
+ const response = await fetchImpl(input, { ...options, headers, redirect: 'error' });
158
+ if (response.ok && url.pathname.includes('/.well-known/')) {
159
+ // Parse boundary: discovery metadata as the server sent it. JSON null has no fields to read; other
160
+ // non-objects read every field as absent.
161
+ const metadata = await response.clone().json();
162
+ if (metadata === null)
163
+ throw new TypeError('OAuth discovery metadata is null.');
164
+ const field = (key) => (isRecord(metadata) ? metadata[key] : undefined);
165
+ if (url.origin === resourceOrigin && url.pathname.includes('oauth-protected-resource')) {
166
+ if (secure(field('resource')).origin !== resourceOrigin)
167
+ throw new Error('Untrusted protected resource metadata.');
168
+ const servers = field('authorization_servers');
169
+ // Read the first entry the way an index read always did, whatever the server sent.
170
+ const server = typeof servers === 'string' || Array.isArray(servers) ? servers[0] : isRecord(servers) ? servers['0'] : undefined;
171
+ if (!server)
172
+ throw new Error('e-Comet did not advertise an OAuth issuer.');
173
+ issuer = secure(server);
174
+ if (issuer.origin !== OAUTH_ISSUER_ORIGIN)
175
+ throw new Error('Untrusted e-Comet OAuth issuer.');
176
+ allowedOrigins.add(issuer.origin);
177
+ }
178
+ else if (field('issuer')) {
179
+ if (!issuer || secure(field('issuer')).href !== issuer.href)
180
+ throw new Error('OAuth issuer differs from e-Comet discovery.');
181
+ for (const key of ['authorization_endpoint', 'token_endpoint', 'registration_endpoint']) {
182
+ if (field(key) && secure(field(key)).origin !== issuer.origin)
183
+ throw new Error('OAuth endpoint differs from the discovered issuer.');
184
+ }
185
+ }
186
+ }
187
+ return response;
188
+ };
189
+ }
190
+ /** One login attempt owns an ephemeral loopback listener and unpredictable OAuth state. */
191
+ export async function startCallback(expectedState, { timeoutMs = 300_000 } = {}) {
192
+ let resolveCode;
193
+ let rejectCode;
194
+ const code = new Promise((resolve, reject) => {
195
+ resolveCode = resolve;
196
+ rejectCode = reject;
197
+ });
198
+ // A timeout may precede the caller awaiting the promise during discovery.
199
+ code.catch(() => { });
200
+ const server = createServer((request, response) => {
201
+ response.setHeader('Cache-Control', 'no-store');
202
+ response.setHeader('Content-Type', 'text/plain; charset=utf-8');
203
+ let url;
204
+ // Request targets must not become URL authorities or escape this event handler as parse errors.
205
+ const target = request.url ?? '';
206
+ if (/^\/(?![\\/])/.test(target)) {
207
+ try {
208
+ url = new URL(target, 'http://127.0.0.1');
209
+ }
210
+ catch {
211
+ /* reject below */
212
+ }
213
+ }
214
+ if (!url || request.method !== 'GET' || url.pathname !== '/callback' || url.searchParams.get('state') !== expectedState) {
215
+ response.writeHead(400);
216
+ response.end('Invalid OAuth callback.');
217
+ return;
218
+ }
219
+ if (url.searchParams.has('error')) {
220
+ response.writeHead(400);
221
+ response.end('Authorization was declined. Return to the e-Comet panel in the app.');
222
+ rejectCode(Object.assign(new Error('e-Comet authorization was declined.'), { errorCode: 'authorization-declined' }));
223
+ clearTimeout(timer);
224
+ server.close();
225
+ return;
226
+ }
227
+ const authorizationCode = url.searchParams.get('code');
228
+ if (!authorizationCode) {
229
+ response.writeHead(400);
230
+ response.end('Missing authorization code.');
231
+ return;
232
+ }
233
+ response.end('Authorization received. Return to the e-Comet panel in the app.');
234
+ resolveCode(authorizationCode);
235
+ clearTimeout(timer);
236
+ server.close();
237
+ });
238
+ await new Promise((resolve, reject) => {
239
+ server.once('error', reject);
240
+ server.listen(0, '127.0.0.1', resolve);
241
+ });
242
+ // The handler cannot run before this line: a request arrives only after the listen continuation.
243
+ const timer = setTimeout(() => {
244
+ rejectCode(Object.assign(new Error('OAuth login timed out.'), { errorCode: 'connection-timeout' }));
245
+ server.close();
246
+ }, timeoutMs);
247
+ // A listening TCP server has its address.
248
+ const address = server.address();
249
+ if (address === null || typeof address === 'string')
250
+ throw new Error('The OAuth callback listener has no address.');
251
+ return {
252
+ url: `http://127.0.0.1:${address.port}/callback`,
253
+ code,
254
+ close() {
255
+ clearTimeout(timer);
256
+ rejectCode(new Error('OAuth login cancelled.'));
257
+ server.close();
258
+ },
259
+ };
260
+ }
@@ -0,0 +1,42 @@
1
+ import { UnauthorizedError } from '@modelcontextprotocol/sdk/client/auth.js';
2
+ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
3
+ import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
4
+ import { InvalidGrantError } from '@modelcontextprotocol/sdk/server/auth/errors.js';
5
+ import { CLIENT_NAME, FileOAuthProvider, REMOTE_URL, createTrustedFetch, LoginRequiredError } from './oauth.mjs';
6
+ export const isLoginRequired = (error) => error instanceof LoginRequiredError || error instanceof UnauthorizedError || error instanceof InvalidGrantError;
7
+ // `version` is the package version the root read.
8
+ const isTransport = (value) => ['start', 'send', 'close'].every((method) => typeof Reflect.get(value, method) === 'function');
9
+ export async function connectRemoteClient({ provider = new FileOAuthProvider(), version = '0.0.0-development', fetchImpl = createTrustedFetch(fetch, `${CLIENT_NAME}/${version}`), } = {}) {
10
+ if (!(await provider.tokens())?.access_token)
11
+ throw new LoginRequiredError();
12
+ const unlink = new AbortController();
13
+ // Transport close does not cancel the SDK's detached OAuth flow. Explicit unlink and
14
+ // abandoned bootstrap stop it; an ordinary close retains a finishing refresh.
15
+ const client = Object.assign(new Client({ name: CLIENT_NAME, version }, { capabilities: {} }), {
16
+ forgetLogin: async () => {
17
+ const stopped = provider.stopSaving?.();
18
+ unlink.abort();
19
+ await stopped;
20
+ },
21
+ });
22
+ const transport = new StreamableHTTPClientTransport(new URL(REMOTE_URL), {
23
+ authProvider: provider,
24
+ fetch: (input, init = {}) => fetchImpl(input, { ...init, signal: init.signal ? AbortSignal.any([init.signal, unlink.signal]) : unlink.signal }),
25
+ });
26
+ // The SDK's transport declares `sessionId` as possibly undefined, which its Transport type, read with
27
+ // exactOptionalPropertyTypes, does not admit; the check proves the methods the client calls.
28
+ if (!isTransport(transport))
29
+ throw new TypeError('The MCP transport is incomplete.');
30
+ try {
31
+ await client.connect(transport);
32
+ return client;
33
+ }
34
+ catch (error) {
35
+ // Runtime never receives this client, so it cannot fence a later OAuth save on unlink.
36
+ await client.forgetLogin();
37
+ await client.close().catch(() => { });
38
+ if (isLoginRequired(error))
39
+ throw new LoginRequiredError();
40
+ throw error;
41
+ }
42
+ }