testeiya 0.2.1 → 0.3.1-0.1

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 (404) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +309 -171
  3. package/dist/prompt/context.js +79 -0
  4. package/dist/prompt/context.js.map +1 -0
  5. package/dist/prompt/index.js +60 -0
  6. package/dist/prompt/index.js.map +1 -0
  7. package/dist/prompt/print.js +30 -0
  8. package/dist/prompt/print.js.map +1 -0
  9. package/dist/prompt/project-info.js +2 -0
  10. package/dist/prompt/project-info.js.map +1 -0
  11. package/{src/prompt/system-prompt.ts → dist/prompt/system-prompt.js} +38 -25
  12. package/dist/prompt/system-prompt.js.map +1 -0
  13. package/dist/prompt/testomatio.js +264 -0
  14. package/dist/prompt/testomatio.js.map +1 -0
  15. package/dist/prompt/tools.js +70 -0
  16. package/dist/prompt/tools.js.map +1 -0
  17. package/dist/prompt/vocab.js +8 -0
  18. package/dist/prompt/vocab.js.map +1 -0
  19. package/dist/src/args.js +207 -0
  20. package/dist/src/args.js.map +1 -0
  21. package/dist/src/cli.js +114 -0
  22. package/dist/src/cli.js.map +1 -0
  23. package/dist/src/doctor.js +171 -0
  24. package/dist/src/doctor.js.map +1 -0
  25. package/dist/src/env.js +93 -0
  26. package/dist/src/env.js.map +1 -0
  27. package/dist/src/mcp-extension.js +9 -0
  28. package/dist/src/mcp-extension.js.map +1 -0
  29. package/dist/src/mcp.js +139 -0
  30. package/dist/src/mcp.js.map +1 -0
  31. package/dist/src/model.js +71 -0
  32. package/dist/src/model.js.map +1 -0
  33. package/dist/src/models.js +38 -0
  34. package/dist/src/models.js.map +1 -0
  35. package/dist/src/output.js +194 -0
  36. package/dist/src/output.js.map +1 -0
  37. package/dist/src/result.js +41 -0
  38. package/dist/src/result.js.map +1 -0
  39. package/dist/src/run.js +295 -0
  40. package/dist/src/run.js.map +1 -0
  41. package/dist/src/session.js +98 -0
  42. package/dist/src/session.js.map +1 -0
  43. package/dist/src/sessions.js +72 -0
  44. package/dist/src/sessions.js.map +1 -0
  45. package/dist/src/skills.js +88 -0
  46. package/dist/src/skills.js.map +1 -0
  47. package/dist/vendor/mcp.js +14801 -0
  48. package/mcp-tools.json +2967 -0
  49. package/package.json +34 -43
  50. package/prompt/context.ts +101 -0
  51. package/prompt/index.ts +102 -0
  52. package/prompt/print.ts +32 -0
  53. package/prompt/project-info.ts +30 -0
  54. package/prompt/system-prompt.ts +187 -0
  55. package/{src/prompt → prompt}/testomatio.ts +120 -9
  56. package/prompt/tools.ts +72 -0
  57. package/prompt/vocab.ts +7 -0
  58. package/skills/codeceptjs/ci-fix-tests/SKILL.md +7 -8
  59. package/skills/codeceptjs/codeceptjs-auth/SKILL.md +47 -64
  60. package/skills/codeceptjs/codeceptjs-exploration/SKILL.md +56 -47
  61. package/skills/codeceptjs/codeceptjs-fundamentals/SKILL.md +144 -106
  62. package/skills/codeceptjs/codeceptjs-run-analysis/SKILL.md +50 -57
  63. package/skills/codeceptjs/debugging-codeceptjs-tests/SKILL.md +88 -196
  64. package/skills/codeceptjs/migrate-codeceptjs-4/SKILL.md +4 -5
  65. package/skills/codeceptjs/migrate-cypress-to-codeceptjs/SKILL.md +25 -36
  66. package/skills/codeceptjs/migrate-protractor-to-codeceptjs/SKILL.md +23 -36
  67. package/skills/codeceptjs/migrate-selenium-java-to-codeceptjs/SKILL.md +23 -36
  68. package/skills/codeceptjs/migrate-testcafe-to-codeceptjs/SKILL.md +23 -35
  69. package/skills/codeceptjs/refactoring-codeceptjs-tests/SKILL.md +50 -53
  70. package/skills/codeceptjs/writing-codeceptjs-tests/SKILL.md +87 -191
  71. package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/SKILL.md +1 -1
  72. package/{skills.lock.json → skills/skills.lock.json} +43 -36
  73. package/skills/skills.yaml +34 -0
  74. package/skills/testomatio/explorbot/explorbot-fundamentals/SKILL.md +49 -61
  75. package/skills/testomatio/explorbot/explorbot-fundamentals/references/no-install.md +36 -0
  76. package/skills/testomatio/explorbot/explorbot-plan/SKILL.md +20 -7
  77. package/skills/testomatio/explorbot/explorbot-setup/SKILL.md +41 -289
  78. package/skills/testomatio/qa-process/qa-explain-behavior/SKILL.md +111 -0
  79. package/skills/testomatio/qa-process/qa-explain-behavior/references/answer-shapes.md +116 -0
  80. package/skills/testomatio/qa-process/qa-explain-behavior/references/examples.md +157 -0
  81. package/skills/testomatio/qa-process/qa-lead-strategy-advisor/SKILL.md +91 -0
  82. package/skills/testomatio/qa-process/qa-lead-strategy-advisor/references/output-format.md +71 -0
  83. package/skills/testomatio/qa-process/testing-workflow/SKILL.md +227 -0
  84. package/skills/testomatio/test-automation/qa-data-seeder/SKILL.md +83 -0
  85. package/skills/testomatio/test-automation/run-tests-with-testomatio-reporter/SKILL.md +5 -3
  86. package/skills/testomatio/test-automation/setup-change-aware-pr-testing/SKILL.md +190 -0
  87. package/skills/testomatio/test-automation/setup-ci-automation/SKILL.md +76 -0
  88. package/skills/testomatio/test-management/qa-split-testing-levels-pyramid/SKILL.md +55 -0
  89. package/skills/testomatio/test-management/qa-sprint-report-by-testomatio/SKILL.md +220 -0
  90. package/skills/testomatio/test-management/qa-sprint-report-by-testomatio/references/qa-sprint-report.md +126 -0
  91. package/skills/testomatio/test-management/qa-test-code-coverage/SKILL.md +1 -1
  92. package/skills/testomatio/test-management/qa-thinking/SKILL.md +25 -25
  93. package/skills/testomatio/test-management/testomatio-mcp/SKILL.md +14 -1
  94. package/skills/testomatio/test-management/testomatio-mcp/references/MCP_SETUP.md +8 -0
  95. package/assets/testeiya-logo-dark.svg +0 -16
  96. package/assets/testeiya-logo.svg +0 -15
  97. package/models.catalog.json +0 -6963
  98. package/skills/playwright-best-practices-skill/LICENSE.md +0 -7
  99. package/skills/playwright-best-practices-skill/README.md +0 -147
  100. package/skills/testeiya/README.md +0 -29
  101. package/skills/testeiya/answer-formatting/SKILL.md +0 -30
  102. package/skills/testeiya/check-cucumber/SKILL.md +0 -200
  103. package/skills/testeiya/check-tests/SKILL.md +0 -260
  104. package/skills/testeiya/manual-run-assistant/SKILL.md +0 -61
  105. package/skills/testeiya/testomatio-docs/INDEX.md +0 -175
  106. package/skills/testeiya/testomatio-docs/SKILL.md +0 -102
  107. package/skills/testeiya/testomatio-docs/docs/advanced/ai-powered-features/ai-agents.md +0 -144
  108. package/skills/testeiya/testomatio-docs/docs/advanced/ai-powered-features/ai-powered-features.md +0 -531
  109. package/skills/testeiya/testomatio-docs/docs/advanced/ai-powered-features/ai-requirements.md +0 -437
  110. package/skills/testeiya/testomatio-docs/docs/advanced/api-access/index.md +0 -191
  111. package/skills/testeiya/testomatio-docs/docs/advanced/branches-folder/index.md +0 -277
  112. package/skills/testeiya/testomatio-docs/docs/advanced/bulk-edit-folder/bulk-edit-demos.mdx +0 -39
  113. package/skills/testeiya/testomatio-docs/docs/advanced/bulk-edit-folder/bulk-edit-on-suite-and-test-level.md +0 -122
  114. package/skills/testeiya/testomatio-docs/docs/advanced/bulk-edit-folder/what-is-bulk-edit.md +0 -170
  115. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/branches.md +0 -53
  116. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/index.mdx +0 -98
  117. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/jira-issue.md +0 -151
  118. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/runs-and-reports.md +0 -377
  119. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/work-in-jira.md +0 -267
  120. package/skills/testeiya/testomatio-docs/docs/advanced/living-doc/index.md +0 -138
  121. package/skills/testeiya/testomatio-docs/docs/advanced/milestones/index.md +0 -220
  122. package/skills/testeiya/testomatio-docs/docs/advanced/shortcuts/index.md +0 -48
  123. package/skills/testeiya/testomatio-docs/docs/advanced/tags-labels/labels-and-custom-fields.md +0 -201
  124. package/skills/testeiya/testomatio-docs/docs/advanced/tags-labels/tags-or-labels.md +0 -94
  125. package/skills/testeiya/testomatio-docs/docs/advanced/tags-labels/tags.md +0 -243
  126. package/skills/testeiya/testomatio-docs/docs/advanced/test-artifacts/index.md +0 -135
  127. package/skills/testeiya/testomatio-docs/docs/advanced/tql/index.md +0 -394
  128. package/skills/testeiya/testomatio-docs/docs/getting-started/index.md +0 -290
  129. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/azure.md +0 -96
  130. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/bamboo.md +0 -94
  131. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/bitbucket.md +0 -106
  132. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/circle.md +0 -115
  133. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/github.md +0 -120
  134. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/gitlab.md +0 -88
  135. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/index.mdx +0 -151
  136. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/jenkins.md +0 -121
  137. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/teamcity.md +0 -96
  138. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/azure.md +0 -31
  139. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/clickup.md +0 -54
  140. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/confluence.md +0 -34
  141. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/github.md +0 -31
  142. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/gitlab.md +0 -93
  143. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/index.md +0 -131
  144. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/jira.md +0 -164
  145. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/linear.md +0 -29
  146. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/shortcut.md +0 -67
  147. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/youtrack.md +0 -94
  148. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/azure-devops.md +0 -53
  149. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/email.md +0 -71
  150. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/jira.md +0 -52
  151. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/ms-teams.md +0 -60
  152. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/rules.md +0 -267
  153. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/slack.md +0 -82
  154. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/telegram.md +0 -73
  155. package/skills/testeiya/testomatio-docs/docs/integrations/scim-provisioning/index.mdx +0 -207
  156. package/skills/testeiya/testomatio-docs/docs/integrations/scim-provisioning/okta.md +0 -204
  157. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/azure.md +0 -95
  158. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/google.md +0 -75
  159. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/index.mdx +0 -33
  160. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/okta.md +0 -108
  161. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/saml.md +0 -66
  162. package/skills/testeiya/testomatio-docs/docs/legal/compliance/gdpr.md +0 -95
  163. package/skills/testeiya/testomatio-docs/docs/legal/compliance/index.mdx +0 -94
  164. package/skills/testeiya/testomatio-docs/docs/legal/compliance/privacy.md +0 -26
  165. package/skills/testeiya/testomatio-docs/docs/legal/compliance/terms.md +0 -32
  166. package/skills/testeiya/testomatio-docs/docs/legal/security/index.mdx +0 -242
  167. package/skills/testeiya/testomatio-docs/docs/legal/security/jira.md +0 -140
  168. package/skills/testeiya/testomatio-docs/docs/legal/security/subprocessors.md +0 -76
  169. package/skills/testeiya/testomatio-docs/docs/management/company/administration.md +0 -363
  170. package/skills/testeiya/testomatio-docs/docs/management/company/audit-log.md +0 -41
  171. package/skills/testeiya/testomatio-docs/docs/management/company/plan-features-comparison.md +0 -240
  172. package/skills/testeiya/testomatio-docs/docs/management/company/subscriptions.md +0 -326
  173. package/skills/testeiya/testomatio-docs/docs/management/company/trials.md +0 -75
  174. package/skills/testeiya/testomatio-docs/docs/management/company/users-and-permissions/accountant.md +0 -49
  175. package/skills/testeiya/testomatio-docs/docs/management/company/users-and-permissions/index.mdx +0 -285
  176. package/skills/testeiya/testomatio-docs/docs/management/company/users-and-permissions/read-only-user.md +0 -67
  177. package/skills/testeiya/testomatio-docs/docs/management/company/users-and-permissions/teams.md +0 -138
  178. package/skills/testeiya/testomatio-docs/docs/management/project/settings.md +0 -87
  179. package/skills/testeiya/testomatio-docs/docs/management/project/templates.md +0 -546
  180. package/skills/testeiya/testomatio-docs/docs/project/analytics/index.md +0 -326
  181. package/skills/testeiya/testomatio-docs/docs/project/import-export/export-tests/classical-tests-markdown-format.md +0 -386
  182. package/skills/testeiya/testomatio-docs/docs/project/import-export/export-tests/download-manual-tests-as-files.md +0 -378
  183. package/skills/testeiya/testomatio-docs/docs/project/import-export/export-tests/export-to-obsidian.md +0 -112
  184. package/skills/testeiya/testomatio-docs/docs/project/import-export/export-tests/export-to-spreadsheet.md +0 -127
  185. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/auto-import.md +0 -63
  186. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-Allure-TestOps.md +0 -49
  187. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-QTest.md +0 -41
  188. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-Qase.md +0 -39
  189. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-Zephyr.md +0 -37
  190. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-csv-xlsx.md +0 -117
  191. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-cucumber.md +0 -93
  192. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-qmetry.md +0 -44
  193. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-source-code.md +0 -117
  194. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-testcaselabs.md +0 -44
  195. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-testmo.md +0 -47
  196. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-testrail.md +0 -82
  197. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-xray.md +0 -55
  198. package/skills/testeiya/testomatio-docs/docs/project/plans/index.md +0 -334
  199. package/skills/testeiya/testomatio-docs/docs/project/pulse/index.md +0 -104
  200. package/skills/testeiya/testomatio-docs/docs/project/runs/archive-runs-and-groups.md +0 -176
  201. package/skills/testeiya/testomatio-docs/docs/project/runs/custom-statuses.md +0 -195
  202. package/skills/testeiya/testomatio-docs/docs/project/runs/environments.md +0 -203
  203. package/skills/testeiya/testomatio-docs/docs/project/runs/managing-runs.md +0 -455
  204. package/skills/testeiya/testomatio-docs/docs/project/runs/merge-strategies.md +0 -137
  205. package/skills/testeiya/testomatio-docs/docs/project/runs/reports.md +0 -329
  206. package/skills/testeiya/testomatio-docs/docs/project/runs/rungroups.md +0 -342
  207. package/skills/testeiya/testomatio-docs/docs/project/runs/running-automated-tests.md +0 -256
  208. package/skills/testeiya/testomatio-docs/docs/project/runs/running-manual-and-automated-tests.md +0 -331
  209. package/skills/testeiya/testomatio-docs/docs/project/runs/running-tests-manually.md +0 -633
  210. package/skills/testeiya/testomatio-docs/docs/project/runs/temporary-tests-notes.md +0 -223
  211. package/skills/testeiya/testomatio-docs/docs/project/steps-snippets/snippets.md +0 -68
  212. package/skills/testeiya/testomatio-docs/docs/project/steps-snippets/steps.md +0 -181
  213. package/skills/testeiya/testomatio-docs/docs/project/tests/bdd-test-case-editor.md +0 -98
  214. package/skills/testeiya/testomatio-docs/docs/project/tests/classical-test-case-editor.md +0 -354
  215. package/skills/testeiya/testomatio-docs/docs/project/tests/classical-vs-bdd.md +0 -169
  216. package/skills/testeiya/testomatio-docs/docs/project/tests/copy-and-move-your-tests.md +0 -156
  217. package/skills/testeiya/testomatio-docs/docs/project/tests/other-features-for-test-case-design.md +0 -412
  218. package/skills/testeiya/testomatio-docs/docs/project/tests/test-case-creation-and-editing.md +0 -527
  219. package/skills/testeiya/testomatio-docs/docs/support/index.md +0 -75
  220. package/skills/testeiya/testomatio-docs/docs/test-reporting/artifacts.md +0 -388
  221. package/skills/testeiya/testomatio-docs/docs/test-reporting/cli.md +0 -215
  222. package/skills/testeiya/testomatio-docs/docs/test-reporting/configuration.md +0 -247
  223. package/skills/testeiya/testomatio-docs/docs/test-reporting/frameworks.md +0 -490
  224. package/skills/testeiya/testomatio-docs/docs/test-reporting/functions.md +0 -144
  225. package/skills/testeiya/testomatio-docs/docs/test-reporting/index.mdx +0 -48
  226. package/skills/testeiya/testomatio-docs/docs/test-reporting/junit.md +0 -248
  227. package/skills/testeiya/testomatio-docs/docs/test-reporting/logger.md +0 -138
  228. package/skills/testeiya/testomatio-docs/docs/test-reporting/php.md +0 -77
  229. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/bitbucket.md +0 -72
  230. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/csv.md +0 -23
  231. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/debug.md +0 -18
  232. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/github.md +0 -63
  233. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/gitlab.md +0 -29
  234. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/html.md +0 -80
  235. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/index.mdx +0 -57
  236. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/testomatio.md +0 -331
  237. package/skills/testeiya/testomatio-docs/docs/test-reporting/python.md +0 -229
  238. package/skills/testeiya/testomatio-docs/docs/test-reporting/workflows.md +0 -325
  239. package/skills/testeiya/testomatio-docs/docs/tutorials/Interacting-via-API.md +0 -159
  240. package/skills/testeiya/testomatio-docs/docs/tutorials/Manual-Testing-Classic.md +0 -164
  241. package/skills/testeiya/testomatio-docs/docs/tutorials/Set-Up-Read-Only-Access.md +0 -85
  242. package/skills/testeiya/testomatio-docs/docs/tutorials/Using-AI-in-Testing.md +0 -163
  243. package/skills/testeiya/testomatio-docs/docs/tutorials/Working-with-Jira.md +0 -125
  244. package/skills/testeiya/testomatio-docs/docs/tutorials/java.md +0 -478
  245. package/skills/testeiya/testomatio-docs/docs/tutorials/playwright.md +0 -207
  246. package/skills/testeiya/testomatio-docs/docs/tutorials/webdriver.md +0 -218
  247. package/skills/testeiya/testomatio-docs/docs.lock.json +0 -6
  248. package/skills/testeiya/testomatio-reporter/SKILL.md +0 -307
  249. package/skills/testomatio/test-automation/setup-pr-testing/SKILL.md +0 -199
  250. package/skills.yaml +0 -21
  251. package/src/ai-debug.ts +0 -188
  252. package/src/api/agent-get.ts +0 -22
  253. package/src/api/agent-start.ts +0 -384
  254. package/src/api/client-log.ts +0 -29
  255. package/src/api/context.ts +0 -332
  256. package/src/api/debug-layout.ts +0 -47
  257. package/src/api/debug-report.ts +0 -29
  258. package/src/api/debug-snapshot.ts +0 -30
  259. package/src/api/debug-stream.ts +0 -52
  260. package/src/api/files-delete.ts +0 -184
  261. package/src/api/files-read.ts +0 -41
  262. package/src/api/files-rename.ts +0 -99
  263. package/src/api/files-tree.ts +0 -292
  264. package/src/api/files-write.ts +0 -41
  265. package/src/api/mcp.ts +0 -603
  266. package/src/api/memory.ts +0 -69
  267. package/src/api/open-external.ts +0 -39
  268. package/src/api/playwright-cli.ts +0 -606
  269. package/src/api/providers.ts +0 -457
  270. package/src/api/read-env-token.ts +0 -33
  271. package/src/api/sessions.ts +0 -79
  272. package/src/api/settings.ts +0 -120
  273. package/src/api/skills.ts +0 -58
  274. package/src/api/testomatio-attachment.ts +0 -89
  275. package/src/api/testomatio-auth.ts +0 -284
  276. package/src/api/testomatio-proxy.ts +0 -197
  277. package/src/api/testomatio-run-stats.ts +0 -81
  278. package/src/api/testomatio-target.ts +0 -225
  279. package/src/api/testomatio-transcription.ts +0 -82
  280. package/src/api/workspace-search.ts +0 -96
  281. package/src/api/workspace-sync.ts +0 -151
  282. package/src/api/workspace.ts +0 -165
  283. package/src/app-server.ts +0 -556
  284. package/src/bridge.ts +0 -251
  285. package/src/check-tests.ts +0 -156
  286. package/src/cli.ts +0 -17
  287. package/src/commands.ts +0 -244
  288. package/src/config.ts +0 -183
  289. package/src/connection.ts +0 -658
  290. package/src/context-store.ts +0 -265
  291. package/src/debug-bus.ts +0 -405
  292. package/src/extensions/tool-gate.ts +0 -220
  293. package/src/extensions/webui/ask-channel.ts +0 -52
  294. package/src/extensions/webui/index.ts +0 -184
  295. package/src/extensions/webui/tools/ask-question.ts +0 -88
  296. package/src/extensions/webui/tools/query-result.ts +0 -79
  297. package/src/extensions/webui/tools/render-chart.ts +0 -53
  298. package/src/extensions/webui/tools/render-item.ts +0 -61
  299. package/src/extensions/webui/tools/render-list.ts +0 -170
  300. package/src/extensions/webui/tools/render-result.ts +0 -85
  301. package/src/extensions/webui/tools/render-tree.ts +0 -71
  302. package/src/extensions/webui/tools/ui-widget.ts +0 -54
  303. package/src/extensions/webui/tools/widget-result.ts +0 -13
  304. package/src/extensions/webui/widget-channel.ts +0 -50
  305. package/src/file-log.ts +0 -196
  306. package/src/git-tracked.ts +0 -68
  307. package/src/gitignore.ts +0 -53
  308. package/src/json-store.ts +0 -43
  309. package/src/load-env.ts +0 -70
  310. package/src/loader-style.ts +0 -96
  311. package/src/main.ts +0 -140
  312. package/src/mcp-catalog.ts +0 -96
  313. package/src/models-catalog.ts +0 -72
  314. package/src/permissions.ts +0 -120
  315. package/src/project-dir.ts +0 -189
  316. package/src/project-info.ts +0 -108
  317. package/src/prompt/app-ui.ts +0 -59
  318. package/src/prompt/browser.ts +0 -27
  319. package/src/prompt/index.ts +0 -62
  320. package/src/prompt/tools.ts +0 -27
  321. package/src/server-info.ts +0 -62
  322. package/src/session-factory.ts +0 -442
  323. package/src/session-store.ts +0 -115
  324. package/src/shell-env.ts +0 -45
  325. package/src/skills.ts +0 -163
  326. package/src/sync-snapshot.ts +0 -140
  327. package/src/telemetry.ts +0 -239
  328. package/src/testomatio-auth.ts +0 -299
  329. package/src/testomatio.ts +0 -98
  330. package/src/theme.ts +0 -30
  331. package/src/user-env.ts +0 -94
  332. package/src/welcome.ts +0 -194
  333. package/src/workspace/safe-path.ts +0 -85
  334. package/src/workspace/test-md.ts +0 -70
  335. package/src/workspace-model.ts +0 -440
  336. package/testeiya.config.json +0 -14
  337. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/authentication-flows.md +0 -0
  338. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/authentication.md +0 -0
  339. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/clock-mocking.md +0 -0
  340. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/mobile-testing.md +0 -0
  341. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/multi-context.md +0 -0
  342. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/multi-user.md +0 -0
  343. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/network-advanced.md +0 -0
  344. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/third-party.md +0 -0
  345. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/architecture/pom-vs-fixtures.md +0 -0
  346. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/architecture/test-architecture.md +0 -0
  347. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/architecture/when-to-mock.md +0 -0
  348. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/browser-apis/browser-apis.md +0 -0
  349. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/browser-apis/iframes.md +0 -0
  350. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/browser-apis/service-workers.md +0 -0
  351. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/browser-apis/websockets.md +0 -0
  352. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/annotations.md +0 -0
  353. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/assertions-waiting.md +0 -0
  354. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/configuration.md +0 -0
  355. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/fixtures-hooks.md +0 -0
  356. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/global-setup.md +0 -0
  357. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/locators.md +0 -0
  358. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/page-object-model.md +0 -0
  359. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/projects-dependencies.md +0 -0
  360. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/test-data.md +0 -0
  361. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/test-suite-structure.md +0 -0
  362. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/test-tags.md +0 -0
  363. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/debugging/console-errors.md +0 -0
  364. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/debugging/debugging.md +0 -0
  365. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/debugging/error-testing.md +0 -0
  366. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/debugging/flaky-tests.md +0 -0
  367. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/frameworks/angular.md +0 -0
  368. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/frameworks/nextjs.md +0 -0
  369. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/frameworks/react.md +0 -0
  370. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/frameworks/vue.md +0 -0
  371. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/ci-cd.md +0 -0
  372. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/docker.md +0 -0
  373. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/github-actions.md +0 -0
  374. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/gitlab.md +0 -0
  375. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/other-providers.md +0 -0
  376. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/parallel-sharding.md +0 -0
  377. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/performance.md +0 -0
  378. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/reporting.md +0 -0
  379. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/test-coverage.md +0 -0
  380. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/accessibility.md +0 -0
  381. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/api-testing.md +0 -0
  382. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/browser-extensions.md +0 -0
  383. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/canvas-webgl.md +0 -0
  384. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/component-testing.md +0 -0
  385. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/drag-drop.md +0 -0
  386. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/electron.md +0 -0
  387. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/file-operations.md +0 -0
  388. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/file-upload-download.md +0 -0
  389. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/forms-validation.md +0 -0
  390. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/graphql-testing.md +0 -0
  391. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/i18n.md +0 -0
  392. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/performance-testing.md +0 -0
  393. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/security-testing.md +0 -0
  394. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/visual-regression.md +0 -0
  395. /package/skills/{playwright-cli → playwright/playwright-cli}/SKILL.md +0 -0
  396. /package/skills/{playwright-cli → playwright/playwright-cli}/references/element-attributes.md +0 -0
  397. /package/skills/{playwright-cli → playwright/playwright-cli}/references/playwright-tests.md +0 -0
  398. /package/skills/{playwright-cli → playwright/playwright-cli}/references/request-mocking.md +0 -0
  399. /package/skills/{playwright-cli → playwright/playwright-cli}/references/running-code.md +0 -0
  400. /package/skills/{playwright-cli → playwright/playwright-cli}/references/session-management.md +0 -0
  401. /package/skills/{playwright-cli → playwright/playwright-cli}/references/storage-state.md +0 -0
  402. /package/skills/{playwright-cli → playwright/playwright-cli}/references/test-generation.md +0 -0
  403. /package/skills/{playwright-cli → playwright/playwright-cli}/references/tracing.md +0 -0
  404. /package/skills/{playwright-cli → playwright/playwright-cli}/references/video-recording.md +0 -0
