@lightsage/mcp 0.4.17 → 0.4.19

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 (345) hide show
  1. package/README.md +2 -2
  2. package/api/mcp.js +4 -1
  3. package/bin/mcp-server.js +1115 -205
  4. package/bin/mcp-server.js.map +82 -56
  5. package/esm/funcs/agentAnalyticsCountriesList.js +1 -0
  6. package/esm/funcs/agentAnalyticsCountriesList.js.map +1 -1
  7. package/esm/funcs/agentAnalyticsErrorPagesList.js +1 -0
  8. package/esm/funcs/agentAnalyticsErrorPagesList.js.map +1 -1
  9. package/esm/funcs/agentAnalyticsPagesList.js +1 -0
  10. package/esm/funcs/agentAnalyticsPagesList.js.map +1 -1
  11. package/esm/funcs/agentAnalyticsSourcesList.js +1 -0
  12. package/esm/funcs/agentAnalyticsSourcesList.js.map +1 -1
  13. package/esm/funcs/agentAnalyticsSummaryRetrieve.d.ts +1 -1
  14. package/esm/funcs/agentAnalyticsSummaryRetrieve.js +2 -1
  15. package/esm/funcs/agentAnalyticsSummaryRetrieve.js.map +1 -1
  16. package/esm/funcs/agentsList.d.ts +1 -1
  17. package/esm/funcs/agentsList.js +1 -1
  18. package/esm/funcs/evalsCreate.d.ts +2 -0
  19. package/esm/funcs/evalsCreate.d.ts.map +1 -1
  20. package/esm/funcs/evalsCreate.js +2 -0
  21. package/esm/funcs/evalsCreate.js.map +1 -1
  22. package/esm/funcs/evalsRun.d.ts +2 -0
  23. package/esm/funcs/evalsRun.d.ts.map +1 -1
  24. package/esm/funcs/evalsRun.js +2 -0
  25. package/esm/funcs/evalsRun.js.map +1 -1
  26. package/esm/funcs/promptsRun.d.ts +8 -3
  27. package/esm/funcs/promptsRun.d.ts.map +1 -1
  28. package/esm/funcs/promptsRun.js +8 -3
  29. package/esm/funcs/promptsRun.js.map +1 -1
  30. package/esm/funcs/promptsRunCancel.d.ts +16 -0
  31. package/esm/funcs/promptsRunCancel.d.ts.map +1 -0
  32. package/esm/funcs/promptsRunCancel.js +88 -0
  33. package/esm/funcs/promptsRunCancel.js.map +1 -0
  34. package/esm/funcs/promptsTargetsList.d.ts +16 -0
  35. package/esm/funcs/promptsTargetsList.d.ts.map +1 -0
  36. package/esm/funcs/promptsTargetsList.js +86 -0
  37. package/esm/funcs/promptsTargetsList.js.map +1 -0
  38. package/esm/funcs/promptsTargetsSet.d.ts +16 -0
  39. package/esm/funcs/promptsTargetsSet.d.ts.map +1 -0
  40. package/esm/funcs/promptsTargetsSet.js +83 -0
  41. package/esm/funcs/promptsTargetsSet.js.map +1 -0
  42. package/esm/funcs/visibilityCitationsList.d.ts +1 -1
  43. package/esm/funcs/visibilityCitationsList.js +2 -1
  44. package/esm/funcs/visibilityCitationsList.js.map +1 -1
  45. package/esm/funcs/visibilityCitationsSummaryRetrieve.d.ts +16 -0
  46. package/esm/funcs/visibilityCitationsSummaryRetrieve.d.ts.map +1 -0
  47. package/esm/funcs/visibilityCitationsSummaryRetrieve.js +93 -0
  48. package/esm/funcs/visibilityCitationsSummaryRetrieve.js.map +1 -0
  49. package/esm/funcs/visibilityCurrentRetrieve.d.ts +1 -1
  50. package/esm/funcs/visibilityCurrentRetrieve.js +2 -1
  51. package/esm/funcs/visibilityCurrentRetrieve.js.map +1 -1
  52. package/esm/funcs/visibilityOverviewRetrieve.d.ts +1 -1
  53. package/esm/funcs/visibilityOverviewRetrieve.js +2 -1
  54. package/esm/funcs/visibilityOverviewRetrieve.js.map +1 -1
  55. package/esm/funcs/visibilityPromptsRetrieve.js +1 -0
  56. package/esm/funcs/visibilityPromptsRetrieve.js.map +1 -1
  57. package/esm/landing-page.js +1 -1
  58. package/esm/lib/config.d.ts +2 -2
  59. package/esm/lib/config.js +2 -2
  60. package/esm/mcp-server/mcp-server.js +1 -1
  61. package/esm/mcp-server/server.d.ts.map +1 -1
  62. package/esm/mcp-server/server.js +9 -1
  63. package/esm/mcp-server/server.js.map +1 -1
  64. package/esm/mcp-server/tools/agentAnalyticsSummaryRetrieve.js +1 -1
  65. package/esm/mcp-server/tools/agentAnalyticsSummaryRetrieve.js.map +1 -1
  66. package/esm/mcp-server/tools/agentsList.js +1 -1
  67. package/esm/mcp-server/tools/agentsList.js.map +1 -1
  68. package/esm/mcp-server/tools/evalsCreate.d.ts.map +1 -1
  69. package/esm/mcp-server/tools/evalsCreate.js +3 -1
  70. package/esm/mcp-server/tools/evalsCreate.js.map +1 -1
  71. package/esm/mcp-server/tools/evalsRun.d.ts.map +1 -1
  72. package/esm/mcp-server/tools/evalsRun.js +2 -0
  73. package/esm/mcp-server/tools/evalsRun.js.map +1 -1
  74. package/esm/mcp-server/tools/promptsRun.d.ts.map +1 -1
  75. package/esm/mcp-server/tools/promptsRun.js +8 -3
  76. package/esm/mcp-server/tools/promptsRun.js.map +1 -1
  77. package/esm/mcp-server/tools/promptsRunCancel.d.ts +7 -0
  78. package/esm/mcp-server/tools/promptsRunCancel.d.ts.map +1 -0
  79. package/esm/mcp-server/tools/promptsRunCancel.js +35 -0
  80. package/esm/mcp-server/tools/promptsRunCancel.js.map +1 -0
  81. package/esm/mcp-server/tools/promptsTargetsList.d.ts +7 -0
  82. package/esm/mcp-server/tools/promptsTargetsList.d.ts.map +1 -0
  83. package/esm/mcp-server/tools/promptsTargetsList.js +35 -0
  84. package/esm/mcp-server/tools/promptsTargetsList.js.map +1 -0
  85. package/esm/mcp-server/tools/promptsTargetsSet.d.ts +7 -0
  86. package/esm/mcp-server/tools/promptsTargetsSet.d.ts.map +1 -0
  87. package/esm/mcp-server/tools/promptsTargetsSet.js +35 -0
  88. package/esm/mcp-server/tools/promptsTargetsSet.js.map +1 -0
  89. package/esm/mcp-server/tools/visibilityCitationsList.js +1 -1
  90. package/esm/mcp-server/tools/visibilityCitationsList.js.map +1 -1
  91. package/esm/mcp-server/tools/visibilityCitationsSummaryRetrieve.d.ts +7 -0
  92. package/esm/mcp-server/tools/visibilityCitationsSummaryRetrieve.d.ts.map +1 -0
  93. package/esm/mcp-server/tools/visibilityCitationsSummaryRetrieve.js +35 -0
  94. package/esm/mcp-server/tools/visibilityCitationsSummaryRetrieve.js.map +1 -0
  95. package/esm/mcp-server/tools/visibilityCurrentRetrieve.js +1 -1
  96. package/esm/mcp-server/tools/visibilityCurrentRetrieve.js.map +1 -1
  97. package/esm/mcp-server/tools/visibilityOverviewRetrieve.js +1 -1
  98. package/esm/mcp-server/tools/visibilityOverviewRetrieve.js.map +1 -1
  99. package/esm/models/createv2promptrequest.js +1 -1
  100. package/esm/models/createv2promptrequest.js.map +1 -1
  101. package/esm/models/createv2promptrunrequest.d.ts +1 -0
  102. package/esm/models/createv2promptrunrequest.d.ts.map +1 -1
  103. package/esm/models/createv2promptrunrequest.js +2 -1
  104. package/esm/models/createv2promptrunrequest.js.map +1 -1
  105. package/esm/models/evaltemplateschedule.d.ts +4 -4
  106. package/esm/models/evaltemplateschedule.d.ts.map +1 -1
  107. package/esm/models/evaltemplateschedule.js +4 -3
  108. package/esm/models/evaltemplateschedule.js.map +1 -1
  109. package/esm/models/publicagentanalyticscountrylistresponse.d.ts +2 -0
  110. package/esm/models/publicagentanalyticscountrylistresponse.d.ts.map +1 -1
  111. package/esm/models/publicagentanalyticscountrylistresponse.js +2 -0
  112. package/esm/models/publicagentanalyticscountrylistresponse.js.map +1 -1
  113. package/esm/models/publicagentanalyticserrorpagelistresponse.d.ts +2 -0
  114. package/esm/models/publicagentanalyticserrorpagelistresponse.d.ts.map +1 -1
  115. package/esm/models/publicagentanalyticserrorpagelistresponse.js +2 -0
  116. package/esm/models/publicagentanalyticserrorpagelistresponse.js.map +1 -1
  117. package/esm/models/publicagentanalyticspagelistresponse.d.ts +2 -0
  118. package/esm/models/publicagentanalyticspagelistresponse.d.ts.map +1 -1
  119. package/esm/models/publicagentanalyticspagelistresponse.js +2 -0
  120. package/esm/models/publicagentanalyticspagelistresponse.js.map +1 -1
  121. package/esm/models/publicagentanalyticssourcelistresponse.d.ts +2 -0
  122. package/esm/models/publicagentanalyticssourcelistresponse.d.ts.map +1 -1
  123. package/esm/models/publicagentanalyticssourcelistresponse.js +2 -0
  124. package/esm/models/publicagentanalyticssourcelistresponse.js.map +1 -1
  125. package/esm/models/publicagentanalyticssummary.d.ts +2 -0
  126. package/esm/models/publicagentanalyticssummary.d.ts.map +1 -1
  127. package/esm/models/publicagentanalyticssummary.js +2 -0
  128. package/esm/models/publicagentanalyticssummary.js.map +1 -1
  129. package/esm/models/publiccitationsummarygroup.d.ts +17 -0
  130. package/esm/models/publiccitationsummarygroup.d.ts.map +1 -0
  131. package/esm/models/publiccitationsummarygroup.js +20 -0
  132. package/esm/models/publiccitationsummarygroup.js.map +1 -0
  133. package/esm/models/publiccitationsummaryresponse.d.ts +61 -0
  134. package/esm/models/publiccitationsummaryresponse.d.ts.map +1 -0
  135. package/esm/models/publiccitationsummaryresponse.js +58 -0
  136. package/esm/models/publiccitationsummaryresponse.js.map +1 -0
  137. package/esm/models/publiccitationsummarytotals.d.ts +14 -0
  138. package/esm/models/publiccitationsummarytotals.d.ts.map +1 -0
  139. package/esm/models/publiccitationsummarytotals.js +17 -0
  140. package/esm/models/publiccitationsummarytotals.js.map +1 -0
  141. package/esm/models/publiccoverage.d.ts +12 -0
  142. package/esm/models/publiccoverage.d.ts.map +1 -0
  143. package/esm/models/publiccoverage.js +15 -0
  144. package/esm/models/publiccoverage.js.map +1 -0
  145. package/esm/models/publiccoverageday.d.ts +41 -0
  146. package/esm/models/publiccoverageday.d.ts.map +1 -0
  147. package/esm/models/publiccoverageday.js +39 -0
  148. package/esm/models/publiccoverageday.js.map +1 -0
  149. package/esm/models/publiccurrentvisibilityresponse.d.ts +8 -0
  150. package/esm/models/publiccurrentvisibilityresponse.d.ts.map +1 -1
  151. package/esm/models/publiccurrentvisibilityresponse.js +8 -0
  152. package/esm/models/publiccurrentvisibilityresponse.js.map +1 -1
  153. package/esm/models/publicperiodcoverage.d.ts +13 -0
  154. package/esm/models/publicperiodcoverage.d.ts.map +1 -0
  155. package/esm/models/publicperiodcoverage.js +17 -0
  156. package/esm/models/publicperiodcoverage.js.map +1 -0
  157. package/esm/models/publicperiodrates.d.ts +10 -0
  158. package/esm/models/publicperiodrates.d.ts.map +1 -0
  159. package/esm/models/publicperiodrates.js +14 -0
  160. package/esm/models/publicperiodrates.js.map +1 -0
  161. package/esm/models/publicpreviousvisibility.d.ts +10 -0
  162. package/esm/models/publicpreviousvisibility.d.ts.map +1 -0
  163. package/esm/models/publicpreviousvisibility.js +13 -0
  164. package/esm/models/publicpreviousvisibility.js.map +1 -0
  165. package/esm/models/publicpromptvisibilityreportresponse.d.ts +6 -0
  166. package/esm/models/publicpromptvisibilityreportresponse.d.ts.map +1 -1
  167. package/esm/models/publicpromptvisibilityreportresponse.js +6 -0
  168. package/esm/models/publicpromptvisibilityreportresponse.js.map +1 -1
  169. package/esm/models/publicratechanges.d.ts +8 -0
  170. package/esm/models/publicratechanges.d.ts.map +1 -0
  171. package/esm/models/publicratechanges.js +12 -0
  172. package/esm/models/publicratechanges.js.map +1 -0
  173. package/esm/models/publicrates.d.ts +27 -0
  174. package/esm/models/publicrates.d.ts.map +1 -0
  175. package/esm/models/publicrates.js +25 -0
  176. package/esm/models/publicrates.js.map +1 -0
  177. package/esm/models/publicresolvedperiod.d.ts +14 -0
  178. package/esm/models/publicresolvedperiod.d.ts.map +1 -0
  179. package/esm/models/publicresolvedperiod.js +18 -0
  180. package/esm/models/publicresolvedperiod.js.map +1 -0
  181. package/esm/models/publictopcitedurlsresponse.d.ts +10 -4
  182. package/esm/models/publictopcitedurlsresponse.d.ts.map +1 -1
  183. package/esm/models/publictopcitedurlsresponse.js +9 -3
  184. package/esm/models/publictopcitedurlsresponse.js.map +1 -1
  185. package/esm/models/publicvisibilityoverviewresponse.d.ts +6 -0
  186. package/esm/models/publicvisibilityoverviewresponse.d.ts.map +1 -1
  187. package/esm/models/publicvisibilityoverviewresponse.js +6 -0
  188. package/esm/models/publicvisibilityoverviewresponse.js.map +1 -1
  189. package/esm/models/setv2prompttargetsrequest.d.ts +8 -0
  190. package/esm/models/setv2prompttargetsrequest.d.ts.map +1 -0
  191. package/esm/models/setv2prompttargetsrequest.js +11 -0
  192. package/esm/models/setv2prompttargetsrequest.js.map +1 -0
  193. package/esm/models/setv2prompttargetsresponse.d.ts +9 -0
  194. package/esm/models/setv2prompttargetsresponse.d.ts.map +1 -0
  195. package/esm/models/setv2prompttargetsresponse.js +12 -0
  196. package/esm/models/setv2prompttargetsresponse.js.map +1 -0
  197. package/esm/models/updatev2promptrequest.js +1 -1
  198. package/esm/models/updatev2promptrequest.js.map +1 -1
  199. package/esm/models/v2agentanalyticscountrieslistop.d.ts +1 -0
  200. package/esm/models/v2agentanalyticscountrieslistop.d.ts.map +1 -1
  201. package/esm/models/v2agentanalyticscountrieslistop.js +1 -0
  202. package/esm/models/v2agentanalyticscountrieslistop.js.map +1 -1
  203. package/esm/models/v2agentanalyticserrorpageslistop.d.ts +1 -0
  204. package/esm/models/v2agentanalyticserrorpageslistop.d.ts.map +1 -1
  205. package/esm/models/v2agentanalyticserrorpageslistop.js +1 -0
  206. package/esm/models/v2agentanalyticserrorpageslistop.js.map +1 -1
  207. package/esm/models/v2agentanalyticspageslistop.d.ts +1 -0
  208. package/esm/models/v2agentanalyticspageslistop.d.ts.map +1 -1
  209. package/esm/models/v2agentanalyticspageslistop.js +1 -0
  210. package/esm/models/v2agentanalyticspageslistop.js.map +1 -1
  211. package/esm/models/v2agentanalyticssourceslistop.d.ts +1 -0
  212. package/esm/models/v2agentanalyticssourceslistop.d.ts.map +1 -1
  213. package/esm/models/v2agentanalyticssourceslistop.js +1 -0
  214. package/esm/models/v2agentanalyticssourceslistop.js.map +1 -1
  215. package/esm/models/v2agentanalyticssummaryretrieveop.d.ts +1 -0
  216. package/esm/models/v2agentanalyticssummaryretrieveop.d.ts.map +1 -1
  217. package/esm/models/v2agentanalyticssummaryretrieveop.js +1 -0
  218. package/esm/models/v2agentanalyticssummaryretrieveop.js.map +1 -1
  219. package/esm/models/v2promptrunscancelop.d.ts +38 -0
  220. package/esm/models/v2promptrunscancelop.d.ts.map +1 -0
  221. package/esm/models/v2promptrunscancelop.js +31 -0
  222. package/esm/models/v2promptrunscancelop.js.map +1 -0
  223. package/esm/models/v2prompttarget.d.ts +44 -0
  224. package/esm/models/v2prompttarget.d.ts.map +1 -0
  225. package/esm/models/v2prompttarget.js +41 -0
  226. package/esm/models/v2prompttarget.js.map +1 -0
  227. package/esm/models/v2prompttargetinput.d.ts +47 -0
  228. package/esm/models/v2prompttargetinput.d.ts.map +1 -0
  229. package/esm/models/v2prompttargetinput.js +45 -0
  230. package/esm/models/v2prompttargetinput.js.map +1 -0
  231. package/esm/models/v2prompttargetslistop.d.ts +10 -0
  232. package/esm/models/v2prompttargetslistop.d.ts.map +1 -0
  233. package/esm/models/v2prompttargetslistop.js +15 -0
  234. package/esm/models/v2prompttargetslistop.js.map +1 -0
  235. package/esm/models/v2prompttargetsresponse.d.ts +8 -0
  236. package/esm/models/v2prompttargetsresponse.d.ts.map +1 -0
  237. package/esm/models/v2prompttargetsresponse.js +11 -0
  238. package/esm/models/v2prompttargetsresponse.js.map +1 -0
  239. package/esm/models/v2prompttargetssetop.d.ts +6 -0
  240. package/esm/models/v2prompttargetssetop.d.ts.map +1 -0
  241. package/esm/models/v2prompttargetssetop.js +12 -0
  242. package/esm/models/v2prompttargetssetop.js.map +1 -0
  243. package/esm/models/v2visibilitycitationslistop.d.ts +1 -0
  244. package/esm/models/v2visibilitycitationslistop.d.ts.map +1 -1
  245. package/esm/models/v2visibilitycitationslistop.js +1 -0
  246. package/esm/models/v2visibilitycitationslistop.js.map +1 -1
  247. package/esm/models/v2visibilitycitationssummaryretrieveop.d.ts +54 -0
  248. package/esm/models/v2visibilitycitationssummaryretrieveop.d.ts.map +1 -0
  249. package/esm/models/v2visibilitycitationssummaryretrieveop.js +51 -0
  250. package/esm/models/v2visibilitycitationssummaryretrieveop.js.map +1 -0
  251. package/esm/models/v2visibilitycurrentretrieveop.d.ts +1 -0
  252. package/esm/models/v2visibilitycurrentretrieveop.d.ts.map +1 -1
  253. package/esm/models/v2visibilitycurrentretrieveop.js +1 -0
  254. package/esm/models/v2visibilitycurrentretrieveop.js.map +1 -1
  255. package/esm/models/v2visibilityoverviewretrieveop.d.ts +1 -0
  256. package/esm/models/v2visibilityoverviewretrieveop.d.ts.map +1 -1
  257. package/esm/models/v2visibilityoverviewretrieveop.js +1 -0
  258. package/esm/models/v2visibilityoverviewretrieveop.js.map +1 -1
  259. package/esm/models/v2visibilitypromptsretrieveop.d.ts +1 -0
  260. package/esm/models/v2visibilitypromptsretrieveop.d.ts.map +1 -1
  261. package/esm/models/v2visibilitypromptsretrieveop.js +1 -0
  262. package/esm/models/v2visibilitypromptsretrieveop.js.map +1 -1
  263. package/esm/tool-names.d.ts.map +1 -1
  264. package/esm/tool-names.js +24 -8
  265. package/esm/tool-names.js.map +1 -1
  266. package/lib/feedback.js +47 -0
  267. package/lib/tracker.js +4 -2
  268. package/package.json +5 -4
  269. package/src/funcs/agentAnalyticsCountriesList.ts +1 -0
  270. package/src/funcs/agentAnalyticsErrorPagesList.ts +1 -0
  271. package/src/funcs/agentAnalyticsPagesList.ts +1 -0
  272. package/src/funcs/agentAnalyticsSourcesList.ts +1 -0
  273. package/src/funcs/agentAnalyticsSummaryRetrieve.ts +2 -1
  274. package/src/funcs/agentsList.ts +1 -1
  275. package/src/funcs/evalsCreate.ts +2 -0
  276. package/src/funcs/evalsRun.ts +2 -0
  277. package/src/funcs/promptsRun.ts +8 -3
  278. package/src/funcs/promptsRunCancel.ts +153 -0
  279. package/src/funcs/promptsTargetsList.ts +148 -0
  280. package/src/funcs/promptsTargetsSet.ts +145 -0
  281. package/src/funcs/visibilityCitationsList.ts +2 -1
  282. package/src/funcs/visibilityCitationsSummaryRetrieve.ts +158 -0
  283. package/src/funcs/visibilityCurrentRetrieve.ts +2 -1
  284. package/src/funcs/visibilityOverviewRetrieve.ts +2 -1
  285. package/src/funcs/visibilityPromptsRetrieve.ts +1 -0
  286. package/src/landing-page.ts +1 -1
  287. package/src/lib/config.ts +2 -2
  288. package/src/mcp-server/mcp-server.ts +1 -1
  289. package/src/mcp-server/server.ts +9 -1
  290. package/src/mcp-server/tools/agentAnalyticsSummaryRetrieve.ts +1 -1
  291. package/src/mcp-server/tools/agentsList.ts +1 -1
  292. package/src/mcp-server/tools/evalsCreate.ts +3 -1
  293. package/src/mcp-server/tools/evalsRun.ts +2 -0
  294. package/src/mcp-server/tools/promptsRun.ts +8 -3
  295. package/src/mcp-server/tools/promptsRunCancel.ts +43 -0
  296. package/src/mcp-server/tools/promptsTargetsList.ts +43 -0
  297. package/src/mcp-server/tools/promptsTargetsSet.ts +43 -0
  298. package/src/mcp-server/tools/visibilityCitationsList.ts +1 -1
  299. package/src/mcp-server/tools/visibilityCitationsSummaryRetrieve.ts +45 -0
  300. package/src/mcp-server/tools/visibilityCurrentRetrieve.ts +1 -1
  301. package/src/mcp-server/tools/visibilityOverviewRetrieve.ts +1 -1
  302. package/src/models/createv2promptrequest.ts +1 -1
  303. package/src/models/createv2promptrunrequest.ts +5 -1
  304. package/src/models/evaltemplateschedule.ts +8 -7
  305. package/src/models/publicagentanalyticscountrylistresponse.ts +8 -0
  306. package/src/models/publicagentanalyticserrorpagelistresponse.ts +8 -0
  307. package/src/models/publicagentanalyticspagelistresponse.ts +8 -0
  308. package/src/models/publicagentanalyticssourcelistresponse.ts +8 -0
  309. package/src/models/publicagentanalyticssummary.ts +8 -0
  310. package/src/models/publiccitationsummarygroup.ts +54 -0
  311. package/src/models/publiccitationsummaryresponse.ts +110 -0
  312. package/src/models/publiccitationsummarytotals.ts +38 -0
  313. package/src/models/publiccoverage.ts +34 -0
  314. package/src/models/publiccoverageday.ts +68 -0
  315. package/src/models/publiccurrentvisibilityresponse.ts +26 -0
  316. package/src/models/publicperiodcoverage.ts +33 -0
  317. package/src/models/publicperiodrates.ts +29 -0
  318. package/src/models/publicpreviousvisibility.ts +30 -0
  319. package/src/models/publicpromptvisibilityreportresponse.ts +18 -0
  320. package/src/models/publicratechanges.ts +25 -0
  321. package/src/models/publicrates.ts +52 -0
  322. package/src/models/publicresolvedperiod.ts +41 -0
  323. package/src/models/publictopcitedurlsresponse.ts +25 -5
  324. package/src/models/publicvisibilityoverviewresponse.ts +18 -0
  325. package/src/models/setv2prompttargetsrequest.ts +26 -0
  326. package/src/models/setv2prompttargetsresponse.ts +23 -0
  327. package/src/models/updatev2promptrequest.ts +1 -1
  328. package/src/models/v2agentanalyticscountrieslistop.ts +4 -0
  329. package/src/models/v2agentanalyticserrorpageslistop.ts +4 -0
  330. package/src/models/v2agentanalyticspageslistop.ts +4 -0
  331. package/src/models/v2agentanalyticssourceslistop.ts +4 -0
  332. package/src/models/v2agentanalyticssummaryretrieveop.ts +4 -0
  333. package/src/models/v2promptrunscancelop.ts +90 -0
  334. package/src/models/v2prompttarget.ts +79 -0
  335. package/src/models/v2prompttargetinput.ts +72 -0
  336. package/src/models/v2prompttargetslistop.ts +33 -0
  337. package/src/models/v2prompttargetsresponse.ts +19 -0
  338. package/src/models/v2prompttargetssetop.ts +25 -0
  339. package/src/models/v2visibilitycitationslistop.ts +4 -0
  340. package/src/models/v2visibilitycitationssummaryretrieveop.ts +113 -0
  341. package/src/models/v2visibilitycurrentretrieveop.ts +4 -0
  342. package/src/models/v2visibilityoverviewretrieveop.ts +4 -0
  343. package/src/models/v2visibilitypromptsretrieveop.ts +4 -0
  344. package/src/tool-names.ts +24 -8
  345. package/test/tracker.test.js +83 -1
@@ -1 +1 @@
1
- {"version":3,"file":"v2visibilitypromptsretrieveop.d.ts","sourceRoot":"","sources":["../../src/models/v2visibilitypromptsretrieveop.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EACL,mBAAmB,EAEpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oCAAoC,EAErC,MAAM,2CAA2C,CAAC;AAEnD,MAAM,MAAM,kCAAkC,GAAG;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,4CAA4C,EAAE,CAAC,CAAC,OAAO,CAClE,kCAAkC,CAQlC,CAAC;AAEH,MAAM,MAAM,mCAAmC,GAC3C,oCAAoC,GACpC,mBAAmB,CAAC;AAExB,eAAO,MAAM,6CAA6C,EAAE,CAAC,CAAC,OAAO,CACnE,mCAAmC,CAInC,CAAC"}
1
+ {"version":3,"file":"v2visibilitypromptsretrieveop.d.ts","sourceRoot":"","sources":["../../src/models/v2visibilitypromptsretrieveop.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EACL,mBAAmB,EAEpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oCAAoC,EAErC,MAAM,2CAA2C,CAAC;AAEnD,MAAM,MAAM,kCAAkC,GAAG;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,4CAA4C,EAAE,CAAC,CAAC,OAAO,CAClE,kCAAkC,CAWlC,CAAC;AAEH,MAAM,MAAM,mCAAmC,GAC3C,oCAAoC,GACpC,mBAAmB,CAAC;AAExB,eAAO,MAAM,6CAA6C,EAAE,CAAC,CAAC,OAAO,CACnE,mCAAmC,CAInC,CAAC"}
@@ -7,6 +7,7 @@ import { HTTPValidationError$zodSchema, } from "./httpvalidationerror.js";
7
7
  import { PublicPromptVisibilityReportResponse$zodSchema, } from "./publicpromptvisibilityreportresponse.js";
8
8
  export const V2VisibilityPromptsRetrieveRequest$zodSchema = z.object({
9
9
  end_date: z.string().date().describe("Inclusive range end; defaults to today.").optional(),
10
+ period: z.string().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
10
11
  start_date: z.string().date().describe("Inclusive range start; defaults to 30 days before the end date. The range may span at most 90 days.").optional(),
11
12
  });
12
13
  export const V2VisibilityPromptsRetrieveResponse$zodSchema = z.union([
@@ -1 +1 @@
1
- {"version":3,"file":"v2visibilitypromptsretrieveop.js","sourceRoot":"","sources":["../../src/models/v2visibilitypromptsretrieveop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAEL,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,8CAA8C,GAC/C,MAAM,2CAA2C,CAAC;AAOnD,MAAM,CAAC,MAAM,4CAA4C,GAErD,CAAC,CAAC,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAClC,yCAAyC,CAC1C,CAAC,QAAQ,EAAE;IACZ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CACpC,qGAAqG,CACtG,CAAC,QAAQ,EAAE;CACb,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,6CAA6C,GAEtD,CAAC,CAAC,KAAK,CAAC;IACV,8CAA8C;IAC9C,6BAA6B;CAC9B,CAAC,CAAC"}
1
+ {"version":3,"file":"v2visibilitypromptsretrieveop.js","sourceRoot":"","sources":["../../src/models/v2visibilitypromptsretrieveop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAEL,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,8CAA8C,GAC/C,MAAM,2CAA2C,CAAC;AAQnD,MAAM,CAAC,MAAM,4CAA4C,GAErD,CAAC,CAAC,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAClC,yCAAyC,CAC1C,CAAC,QAAQ,EAAE;IACZ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACzB,ufAAuf,CACxf,CAAC,QAAQ,EAAE;IACZ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CACpC,qGAAqG,CACtG,CAAC,QAAQ,EAAE;CACb,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,6CAA6C,GAEtD,CAAC,CAAC,KAAK,CAAC;IACV,8CAA8C;IAC9C,6BAA6B;CAC9B,CAAC,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../src/tool-names.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAiSlE,CAAC"}
1
+ {"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../src/tool-names.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAiTlE,CAAC"}
package/esm/tool-names.js CHANGED
@@ -10,20 +10,24 @@ export const toolNames = [
10
10
  },
11
11
  {
12
12
  "name": "visibility-current-retrieve",
13
- "description": "Retrieve Current Visibility\n\nReturns recommendation score, visibility score, ranks, and date-range metadata for the configured primary company. Metrics are computed from active prompts only; when no data exists, values are `null`."
13
+ "description": "Retrieve Current Visibility\n\nReturns recommendation score, visibility score, ranks, and date-range metadata for the configured primary company, with the same metrics for the previous period, run coverage, and per-run rates. Metrics are computed from active prompts only; when no data exists, values are `null`. Pass `period` (for example `last_30_days` or `2026Q4`) instead of computing dates."
14
14
  },
15
15
  {
16
16
  "name": "visibility-overview-retrieve",
17
- "description": "Retrieve Visibility Overview\n\nReturns aggregate snapshot, daily trends, per-platform breakdowns, and competitor comparison. Calculated from active prompts only."
17
+ "description": "Retrieve Visibility Overview\n\nReturns aggregate snapshot, daily trends, per-platform breakdowns, and competitor comparison, with run coverage and per-run rates against the previous period. Calculated from active prompts only."
18
18
  },
19
19
  {
20
20
  "name": "visibility-citations-list",
21
- "description": "List Top Cited Urls\n\nReturns URL-level citation counts ranked from most to least cited. Results can be filtered by platform and to owned or external sources."
21
+ "description": "List Top Cited Urls\n\nReturns URL-level citation counts ranked from most to least cited. Results can be filtered by platform and to owned or external sources. For totals by URL prefix, domain, or day compared with the previous period, use the citations summary."
22
22
  },
23
23
  {
24
24
  "name": "visibility-prompts-retrieve",
25
25
  "description": "Retrieve Prompt Visibility Report\n\nReturns per-topic and per-prompt visibility metrics including recommendation score, rank, visibility score, average position, and citation counts."
26
26
  },
27
+ {
28
+ "name": "visibility-citations-summary-retrieve",
29
+ "description": "Retrieve Citation Summary\n\nReturns citation totals grouped by URL prefix (domain and first path segment, such as `example.com/blog`), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with `url_prefix`, for example `https://example.com/blog/`. Aggregated in one call; use it instead of paging the citations list."
30
+ },
27
31
  {
28
32
  "name": "prompts-list",
29
33
  "description": "List Prompts\n\nReturns active and inactive prompts by default. Set `include_archived` to include archived prompts."
@@ -48,6 +52,14 @@ export const toolNames = [
48
52
  "name": "prompts-topics-delete",
49
53
  "description": "Delete Topic\n\nArchives a prompt topic. Set `archive_prompts` to archive remaining prompts; otherwise the request fails with `400` if prompts remain."
50
54
  },
55
+ {
56
+ "name": "prompts-targets-list",
57
+ "description": "List Targets\n\nReturns the answer engines and coding agents that run the organization's prompts on schedule, with each target's topic and frequency. Provide `topic_id` to list one topic's targets."
58
+ },
59
+ {
60
+ "name": "prompts-targets-set",
61
+ "description": "Set Targets\n\nSets which answer engines and coding agents run a topic's prompts on schedule, the same way the prompt editor does. The list replaces the topic's targets: targets you leave out stop running. Every prompt in the topic is set to exactly these platforms; you can still narrow one prompt afterwards with `platform_ids`. Name coding agents with IDs from `GET /v2/agents`, and list a harness more than once to run it on several models. To pick agents for a single run without changing the schedule, pass `agent` to `POST /v2/prompts/runs` instead."
62
+ },
51
63
  {
52
64
  "name": "prompts-runs-list",
53
65
  "description": "List Prompt Runs\n\nReturns stored prompt runs with limit-and-offset pagination, without exposing raw runtime or provider configuration. Filter by prompt, platform, or date range."
@@ -70,12 +82,16 @@ export const toolNames = [
70
82
  },
71
83
  {
72
84
  "name": "prompts-run",
73
- "description": "Run Prompts\n\nQueue saved prompts using the organization's configured targets.\n\nProvide `prompt_ids` to run selected prompts, or omit them to run all active\nprompts. Saved prompt run settings apply to coding-agent targets. The\nresponse returns a run ID to poll with\n`GET /v2/prompts/runs/{run_id}/status`."
85
+ "description": "Run Prompts\n\nQueue saved prompts on answer engines and coding agents.\n\nProvide `prompt_ids` to run selected prompts, or omit them to run all active\nprompts. By default the run uses the organization's configured targets,\nlisted by `GET /v2/prompts/targets`.\nProvide `agent` with IDs from `GET /v2/agents` to run the prompts on\nspecific coding-agent harnesses and models instead, for example to compare\nhow several coding tools answer the same developer question. Results\ninclude mentions and citations. Saved prompt run settings apply to\ncoding-agent targets. The response returns a run ID to poll with\n`GET /v2/prompts/runs/{run_id}/status`."
74
86
  },
75
87
  {
76
88
  "name": "prompts-run-status",
77
89
  "description": "Get Prompt Run Status\n\nReturn status and progress for a queued prompt run.\n\nPoll this endpoint until `status` is `completed`, `failed`, or `cancelled`.\nIndividual stored results are available from `GET /v2/prompts/runs`."
78
90
  },
91
+ {
92
+ "name": "prompts-run-cancel",
93
+ "description": "Cancel a prompt run\n\nMarks an active prompt run as cancelled and prevents queued prompts from starting. Running coding-agent attempts are stopped asynchronously. Requests already sent to an answer platform cannot be recalled, so prompts already in progress may still finish and store their results, but the run stays cancelled. Prompts that never start use no usage-based credits. The response has the same shape as the status operation, with cancelled prompts counted in `progress.cancelled`. Repeating this request for an already-cancelled run is safe."
94
+ },
79
95
  {
80
96
  "name": "opportunities-list",
81
97
  "description": "List Opportunities\n\nReturns ranked opportunities computed from stored prompt visibility results. Each includes an `execution_prompt` with context for an AI agent. Default window is 30 days."
@@ -114,7 +130,7 @@ export const toolNames = [
114
130
  },
115
131
  {
116
132
  "name": "agent-analytics-summary-retrieve",
117
- "description": "Retrieve Agent Analytics Summary\n\nReturns a site's visits by traffic type (coding agents, user-requested AI fetches, AI search, AI training, other bots, and people) for the date range and for the same number of days before it."
133
+ "description": "Retrieve Agent Analytics Summary\n\nReturns a site's visits by traffic type (coding agents, user-requested AI fetches, AI search, AI training, other bots, and people) for the date range and for the previous period (the same number of days before it, or the previous calendar week, month, or quarter for a named `period`)."
118
134
  },
119
135
  {
120
136
  "name": "agent-analytics-sources-list",
@@ -138,7 +154,7 @@ export const toolNames = [
138
154
  },
139
155
  {
140
156
  "name": "evals-create",
141
- "description": "Create Eval\n\nCreates a reusable simulation definition with one or more task prompts and judges. Optional agents, persona, CLI installations, MCP servers, setup commands, cleanup commands, grounding policy, repeat count, and tags are saved with the eval. `search_grounding` supports `disabled`, `enabled`, and `default`; `default` preserves normal platform behavior. Creating the eval does not start a run and does not accept secret environment values."
157
+ "description": "Create Eval\n\nCreates a reusable simulation definition with one or more task prompts and judges. Optional agents, persona, CLI installations, MCP servers, setup commands, cleanup commands, grounding policy, repeat count, and tags are saved with the eval. `search_grounding` supports `disabled`, `enabled`, and `default`; `default` preserves normal platform behavior. Creating the eval does not start a run and does not accept secret environment values.\n\nEvals measure how well agents complete tasks with your product. To track how agents and answer engines answer research questions, including which brands they mention and cite, run prompts with `POST /v2/prompts/runs` instead."
142
158
  },
143
159
  {
144
160
  "name": "evals-batch-create",
@@ -178,7 +194,7 @@ export const toolNames = [
178
194
  },
179
195
  {
180
196
  "name": "evals-run",
181
- "description": "Start an eval run\n\nQueues a durable eval job and returns immediately with a polling ID. Poll `GET /v2/eval-runs/{run_id}` until its status reaches a terminal value; once finished it also returns the results and analysis. Follow a run live with the monitor operation.\n\nSend one of these flat request forms:\n\n- **Saved eval:** provide `eval_id`; optionally replace its prompts, persona, agents, CLIs, MCPs, setup commands, cleanup commands, or runs for this launch. A saved configuration can still provide repository, environment, skills, and legacy tool selections.\n- **Direct create-and-run:** provide `prompts`, `judges`, and `agent`. You may also provide a persona, tags, repository, write-only environment variables, saved or inline CLIs and MCP servers, skills, setup commands, and cleanup commands.\n\nThe run fans out across prompts × agents × runs. Persona is shared metadata and does not multiply attempts. No separate `mode` field is required. If the organization lacks the estimated credits, the request fails with `402` before dispatching work.\n\nA saved or inline environment containing an empty or placeholder credential is rejected with `400` before any evaluation is dispatched."
197
+ "description": "Start an eval run\n\nQueues a durable eval job and returns immediately with a polling ID. Poll `GET /v2/eval-runs/{run_id}` until its status reaches a terminal value; once finished it also returns the results and analysis. Follow a run live with the monitor operation.\n\nEval runs measure how well agents complete tasks with your product. To compare how coding agents and answer engines answer the same research question, with mentions and citations, use `POST /v2/prompts/runs` with `agent` instead.\n\nSend one of these flat request forms:\n\n- **Saved eval:** provide `eval_id`; optionally replace its prompts, persona, agents, CLIs, MCPs, setup commands, cleanup commands, or runs for this launch. A saved configuration can still provide repository, environment, skills, and legacy tool selections.\n- **Direct create-and-run:** provide `prompts`, `judges`, and `agent`. You may also provide a persona, tags, repository, write-only environment variables, saved or inline CLIs and MCP servers, skills, setup commands, and cleanup commands.\n\nThe run fans out across prompts × agents × runs. Persona is shared metadata and does not multiply attempts. No separate `mode` field is required. If the organization lacks the estimated credits, the request fails with `402` before dispatching work.\n\nA saved or inline environment containing an empty or placeholder credential is rejected with `400` before any evaluation is dispatched."
182
198
  },
183
199
  {
184
200
  "name": "evals-cancel",
@@ -250,7 +266,7 @@ export const toolNames = [
250
266
  },
251
267
  {
252
268
  "name": "agents-list",
253
- "description": "List Agents\n\nReturns the harness-and-model combinations your plan can run, as single agent IDs for use in eval runs."
269
+ "description": "List Agents\n\nReturns the coding-agent harness-and-model combinations your plan can run, as single agent IDs. Pass them as `agent` to `POST /v2/prompts/runs` to see how coding agents answer your prompts, with mentions and citations, or to `PUT /v2/prompts/targets` to run them on a schedule; to `POST /v2/agent-preference/evals` to see whether agents recommend your company over one competitor; or to `POST /v2/evals` and `POST /v2/eval-runs` to measure how well agents complete tasks with your product."
254
270
  },
255
271
  {
256
272
  "name": "repositories-list",
@@ -1 +1 @@
1
- {"version":3,"file":"tool-names.js","sourceRoot":"","sources":["../src/tool-names.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tool-names.js","sourceRoot":"","sources":["../src/tool-names.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,47 @@
1
+ // Feedback tool: lets an agent pass the user's feedback to the Lightsage team.
2
+ //
3
+ // The tool sends nothing itself. Its input is the feedback, and MCP Analytics
4
+ // records every call's input (lib/tracker.js), so the team reads it in MCP
5
+ // Analytics > Feedback. It is therefore only registered on requests that are
6
+ // recorded; elsewhere the feedback would be lost while the agent reports it
7
+ // as sent.
8
+ //
9
+ // Modelled on the Neon MCP server's send_feedback tool.
10
+ //
11
+ // Hand-written (not Speakeasy-generated) so regeneration does not remove it.
12
+
13
+ import { z } from "zod";
14
+
15
+ export const FEEDBACK_TOOL_NAME = "send_feedback";
16
+
17
+ // MCP Analytics cuts longer strings, so reject them instead.
18
+ export const MAX_FEEDBACK_LENGTH = 10_000;
19
+
20
+ const feedbackInputSchema = z.strictObject({
21
+ feedback: z.string().trim().min(1).max(MAX_FEEDBACK_LENGTH).describe(
22
+ "The feedback to send to Lightsage. Do not include passwords, API keys, or other secrets.",
23
+ ),
24
+ });
25
+
26
+ /** Register the feedback tool on a server whose calls MCP Analytics records. */
27
+ export function registerFeedbackTool(mcpServer) {
28
+ mcpServer.registerTool(
29
+ FEEDBACK_TOOL_NAME,
30
+ {
31
+ title: "Send Feedback",
32
+ description:
33
+ "Send feedback about Lightsage or this MCP server to the Lightsage team. Only call this when the user asks to give feedback. Sends only the feedback text, with no Lightsage data or credentials.",
34
+ inputSchema: feedbackInputSchema,
35
+ annotations: {
36
+ title: "Send Feedback",
37
+ readOnlyHint: false,
38
+ destructiveHint: false,
39
+ idempotentHint: false,
40
+ openWorldHint: true,
41
+ },
42
+ },
43
+ async () => ({
44
+ content: [{ type: "text", text: "Feedback received. Thank you!" }],
45
+ }),
46
+ );
47
+ }
package/lib/tracker.js CHANGED
@@ -11,6 +11,7 @@ import { createHash } from "node:crypto";
11
11
  import { finished } from "node:stream/promises";
12
12
  import { Lightsage } from "@lightsage/mcp-tracker";
13
13
  import { waitUntil } from "@vercel/functions";
14
+ import { FEEDBACK_TOOL_NAME } from "./feedback.js";
14
15
 
15
16
  const apiKey = process.env.LIGHTSAGE_MCP_TRACKER_API_KEY?.trim();
16
17
 
@@ -86,10 +87,11 @@ const CATALOG_TOOLS = new Set(["list_tools", "describe_tool_input"]);
86
87
  * Tool results hold callers' own Lightsage data, so keep only failures, which
87
88
  * are needed to debug errors. Catalog tools return tool names and schemas, not
88
89
  * data, and their results are how MCP Analytics spots a search that found
89
- * nothing.
90
+ * nothing. The feedback tool returns only a confirmation.
90
91
  */
91
92
  export function shouldStoreResponse({ toolName, isError }) {
92
- return isError || CATALOG_TOOLS.has(toolName);
93
+ return isError || CATALOG_TOOLS.has(toolName) ||
94
+ toolName === FEEDBACK_TOOL_NAME;
93
95
  }
94
96
 
95
97
  // One tracker per process; each request's server is instrumented separately.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lightsage/mcp",
3
- "version": "0.4.17",
3
+ "version": "0.4.19",
4
4
  "author": "Speakeasy",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -28,7 +28,7 @@
28
28
  "@stricli/core": "^1.1.2",
29
29
  "@vercel/functions": "3.9.11",
30
30
  "express": "^5.1.0",
31
- "zod": "^4.0.0"
31
+ "zod": "^4.6.6"
32
32
  },
33
33
  "overrides": {
34
34
  "@modelcontextprotocol/sdk": "1.32.1",
@@ -38,12 +38,13 @@
38
38
  "ip-address": ">=10.7.1 <11.0.0",
39
39
  "nanoid@^5.0.0": ">=5.1.16 <6.0.0",
40
40
  "brace-expansion@^2.0.0": ">=2.1.4 <3.0.0",
41
- "body-parser": ">=2.3.0 <3.0.0",
41
+ "body-parser": ">=2.4.0 <3.0.0",
42
42
  "@hono/node-server": ">=1.19.15 <2.0.0",
43
43
  "brace-expansion@^1.1.7": ">=1.1.18 <2.0.0",
44
44
  "brace-expansion@^5.0.0": ">=5.0.9 <6.0.0",
45
45
  "proxy-addr": ">=2.0.8 <3.0.0",
46
- "qs": ">=6.16.0 <7.0.0",
46
+ "qs": ">=6.16.1 <7.0.0",
47
+ "zod": "$zod",
47
48
  "tmp": ">=0.2.6 <0.3.0",
48
49
  "node-forge": "$node-forge"
49
50
  },
@@ -97,6 +97,7 @@ async function $do(
97
97
  const query$ = encodeFormQuery({
98
98
  "end_date": payload$.end_date,
99
99
  "limit": payload$.limit,
100
+ "period": payload$.period,
100
101
  "start_date": payload$.start_date,
101
102
  });
102
103
 
@@ -97,6 +97,7 @@ async function $do(
97
97
  const query$ = encodeFormQuery({
98
98
  "end_date": payload$.end_date,
99
99
  "limit": payload$.limit,
100
+ "period": payload$.period,
100
101
  "start_date": payload$.start_date,
101
102
  "status": payload$.status,
102
103
  "type": payload$.type,
@@ -98,6 +98,7 @@ async function $do(
98
98
  "agent": payload$.agent,
99
99
  "end_date": payload$.end_date,
100
100
  "limit": payload$.limit,
101
+ "period": payload$.period,
101
102
  "search": payload$.search,
102
103
  "sort": payload$.sort,
103
104
  "start_date": payload$.start_date,
@@ -96,6 +96,7 @@ async function $do(
96
96
  );
97
97
  const query$ = encodeFormQuery({
98
98
  "end_date": payload$.end_date,
99
+ "period": payload$.period,
99
100
  "start_date": payload$.start_date,
100
101
  });
101
102
 
@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
30
30
  * Retrieve Agent Analytics Summary
31
31
  *
32
32
  * @remarks
33
- * Returns a site's visits by traffic type (coding agents, user-requested AI fetches, AI search, AI training, other bots, and people) for the date range and for the same number of days before it.
33
+ * Returns a site's visits by traffic type (coding agents, user-requested AI fetches, AI search, AI training, other bots, and people) for the date range and for the previous period (the same number of days before it, or the previous calendar week, month, or quarter for a named `period`).
34
34
  */
35
35
  export function agentAnalyticsSummaryRetrieve(
36
36
  client$: LightsageMcpCore,
@@ -96,6 +96,7 @@ async function $do(
96
96
  );
97
97
  const query$ = encodeFormQuery({
98
98
  "end_date": payload$.end_date,
99
+ "period": payload$.period,
99
100
  "start_date": payload$.start_date,
100
101
  });
101
102
 
@@ -24,7 +24,7 @@ import { Result } from "../types/fp.js";
24
24
  * List Agents
25
25
  *
26
26
  * @remarks
27
- * Returns the harness-and-model combinations your plan can run, as single agent IDs for use in eval runs.
27
+ * Returns the coding-agent harness-and-model combinations your plan can run, as single agent IDs. Pass them as `agent` to `POST /v2/prompts/runs` to see how coding agents answer your prompts, with mentions and citations, or to `PUT /v2/prompts/targets` to run them on a schedule; to `POST /v2/agent-preference/evals` to see whether agents recommend your company over one competitor; or to `POST /v2/evals` and `POST /v2/eval-runs` to measure how well agents complete tasks with your product.
28
28
  */
29
29
  export function agentsList(
30
30
  client$: LightsageMcpCore,
@@ -31,6 +31,8 @@ import { Result } from "../types/fp.js";
31
31
  *
32
32
  * @remarks
33
33
  * Creates a reusable simulation definition with one or more task prompts and judges. Optional agents, persona, CLI installations, MCP servers, setup commands, cleanup commands, grounding policy, repeat count, and tags are saved with the eval. `search_grounding` supports `disabled`, `enabled`, and `default`; `default` preserves normal platform behavior. Creating the eval does not start a run and does not accept secret environment values.
34
+ *
35
+ * Evals measure how well agents complete tasks with your product. To track how agents and answer engines answer research questions, including which brands they mention and cite, run prompts with `POST /v2/prompts/runs` instead.
34
36
  */
35
37
  export function evalsCreate(
36
38
  client$: LightsageMcpCore,
@@ -32,6 +32,8 @@ import { Result } from "../types/fp.js";
32
32
  * @remarks
33
33
  * Queues a durable eval job and returns immediately with a polling ID. Poll `GET /v2/eval-runs/{run_id}` until its status reaches a terminal value; once finished it also returns the results and analysis. Follow a run live with the monitor operation.
34
34
  *
35
+ * Eval runs measure how well agents complete tasks with your product. To compare how coding agents and answer engines answer the same research question, with mentions and citations, use `POST /v2/prompts/runs` with `agent` instead.
36
+ *
35
37
  * Send one of these flat request forms:
36
38
  *
37
39
  * - **Saved eval:** provide `eval_id`; optionally replace its prompts, persona, agents, CLIs, MCPs, setup commands, cleanup commands, or runs for this launch. A saved configuration can still provide repository, environment, skills, and legacy tool selections.
@@ -30,11 +30,16 @@ import { Result } from "../types/fp.js";
30
30
  * Run Prompts
31
31
  *
32
32
  * @remarks
33
- * Queue saved prompts using the organization's configured targets.
33
+ * Queue saved prompts on answer engines and coding agents.
34
34
  *
35
35
  * Provide `prompt_ids` to run selected prompts, or omit them to run all active
36
- * prompts. Saved prompt run settings apply to coding-agent targets. The
37
- * response returns a run ID to poll with
36
+ * prompts. By default the run uses the organization's configured targets,
37
+ * listed by `GET /v2/prompts/targets`.
38
+ * Provide `agent` with IDs from `GET /v2/agents` to run the prompts on
39
+ * specific coding-agent harnesses and models instead, for example to compare
40
+ * how several coding tools answer the same developer question. Results
41
+ * include mentions and citations. Saved prompt run settings apply to
42
+ * coding-agent targets. The response returns a run ID to poll with
38
43
  * `GET /v2/prompts/runs/{run_id}/status`.
39
44
  */
40
45
  export function promptsRun(
@@ -0,0 +1,153 @@
1
+ /*
2
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
3
+ * @generated-id: ebd8b3d30dc1
4
+ */
5
+
6
+ import { LightsageMcpCore } from "../core.js";
7
+ import { encodeSimple } from "../lib/encodings.js";
8
+ import { compactMap } from "../lib/primitives.js";
9
+ import { safeParse } from "../lib/schemas.js";
10
+ import { RequestOptions } from "../lib/sdks.js";
11
+ import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
12
+ import { pathToFunc } from "../lib/url.js";
13
+ import { APIError } from "../models/errors/apierror.js";
14
+ import {
15
+ ConnectionError,
16
+ InvalidRequestError,
17
+ RequestAbortedError,
18
+ RequestTimeoutError,
19
+ UnexpectedClientError,
20
+ } from "../models/errors/httpclienterrors.js";
21
+ import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
22
+ import {
23
+ V2PromptRunsCancelRequest,
24
+ V2PromptRunsCancelRequest$zodSchema,
25
+ } from "../models/v2promptrunscancelop.js";
26
+ import { APICall, APIPromise } from "../types/async.js";
27
+ import { Result } from "../types/fp.js";
28
+
29
+ /**
30
+ * Cancel a prompt run
31
+ *
32
+ * @remarks
33
+ * Marks an active prompt run as cancelled and prevents queued prompts from starting. Running coding-agent attempts are stopped asynchronously. Requests already sent to an answer platform cannot be recalled, so prompts already in progress may still finish and store their results, but the run stays cancelled. Prompts that never start use no usage-based credits. The response has the same shape as the status operation, with cancelled prompts counted in `progress.cancelled`. Repeating this request for an already-cancelled run is safe.
34
+ */
35
+ export function promptsRunCancel(
36
+ client$: LightsageMcpCore,
37
+ request: V2PromptRunsCancelRequest,
38
+ options?: RequestOptions,
39
+ ): APIPromise<
40
+ Result<
41
+ Response,
42
+ | APIError
43
+ | SDKValidationError
44
+ | UnexpectedClientError
45
+ | InvalidRequestError
46
+ | RequestAbortedError
47
+ | RequestTimeoutError
48
+ | ConnectionError
49
+ >
50
+ > {
51
+ return new APIPromise($do(
52
+ client$,
53
+ request,
54
+ options,
55
+ ));
56
+ }
57
+
58
+ async function $do(
59
+ client$: LightsageMcpCore,
60
+ request: V2PromptRunsCancelRequest,
61
+ options?: RequestOptions,
62
+ ): Promise<
63
+ [
64
+ Result<
65
+ Response,
66
+ | APIError
67
+ | SDKValidationError
68
+ | UnexpectedClientError
69
+ | InvalidRequestError
70
+ | RequestAbortedError
71
+ | RequestTimeoutError
72
+ | ConnectionError
73
+ >,
74
+ APICall,
75
+ ]
76
+ > {
77
+ const parsed$ = safeParse(
78
+ request,
79
+ (value$) => V2PromptRunsCancelRequest$zodSchema.parse(value$),
80
+ "Input validation failed",
81
+ );
82
+ if (!parsed$.ok) {
83
+ return [parsed$, { status: "invalid" }];
84
+ }
85
+ const payload$ = parsed$.value;
86
+ const body$ = null;
87
+
88
+ const pathParams$ = {
89
+ run_id: encodeSimple("run_id", payload$.run_id, {
90
+ explode: false,
91
+ charEncoding: "percent",
92
+ }),
93
+ };
94
+ const path$ = pathToFunc("/v2/prompts/runs/{run_id}/cancel")(
95
+ pathParams$,
96
+ );
97
+
98
+ const headers$ = new Headers(compactMap({
99
+ Accept: "application/json",
100
+ }));
101
+ const securityInput = await extractSecurity(client$._options.security);
102
+ const requestSecurity = resolveGlobalSecurity(securityInput);
103
+
104
+ const context = {
105
+ options: client$._options,
106
+ baseURL: options?.serverURL ?? client$._baseURL ?? "",
107
+ operationID: "v2_prompt_runs_cancel",
108
+ oAuth2Scopes: null,
109
+ resolvedSecurity: requestSecurity,
110
+ securitySource: client$._options.security,
111
+ retryConfig: options?.retries
112
+ || client$._options.retryConfig
113
+ || { strategy: "none" },
114
+ retryCodes: options?.retryCodes || [
115
+ "429",
116
+ "500",
117
+ "502",
118
+ "503",
119
+ "504",
120
+ ],
121
+ };
122
+
123
+ const requestRes = client$._createRequest(context, {
124
+ security: requestSecurity,
125
+ method: "POST",
126
+ baseURL: options?.serverURL,
127
+ path: path$,
128
+ headers: headers$,
129
+ body: body$,
130
+ userAgent: client$._options.userAgent,
131
+ timeoutMs: options?.timeoutMs || client$._options.timeoutMs
132
+ || -1,
133
+ }, options);
134
+ if (!requestRes.ok) {
135
+ return [requestRes, { status: "invalid" }];
136
+ }
137
+ const req$ = requestRes.value;
138
+
139
+ const doResult = await client$._do(req$, {
140
+ context,
141
+ errorCodes: [],
142
+ retryConfig: context.retryConfig,
143
+ retryCodes: context.retryCodes,
144
+ });
145
+ if (!doResult.ok) {
146
+ return [doResult, { status: "request-error", request: req$ }];
147
+ }
148
+ return [doResult, {
149
+ status: "complete",
150
+ "request": req$,
151
+ response: doResult.value,
152
+ }];
153
+ }