@@ -1,62 +0,0 @@
1
- import { getSystemPrompt } from "./system-prompt.js";
2
- import {
3
- testomatioTms,
4
- testomatioConnection,
5
- testomatioNotConnected,
6
- projectSettings,
7
- } from "./testomatio.js";
8
- import { appUiGuidance } from "./app-ui.js";
9
- import { browserControl } from "./browser.js";
10
- import {
11
- contextPromptSection,
12
- type ContextEntry,
13
- type ContextFolder,
14
- } from "../context-store.js";
15
- import type { TestomatioProjectInfo } from "../project-info.js";
16
-
17
- export function buildSystemPrompt(options?: SystemPromptOptions): string {
18
- // The base prompt (role, workspace, tools, goals) comes first — it defines who
19
- // the agent is. Specialized rules layer on after it, dynamic context goes last.
20
- const parts: string[] = [getSystemPrompt(options?.cwd)];
21
-
22
- const tokenSlugs = options?.tokens ? Object.keys(options.tokens) : [];
23
- // The TUI passes no `connection`, so it keeps the managed-tokens gating.
24
- const tokenAvailable = options?.connection?.tokenAvailable ?? tokenSlugs.length > 0;
25
- if (tokenSlugs.length > 0) parts.push(testomatioTms);
26
- if (options?.mode === "web") parts.push(appUiGuidance);
27
- if (options?.browser) parts.push(browserControl);
28
-
29
- if (options?.promptContext) {
30
- parts.push(`## Project Test Context\n\n${options.promptContext}`);
31
- }
32
- if (options?.contextEntries?.length || options?.contextFolders?.length) {
33
- parts.push(
34
- contextPromptSection(options.contextEntries ?? [], options.contextFolders ?? [])
35
- );
36
- }
37
- if (options?.projectInfo) {
38
- parts.push(projectSettings(options.projectInfo));
39
- }
40
- if (tokenAvailable || tokenSlugs.length > 0) {
41
- parts.push(testomatioConnection(tokenSlugs, options?.backendUrl, options?.connection));
42
- } else if (options?.mode === "web") {
43
- parts.push(testomatioNotConnected());
44
- }
45
-
46
- return parts.join("\n\n");
47
- }
48
-
49
- export interface SystemPromptOptions {
50
- cwd?: string;
51
- promptContext?: string;
52
- backendUrl?: string;
53
- tokens?: Record<string, string>;
54
- connection?: { tokenAvailable?: boolean; projectId?: string; title?: string };
55
- mode?: "tui" | "web";
56
- browser?: boolean;
57
- projectInfo?: TestomatioProjectInfo | null;
58
- /** User-added context (linked folders, cloned repos, uploaded docs). */
59
- contextEntries?: ContextEntry[];
60
- /** Non-empty predefined `.testeiya` context folders (manual-tests, code, …). */
61
- contextFolders?: ContextFolder[];
62
- }
@@ -1,27 +0,0 @@
1
- import dedent from 'dedent';
2
-
3
- export const tools = dedent`
4
- <available-tools>
5
- You have these tools available:
6
- * **Read operations (use freely):** \`read\`, \`grep\`, \`ls\`.
7
- - Use these aggressively to understand the system under test before proposing changes.
8
- * **Write operations (restricted):** \`write\`, \`edit\`, \`bash\`.
9
- - Requires explicit user confirmation for destructive or shared-state actions.
10
- * **User interaction:** \`ask\`.
11
- - Use for clarifying requirements or providing multi-choice options.
12
- - **Ask questions** in a way that leads to actionable answers. Avoid open-ended questions that require interpretation.
13
- * **Browser automation (use \`playwright-cli\`):** For any browser task — launching a browser, navigating, clicking, filling forms, taking screenshots, recording video — drive the \`playwright-cli\` command-line tool through \`bash\` and follow the \`playwright-cli\` skill. Always prefer it over the built-in \`browser\` tool. Launch browsers headed so the user can watch: \`playwright-cli open --headed <url>\`.
14
- - A message may include a \`<browser_state>\` notice — that means a browser is already open at that URL. Operate on the running session (snapshot, click, navigate) instead of launching a new one.
15
- * **Internal Skills:** For QA-related tasks, check available skills first and prefer using them when applicable.
16
- * **External Integrations:** Use MCP tools when they provide superior data or specialized integrations.
17
- - Primary MCP (Testomat.io): Use Testomat.io MCP tools to extend functionality.
18
- - Secondary MCP (Jira, GitHub, etc.): Invoke only when user explicitly asks or when remote context exploration is required.
19
-
20
- <tool-governance>
21
- * **Prioritize Specificity:** Use \`read\` instead of \`cat\`, and \`edit\` instead of \`sed\`. Dedicated tools provide better error tracking and safety.
22
- * **Parallel Execution:** Call independent tools in parallel to minimize latency. Sequential calls are reserved for operations with data dependencies.
23
- * **Atomic Updates:** Mark tasks as complete in your internal state immediately upon execution. Do not batch status updates.
24
- * **Analysis-First:** Use your own reasoning to guide tool selection. Do not wait for step-by-step instructions if discovery tools can provide the answer.
25
- </tool-governance>
26
- </available-tools>
27
- `;
@@ -1,62 +0,0 @@
1
- import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
2
- import { join } from "node:path";
3
- import { HOME_DIR } from "./project-dir.js";
4
-
5
- /*
6
- * Publishes where the running app-server is reachable so an out-of-band tool
7
- * (the `testeiya-debug` skill, `scripts/debug-snapshot.ts`) can find it — the
8
- * desktop app binds a random free port (`port: 0`) that is otherwise written
9
- * nowhere. `writeServerInfo` is called once the port is known; the file is
10
- * best-effort removed on exit. Only the latest instance is recorded.
11
- */
12
-
13
- export const SERVER_INFO_FILE = join(HOME_DIR, "server.json");
14
-
15
- export function writeServerInfo(info: ServerInfo): void {
16
- try {
17
- if (!existsSync(HOME_DIR)) mkdirSync(HOME_DIR, { recursive: true });
18
- writeFileSync(SERVER_INFO_FILE, JSON.stringify(info, null, 2));
19
- } catch {}
20
- for (const signal of ["exit", "SIGINT", "SIGTERM"] as const) {
21
- process.once(signal, clearServerInfo);
22
- }
23
- }
24
-
25
- export function readServerInfo(): ServerInfo | null {
26
- let info: ServerInfo;
27
- try {
28
- if (!existsSync(SERVER_INFO_FILE)) return null;
29
- info = JSON.parse(readFileSync(SERVER_INFO_FILE, "utf8")) as ServerInfo;
30
- } catch {
31
- return null;
32
- }
33
- // A server killed with SIGKILL (or a crash) never runs the exit cleanup, so a
34
- // stale file can point at a dead port. Ignore it unless its pid is alive.
35
- if (!isProcessAlive(info.pid)) return null;
36
- return info;
37
- }
38
-
39
- function isProcessAlive(pid: number): boolean {
40
- if (!pid) return false;
41
- try {
42
- process.kill(pid, 0);
43
- return true;
44
- } catch (err) {
45
- return (err as { code?: string })?.code === "EPERM";
46
- }
47
- }
48
-
49
- function clearServerInfo(): void {
50
- try {
51
- rmSync(SERVER_INFO_FILE, { force: true });
52
- } catch {}
53
- }
54
-
55
- export interface ServerInfo {
56
- port: number;
57
- pid: number;
58
- url: string;
59
- mode: string;
60
- startedAt: string;
61
- logFile?: string | null;
62
- }
@@ -1,442 +0,0 @@
1
- import { join } from "node:path";
2
- import { mkdirSync } from "node:fs";
3
-
4
- import {
5
- createAgentSession,
6
- AuthStorage,
7
- ModelRegistry,
8
- Settings,
9
- SessionManager,
10
- } from "@oh-my-pi/pi-coding-agent";
11
- import type { ExtensionFactory } from "@oh-my-pi/pi-coding-agent";
12
- import { hasPlaywrightCli, loadBundledSkills, loadCustomSkills, dedupeSkillsByName } from "./skills.js";
13
- import { SOURCE_PATHS } from "@oh-my-pi/pi-coding-agent/discovery/helpers";
14
- import { DEFAULT_MODEL_PER_PROVIDER } from "@oh-my-pi/pi-ai";
15
- import { PROJECT_DIR, HOME_DIR, ensureProjectDirGuards } from "./project-dir.js";
16
-
17
- // Rebrand the SDK's project-level config dir from `.omp` to `.testeiya`.
18
- // The SDK has no supported override for this (PI_CONFIG_DIR only affects the
19
- // user-level config root; `SOURCE_PATHS.native.projectDir` is a static const
20
- // with no env/option hook). This is a deliberate in-process monkey patch:
21
- // - `SOURCE_PATHS` is a plain object (`as const` is TS-only, not frozen),
22
- // - the builtin discovery provider holds a *live reference* via
23
- // `const PATHS = SOURCE_PATHS.native` and reads `.projectDir` at call time,
24
- // - so mutating it once at module load (before any createAgentSession() runs)
25
- // redirects MCP/skills/rules/AGENTS discovery to `<cwd>/.testeiya/*`.
26
- // No node_modules edits; survives reinstalls. If an SDK upgrade changes these
27
- // internals, the MCP-connectivity check in our session smoke test is the guard.
28
- if (SOURCE_PATHS.native.projectDir !== PROJECT_DIR) {
29
- (SOURCE_PATHS.native as { projectDir: string }).projectDir = PROJECT_DIR;
30
- }
31
-
32
- // Companion monkey patch: overlay the live TESTOMATIO* env vars onto the SDK's
33
- // (frozen-after-first-use) shell env so agent bash commands always run with the
34
- // current session's Testomat.io credentials. See shell-env.ts.
35
- import "./shell-env.js";
36
-
37
- // Every discovery provider that loads MCP configs from another tool
38
- // (Cursor, Claude, VSCode, etc.) or from arbitrary project-root files.
39
- // We keep only `builtin` — it reads our per-session `<cwd>/.testeiya/mcp.json`.
40
- const OTHER_MCP_PROVIDERS = [
41
- "mcp-json",
42
- "cursor",
43
- "claude",
44
- "claude-plugins",
45
- "codex",
46
- "gemini",
47
- "opencode",
48
- "vscode",
49
- "windsurf",
50
- ];
51
-
52
- // The SDK's bash tool runs on the brush shell, where a heredoc inside $(...)
53
- // intermittently fails with a bogus "syntax error near token" — and
54
- // `playwright-cli run-code` snippets have no Node globals. Both failures are
55
- // cryptic and cost the model several retries; intercept them with an
56
- // actionable message instead. Replaces the SDK's default rules (cat/grep/find
57
- // redirects), which we don't want.
58
- const BASH_GUARD_RULES = [
59
- {
60
- pattern: "\\$\\((?!\\()[^)\\n]*<<",
61
- tool: "write",
62
- message:
63
- "Heredocs inside $(...) command substitution are unreliable in this shell. " +
64
- "Write the script to a file with the write tool and run it, or use a " +
65
- "single-line node -e / node -p. Top-level heredocs (not inside $(...)) work fine.",
66
- },
67
- {
68
- pattern: "playwright-cli\\s+run-code[\\s\\S]*process\\.env",
69
- tool: "bash",
70
- message:
71
- "playwright-cli run-code executes in a browser sandbox — process.env and " +
72
- "other Node globals are not available there. Read the values in bash first " +
73
- "and interpolate them into the snippet.",
74
- },
75
- ];
76
-
77
- import { loadConfig, type TesteiyaConfig } from "./config.js";
78
- import { listContext, listContextFolders } from "./context-store.js";
79
- import { resolveProjectInfo } from "./project-info.js";
80
- import { buildSystemPrompt } from "./prompt/index.js";
81
- import { createPermissionExtension } from "./permissions.js";
82
- import type { AskChannel } from "./extensions/webui/ask-channel.js";
83
- import type { WidgetCommandChannel } from "./extensions/webui/widget-channel.js";
84
- import { createCommandsExtension, type CommandsRuntime } from "./commands.js";
85
- import { createToolGateExtension, type ToolGateRuntime } from "./extensions/tool-gate.js";
86
- import { createTelemetryExtension, isTelemetryEnabled } from "./telemetry.js";
87
-
88
- /** Derive API key env var name from provider name (e.g., "openrouter" -> "OPENROUTER_API_KEY") */
89
- function getApiKeyEnvVar(providerName: string): string {
90
- return `${providerName.toUpperCase().replace(/[^A-Z0-9]/g, "_")}_API_KEY`;
91
- }
92
-
93
- export interface SessionOptions {
94
- cwd?: string;
95
- projectIds?: string[];
96
- promptContext?: string;
97
- backendUrl?: string;
98
- tokens?: Record<string, string>;
99
- /**
100
- * How this workspace's Testomat.io credentials were resolved (connection.ts):
101
- * whether a token is exported to the shell env, and the linked project's
102
- * id/title when known. Drives the system-prompt guidance for sessions that
103
- * have no managed `tokens` (linked folders, `.env`, mcp.json).
104
- */
105
- connection?: { tokenAvailable?: boolean; projectId?: string; title?: string };
106
- /** The session's Testomat.io projects (from the session store), when managed. */
107
- projects?: { slug: string; title: string; status: "ok" | "error" }[];
108
- /**
109
- * Which frontend is driving this session.
110
- * - "tui" → activates Pi's built-in `ask` tool via `hasUI: true`; no
111
- * web-UI tools are registered.
112
- * - "web" → loads the `webui` extension (render_list / render_tree /
113
- * render_item / ask_question + tool_result UI notices) and
114
- * leaves `hasUI` off so the built-in `ask` isn't created.
115
- * Default: "tui".
116
- */
117
- mode?: "tui" | "web";
118
- /**
119
- * Resume an existing SDK conversation transcript (by its `SessionManager` id)
120
- * so new turns append to that file with full prior context. When omitted, a
121
- * fresh conversation is created.
122
- */
123
- resumeConversationId?: string;
124
- /**
125
- * The user deliberately opened this workspace (folder picker,
126
- * `TESTEIYA_WORKSPACE`, or the terminal CLI cwd), so the agent gets full
127
- * read/write/bash access instead of the default read-only gating.
128
- */
129
- trusted?: boolean;
130
- [key: string]: unknown;
131
- }
132
-
133
- export async function createTesteiyaSession(options?: SessionOptions) {
134
- const config = loadConfig();
135
- const cwd = options?.cwd ?? process.cwd();
136
- const agentDir = HOME_DIR;
137
-
138
- mkdirSync(agentDir, { recursive: true });
139
-
140
- const settings = await Settings.init({ cwd, agentDir });
141
- const existing = new Set((settings.get("disabledProviders") ?? []) as string[]);
142
- for (const id of OTHER_MCP_PROVIDERS) existing.add(id);
143
- settings.set("disabledProviders", Array.from(existing));
144
-
145
- // Per-project autonomous memory: the SDK extracts durable signal from this
146
- // workspace's past session transcripts, consolidates it under
147
- // `~/.testeiya/memories/state/--<cwd>--/`, and auto-injects a summary into the
148
- // system prompt of future sessions for the same `cwd`. On by default; the user
149
- // toggles it in Settings (persisted to config.json). Our sessions are persisted
150
- // and run at taskDepth 0, so this flag is all that gates activation.
151
- settings.set("memories.enabled", config.memoryEnabled);
152
-
153
- settings.set("bashInterceptor.enabled", true);
154
- settings.set("bashInterceptor.patterns", BASH_GUARD_RULES);
155
-
156
- // Resolve the active model via the SDK's ModelRegistry. The provider + model
157
- // are chosen in the Providers & Models UI and persisted to
158
- // ~/.testeiya/config.json; for dev/CI we still honor the provider's env var
159
- // (e.g. OPENROUTER_API_KEY). The registry knows each provider's real
160
- // transport (anthropic-messages, openai-codex-responses, google-gemini-cli,
161
- // openai-completions, …) and discovers models live — so we no longer hardcode
162
- // a single provider/api here.
163
- const providerName = config.provider.name;
164
- const apiKeyEnvVar = getApiKeyEnvVar(providerName);
165
-
166
- const authStorage = await AuthStorage.create(join(agentDir, "auth.json"));
167
- // `create()` doesn't load persisted credentials into memory — reload so a
168
- // signed-in subscription / saved API key is actually visible (otherwise only
169
- // env-var keys resolve).
170
- await authStorage.reload();
171
- const envKey = process.env[apiKeyEnvVar];
172
- if (envKey) {
173
- authStorage.setRuntimeApiKey(providerName, envKey);
174
- }
175
-
176
- const modelRegistry = new ModelRegistry(authStorage);
177
-
178
- // Resolution: (1) bundled lookup, (2) after live discovery, (3) the provider's
179
- // SDK default model, (4) legacy custom OpenAI-compatible provider via baseUrl.
180
- let model =
181
- modelRegistry.find(providerName, config.provider.model) ?? undefined;
182
- if (!model) {
183
- try {
184
- await modelRegistry.refreshProvider(providerName, "online-if-uncached");
185
- } catch {
186
- // Discovery is best-effort; fall through to the remaining strategies.
187
- }
188
- model =
189
- modelRegistry.find(providerName, config.provider.model) ?? undefined;
190
- }
191
- if (!model) {
192
- const fallbackId = (
193
- DEFAULT_MODEL_PER_PROVIDER as Record<string, string>
194
- )[providerName];
195
- if (fallbackId) {
196
- model = modelRegistry.find(providerName, fallbackId) ?? undefined;
197
- }
198
- }
199
- const isKnownProvider =
200
- providerName in (DEFAULT_MODEL_PER_PROVIDER as Record<string, unknown>);
201
- if (!model && config.provider.baseUrl && !isKnownProvider) {
202
- // Back-compat: a custom OpenAI-compatible provider defined purely via
203
- // config.baseUrl (not one the SDK ships). Guarded to known providers so a
204
- // stale baseUrl can't mis-register e.g. openai-codex as openai-completions.
205
- const apiKey = await authStorage.getApiKey(providerName);
206
- if (apiKey) {
207
- modelRegistry.registerProvider(providerName, {
208
- baseUrl: config.provider.baseUrl,
209
- api: "openai-completions",
210
- apiKey,
211
- models: [
212
- {
213
- id: config.provider.model,
214
- name: config.provider.model,
215
- reasoning: false,
216
- input: ["text"] as ("text" | "image")[],
217
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
218
- contextWindow: config.provider.contextWindow,
219
- maxTokens: config.provider.maxTokens,
220
- },
221
- ],
222
- });
223
- model =
224
- modelRegistry.find(providerName, config.provider.model) ?? undefined;
225
- }
226
- }
227
- if (!model) {
228
- throw new Error(
229
- `Could not resolve model "${config.provider.model}" for provider ` +
230
- `"${providerName}". Pick a model in the Providers & Models dialog.`
231
- );
232
- }
233
-
234
- // Pre-flight credential check so we surface a clean "add a key / sign in"
235
- // message instead of failing on the first prompt. Keyless providers (ollama,
236
- // lm-studio, …) return the SDK's no-auth sentinel, so they pass.
237
- const credential = await modelRegistry.getApiKeyForProvider(providerName);
238
- if (!credential) {
239
- throw new Error(
240
- `Missing API key for "${providerName}". Open the Providers & Models ` +
241
- `dialog and add your ${providerName} API key or sign in, or set the ` +
242
- `${apiKeyEnvVar} environment variable.`
243
- );
244
- }
245
-
246
- // The linked project's settings (framework, labels, tags, CI profiles, …) —
247
- // the `.testeiya/project-info.json` cache written on project select, refreshed
248
- // here when stale and credentials resolve. Best-effort: null just omits the
249
- // prompt section.
250
- const projectInfo = await resolveProjectInfo(cwd, {
251
- tokens: options?.tokens,
252
- backendUrl: options?.backendUrl,
253
- projects: options?.projects ?? [],
254
- });
255
-
256
- // Backfill the `.gitignore`/`.ignore` guard pair for workspaces whose
257
- // `.testeiya` predates the `.ignore` search whitelist.
258
- ensureProjectDirGuards(cwd);
259
-
260
- // Gate the browser-automation guidance on whether the @playwright/cli tool is
261
- // actually installed (the playwright-cli skill itself is vendored from GitHub).
262
- const systemPrompt = buildSystemPrompt({
263
- cwd,
264
- promptContext: options?.promptContext,
265
- tokens: options?.tokens,
266
- backendUrl: options?.backendUrl,
267
- connection: options?.connection,
268
- mode: options?.mode,
269
- browser: hasPlaywrightCli(),
270
- projectInfo,
271
- contextEntries: listContext(cwd),
272
- contextFolders: listContextFolders(cwd),
273
- });
274
-
275
- // Load skills: the prebuilt skills vendored from GitHub into cli/skills
276
- // (Testomat.io, CodeceptJS, Playwright) + the user's custom skills (global
277
- // ~/.testeiya/skills and this workspace's .testeiya/skills). Deduped by name
278
- // so a custom skill can override a bundled one and the SDK never receives two
279
- // skills of one name.
280
- const skills = dedupeSkillsByName([
281
- ...loadBundledSkills(),
282
- ...loadCustomSkills(cwd),
283
- ]);
284
-
285
- const mode = options?.mode ?? "tui";
286
-
287
- // The commands extension needs the MCP manager (created below with the
288
- // session) to live-connect servers from /connect — pass a mutable runtime
289
- // and fill it in after createAgentSession returns.
290
- const commandsRuntime: CommandsRuntime = { cwd };
291
- const toolGateRuntime: ToolGateRuntime = {};
292
- const extensions: ExtensionFactory[] = [
293
- createPermissionExtension(config, cwd, options?.trusted) as ExtensionFactory,
294
- createCommandsExtension(commandsRuntime),
295
- createToolGateExtension(toolGateRuntime, config.toolGate),
296
- ];
297
- let askChannel: AskChannel | undefined;
298
- let widgetChannel: WidgetCommandChannel | undefined;
299
- if (mode === "web") {
300
- const { createWebUIExtension, AskChannel, WidgetCommandChannel } = await import(
301
- "./extensions/webui/index.js"
302
- );
303
- askChannel = new AskChannel();
304
- widgetChannel = new WidgetCommandChannel();
305
- extensions.push(createWebUIExtension(askChannel, widgetChannel));
306
- }
307
-
308
- if (isTelemetryEnabled()) {
309
- extensions.push(
310
- createTelemetryExtension({
311
- cwd,
312
- mode,
313
- modelId: model.id,
314
- provider: model.provider,
315
- projectIds: options?.projectIds,
316
- }),
317
- );
318
- }
319
-
320
- // Own the SessionManager so we control the conversation id (returned to the
321
- // UI) and can resume a chosen transcript. Same default dir the SDK would pick.
322
- const sessionDir = SessionManager.getDefaultSessionDir(cwd, agentDir);
323
- const sessionManager = await resolveSessionManager(
324
- cwd,
325
- sessionDir,
326
- options?.resumeConversationId,
327
- );
328
-
329
- // Create session
330
- const result = await createAgentSession({
331
- cwd,
332
- agentDir,
333
- settings,
334
- model,
335
- sessionManager,
336
- // Cast to the SDK's ThinkingLevel: its non-"off" members are nominal
337
- // `const enum Effort` values, but the runtime strings are identical to our
338
- // config union, so this is safe (and self-maintaining via Parameters<>).
339
- thinkingLevel: config.thinkingLevel as NonNullable<
340
- Parameters<typeof createAgentSession>[0]
341
- >["thinkingLevel"],
342
- authStorage,
343
- modelRegistry,
344
- systemPrompt,
345
- skills,
346
- extensions,
347
- hasUI: mode === "tui",
348
- disableExtensionDiscovery: true,
349
- enableMCP: true,
350
- enableLsp: false,
351
- // Intentionally no `toolNames` filter — pi-coding-agent treats it as a
352
- // whitelist and would hide all discovered MCP tools. We rely on MCP server
353
- // configs in `<cwd>/.testeiya/mcp.json` and the permission extension to gate
354
- // dangerous calls instead.
355
- });
356
-
357
- commandsRuntime.mcpManager = result.mcpManager;
358
- toolGateRuntime.mcpManager = result.mcpManager;
359
- initExtensionRunner(result.session);
360
-
361
- return {
362
- ...result,
363
- model,
364
- config,
365
- agentDir,
366
- params: options,
367
- askChannel,
368
- widgetChannel,
369
- conversationId: sessionManager.getSessionId(),
370
- };
371
- }
372
-
373
- async function resolveSessionManager(
374
- cwd: string,
375
- sessionDir: string,
376
- resumeConversationId?: string,
377
- ): Promise<SessionManager> {
378
- if (!resumeConversationId) return SessionManager.create(cwd, sessionDir);
379
- const infos = await SessionManager.list(cwd, sessionDir);
380
- const match = infos.find((i) => i.id === resumeConversationId);
381
- if (!match) return SessionManager.create(cwd, sessionDir);
382
- return SessionManager.open(match.path, sessionDir);
383
- }
384
-
385
- // The SDK wires extension runtime *actions* (setActiveTools, sendMessage, …)
386
- // only from its own mode controllers (print/interactive/rpc). Testeiya drives
387
- // the session directly, so without this call every action method throws
388
- // ExtensionRuntimeNotInitializedError forever. Mirrors print-mode.ts.
389
- function initExtensionRunner(sessionValue: unknown): void {
390
- const session = sessionValue as any;
391
- const runner = session?.extensionRunner;
392
- if (!runner) return;
393
- runner.initialize(
394
- {
395
- sendMessage: (message: unknown, options: unknown) => {
396
- session.sendCustomMessage(message, options).catch((e: any) => {
397
- console.warn("[ext] sendMessage failed:", e?.message ?? e);
398
- });
399
- },
400
- sendUserMessage: (content: unknown, options: unknown) => {
401
- session.sendUserMessage(content, options).catch((e: any) => {
402
- console.warn("[ext] sendUserMessage failed:", e?.message ?? e);
403
- });
404
- },
405
- appendEntry: (customType: string, data: unknown) =>
406
- session.sessionManager.appendCustomEntry(customType, data),
407
- setLabel: (targetId: string, label: unknown) =>
408
- session.sessionManager.appendLabelChange(targetId, label),
409
- getActiveTools: () => session.getActiveToolNames(),
410
- getAllTools: () => session.getAllToolNames(),
411
- setActiveTools: (toolNames: string[]) => session.setActiveToolsByName(toolNames),
412
- getCommands: () => [],
413
- setModel: async (model: unknown) => {
414
- const key = await session.modelRegistry.getApiKey(model);
415
- if (!key) return false;
416
- await session.setModel(model);
417
- return true;
418
- },
419
- getThinkingLevel: () => session.thinkingLevel,
420
- setThinkingLevel: (level: unknown) => session.setThinkingLevel(level),
421
- },
422
- {
423
- getModel: () => session.model,
424
- getSearchDb: () => session.searchDb,
425
- isIdle: () => !session.isStreaming,
426
- abort: () => session.abort(),
427
- hasPendingMessages: () => session.queuedMessageCount > 0,
428
- shutdown: () => {},
429
- getContextUsage: () => session.getContextUsage(),
430
- getSystemPrompt: () => session.systemPrompt,
431
- compact: async (instructionsOrOptions: unknown) => {
432
- const instructions =
433
- typeof instructionsOrOptions === "string" ? instructionsOrOptions : undefined;
434
- const options =
435
- instructionsOrOptions && typeof instructionsOrOptions === "object"
436
- ? instructionsOrOptions
437
- : undefined;
438
- await session.compact(instructions, options);
439
- },
440
- }
441
- );
442
- }