testeiya 0.2.1 → 0.3.10

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 (402) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +284 -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 +57 -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 +172 -0
  20. package/dist/src/args.js.map +1 -0
  21. package/dist/src/cli.js +97 -0
  22. package/dist/src/cli.js.map +1 -0
  23. package/dist/src/doctor.js +186 -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 +185 -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 +291 -0
  40. package/dist/src/run.js.map +1 -0
  41. package/dist/src/session.js +92 -0
  42. package/dist/src/session.js.map +1 -0
  43. package/dist/src/sessions.js +61 -0
  44. package/dist/src/sessions.js.map +1 -0
  45. package/dist/vendor/mcp.js +14801 -0
  46. package/mcp-tools.json +2967 -0
  47. package/package.json +34 -43
  48. package/prompt/context.ts +101 -0
  49. package/prompt/index.ts +102 -0
  50. package/prompt/print.ts +32 -0
  51. package/prompt/project-info.ts +30 -0
  52. package/prompt/system-prompt.ts +187 -0
  53. package/{src/prompt → prompt}/testomatio.ts +120 -9
  54. package/prompt/tools.ts +57 -0
  55. package/prompt/vocab.ts +7 -0
  56. package/skills/codeceptjs/ci-fix-tests/SKILL.md +7 -8
  57. package/skills/codeceptjs/codeceptjs-auth/SKILL.md +47 -64
  58. package/skills/codeceptjs/codeceptjs-exploration/SKILL.md +56 -47
  59. package/skills/codeceptjs/codeceptjs-fundamentals/SKILL.md +144 -106
  60. package/skills/codeceptjs/codeceptjs-run-analysis/SKILL.md +50 -57
  61. package/skills/codeceptjs/debugging-codeceptjs-tests/SKILL.md +88 -196
  62. package/skills/codeceptjs/migrate-codeceptjs-4/SKILL.md +4 -5
  63. package/skills/codeceptjs/migrate-cypress-to-codeceptjs/SKILL.md +25 -36
  64. package/skills/codeceptjs/migrate-protractor-to-codeceptjs/SKILL.md +23 -36
  65. package/skills/codeceptjs/migrate-selenium-java-to-codeceptjs/SKILL.md +23 -36
  66. package/skills/codeceptjs/migrate-testcafe-to-codeceptjs/SKILL.md +23 -35
  67. package/skills/codeceptjs/refactoring-codeceptjs-tests/SKILL.md +50 -53
  68. package/skills/codeceptjs/writing-codeceptjs-tests/SKILL.md +87 -191
  69. package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/SKILL.md +1 -1
  70. package/{skills.lock.json → skills/skills.lock.json} +43 -36
  71. package/skills/skills.yaml +34 -0
  72. package/skills/testomatio/explorbot/explorbot-fundamentals/SKILL.md +49 -61
  73. package/skills/testomatio/explorbot/explorbot-fundamentals/references/no-install.md +36 -0
  74. package/skills/testomatio/explorbot/explorbot-plan/SKILL.md +20 -7
  75. package/skills/testomatio/explorbot/explorbot-setup/SKILL.md +41 -289
  76. package/skills/testomatio/qa-process/qa-explain-behavior/SKILL.md +111 -0
  77. package/skills/testomatio/qa-process/qa-explain-behavior/references/answer-shapes.md +116 -0
  78. package/skills/testomatio/qa-process/qa-explain-behavior/references/examples.md +157 -0
  79. package/skills/testomatio/qa-process/qa-lead-strategy-advisor/SKILL.md +91 -0
  80. package/skills/testomatio/qa-process/qa-lead-strategy-advisor/references/output-format.md +71 -0
  81. package/skills/testomatio/qa-process/testing-workflow/SKILL.md +227 -0
  82. package/skills/testomatio/test-automation/qa-data-seeder/SKILL.md +83 -0
  83. package/skills/testomatio/test-automation/run-tests-with-testomatio-reporter/SKILL.md +5 -3
  84. package/skills/testomatio/test-automation/setup-change-aware-pr-testing/SKILL.md +190 -0
  85. package/skills/testomatio/test-automation/setup-ci-automation/SKILL.md +76 -0
  86. package/skills/testomatio/test-management/qa-split-testing-levels-pyramid/SKILL.md +55 -0
  87. package/skills/testomatio/test-management/qa-sprint-report-by-testomatio/SKILL.md +220 -0
  88. package/skills/testomatio/test-management/qa-sprint-report-by-testomatio/references/qa-sprint-report.md +126 -0
  89. package/skills/testomatio/test-management/qa-test-code-coverage/SKILL.md +1 -1
  90. package/skills/testomatio/test-management/qa-thinking/SKILL.md +25 -25
  91. package/skills/testomatio/test-management/testomatio-mcp/SKILL.md +14 -1
  92. package/skills/testomatio/test-management/testomatio-mcp/references/MCP_SETUP.md +8 -0
  93. package/assets/testeiya-logo-dark.svg +0 -16
  94. package/assets/testeiya-logo.svg +0 -15
  95. package/models.catalog.json +0 -6963
  96. package/skills/playwright-best-practices-skill/LICENSE.md +0 -7
  97. package/skills/playwright-best-practices-skill/README.md +0 -147
  98. package/skills/testeiya/README.md +0 -29
  99. package/skills/testeiya/answer-formatting/SKILL.md +0 -30
  100. package/skills/testeiya/check-cucumber/SKILL.md +0 -200
  101. package/skills/testeiya/check-tests/SKILL.md +0 -260
  102. package/skills/testeiya/manual-run-assistant/SKILL.md +0 -61
  103. package/skills/testeiya/testomatio-docs/INDEX.md +0 -175
  104. package/skills/testeiya/testomatio-docs/SKILL.md +0 -102
  105. package/skills/testeiya/testomatio-docs/docs/advanced/ai-powered-features/ai-agents.md +0 -144
  106. package/skills/testeiya/testomatio-docs/docs/advanced/ai-powered-features/ai-powered-features.md +0 -531
  107. package/skills/testeiya/testomatio-docs/docs/advanced/ai-powered-features/ai-requirements.md +0 -437
  108. package/skills/testeiya/testomatio-docs/docs/advanced/api-access/index.md +0 -191
  109. package/skills/testeiya/testomatio-docs/docs/advanced/branches-folder/index.md +0 -277
  110. package/skills/testeiya/testomatio-docs/docs/advanced/bulk-edit-folder/bulk-edit-demos.mdx +0 -39
  111. package/skills/testeiya/testomatio-docs/docs/advanced/bulk-edit-folder/bulk-edit-on-suite-and-test-level.md +0 -122
  112. package/skills/testeiya/testomatio-docs/docs/advanced/bulk-edit-folder/what-is-bulk-edit.md +0 -170
  113. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/branches.md +0 -53
  114. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/index.mdx +0 -98
  115. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/jira-issue.md +0 -151
  116. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/runs-and-reports.md +0 -377
  117. package/skills/testeiya/testomatio-docs/docs/advanced/jira-plugin/work-in-jira.md +0 -267
  118. package/skills/testeiya/testomatio-docs/docs/advanced/living-doc/index.md +0 -138
  119. package/skills/testeiya/testomatio-docs/docs/advanced/milestones/index.md +0 -220
  120. package/skills/testeiya/testomatio-docs/docs/advanced/shortcuts/index.md +0 -48
  121. package/skills/testeiya/testomatio-docs/docs/advanced/tags-labels/labels-and-custom-fields.md +0 -201
  122. package/skills/testeiya/testomatio-docs/docs/advanced/tags-labels/tags-or-labels.md +0 -94
  123. package/skills/testeiya/testomatio-docs/docs/advanced/tags-labels/tags.md +0 -243
  124. package/skills/testeiya/testomatio-docs/docs/advanced/test-artifacts/index.md +0 -135
  125. package/skills/testeiya/testomatio-docs/docs/advanced/tql/index.md +0 -394
  126. package/skills/testeiya/testomatio-docs/docs/getting-started/index.md +0 -290
  127. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/azure.md +0 -96
  128. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/bamboo.md +0 -94
  129. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/bitbucket.md +0 -106
  130. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/circle.md +0 -115
  131. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/github.md +0 -120
  132. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/gitlab.md +0 -88
  133. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/index.mdx +0 -151
  134. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/jenkins.md +0 -121
  135. package/skills/testeiya/testomatio-docs/docs/integrations/continuous-integration/teamcity.md +0 -96
  136. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/azure.md +0 -31
  137. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/clickup.md +0 -54
  138. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/confluence.md +0 -34
  139. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/github.md +0 -31
  140. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/gitlab.md +0 -93
  141. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/index.md +0 -131
  142. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/jira.md +0 -164
  143. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/linear.md +0 -29
  144. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/shortcut.md +0 -67
  145. package/skills/testeiya/testomatio-docs/docs/integrations/issues-management/youtrack.md +0 -94
  146. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/azure-devops.md +0 -53
  147. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/email.md +0 -71
  148. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/jira.md +0 -52
  149. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/ms-teams.md +0 -60
  150. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/rules.md +0 -267
  151. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/slack.md +0 -82
  152. package/skills/testeiya/testomatio-docs/docs/integrations/report-notifications/telegram.md +0 -73
  153. package/skills/testeiya/testomatio-docs/docs/integrations/scim-provisioning/index.mdx +0 -207
  154. package/skills/testeiya/testomatio-docs/docs/integrations/scim-provisioning/okta.md +0 -204
  155. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/azure.md +0 -95
  156. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/google.md +0 -75
  157. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/index.mdx +0 -33
  158. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/okta.md +0 -108
  159. package/skills/testeiya/testomatio-docs/docs/integrations/single-sign-on/saml.md +0 -66
  160. package/skills/testeiya/testomatio-docs/docs/legal/compliance/gdpr.md +0 -95
  161. package/skills/testeiya/testomatio-docs/docs/legal/compliance/index.mdx +0 -94
  162. package/skills/testeiya/testomatio-docs/docs/legal/compliance/privacy.md +0 -26
  163. package/skills/testeiya/testomatio-docs/docs/legal/compliance/terms.md +0 -32
  164. package/skills/testeiya/testomatio-docs/docs/legal/security/index.mdx +0 -242
  165. package/skills/testeiya/testomatio-docs/docs/legal/security/jira.md +0 -140
  166. package/skills/testeiya/testomatio-docs/docs/legal/security/subprocessors.md +0 -76
  167. package/skills/testeiya/testomatio-docs/docs/management/company/administration.md +0 -363
  168. package/skills/testeiya/testomatio-docs/docs/management/company/audit-log.md +0 -41
  169. package/skills/testeiya/testomatio-docs/docs/management/company/plan-features-comparison.md +0 -240
  170. package/skills/testeiya/testomatio-docs/docs/management/company/subscriptions.md +0 -326
  171. package/skills/testeiya/testomatio-docs/docs/management/company/trials.md +0 -75
  172. package/skills/testeiya/testomatio-docs/docs/management/company/users-and-permissions/accountant.md +0 -49
  173. package/skills/testeiya/testomatio-docs/docs/management/company/users-and-permissions/index.mdx +0 -285
  174. package/skills/testeiya/testomatio-docs/docs/management/company/users-and-permissions/read-only-user.md +0 -67
  175. package/skills/testeiya/testomatio-docs/docs/management/company/users-and-permissions/teams.md +0 -138
  176. package/skills/testeiya/testomatio-docs/docs/management/project/settings.md +0 -87
  177. package/skills/testeiya/testomatio-docs/docs/management/project/templates.md +0 -546
  178. package/skills/testeiya/testomatio-docs/docs/project/analytics/index.md +0 -326
  179. package/skills/testeiya/testomatio-docs/docs/project/import-export/export-tests/classical-tests-markdown-format.md +0 -386
  180. package/skills/testeiya/testomatio-docs/docs/project/import-export/export-tests/download-manual-tests-as-files.md +0 -378
  181. package/skills/testeiya/testomatio-docs/docs/project/import-export/export-tests/export-to-obsidian.md +0 -112
  182. package/skills/testeiya/testomatio-docs/docs/project/import-export/export-tests/export-to-spreadsheet.md +0 -127
  183. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/auto-import.md +0 -63
  184. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-Allure-TestOps.md +0 -49
  185. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-QTest.md +0 -41
  186. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-Qase.md +0 -39
  187. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-Zephyr.md +0 -37
  188. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-csv-xlsx.md +0 -117
  189. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-cucumber.md +0 -93
  190. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-qmetry.md +0 -44
  191. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-source-code.md +0 -117
  192. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-testcaselabs.md +0 -44
  193. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-testmo.md +0 -47
  194. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-testrail.md +0 -82
  195. package/skills/testeiya/testomatio-docs/docs/project/import-export/import/import-tests-from-xray.md +0 -55
  196. package/skills/testeiya/testomatio-docs/docs/project/plans/index.md +0 -334
  197. package/skills/testeiya/testomatio-docs/docs/project/pulse/index.md +0 -104
  198. package/skills/testeiya/testomatio-docs/docs/project/runs/archive-runs-and-groups.md +0 -176
  199. package/skills/testeiya/testomatio-docs/docs/project/runs/custom-statuses.md +0 -195
  200. package/skills/testeiya/testomatio-docs/docs/project/runs/environments.md +0 -203
  201. package/skills/testeiya/testomatio-docs/docs/project/runs/managing-runs.md +0 -455
  202. package/skills/testeiya/testomatio-docs/docs/project/runs/merge-strategies.md +0 -137
  203. package/skills/testeiya/testomatio-docs/docs/project/runs/reports.md +0 -329
  204. package/skills/testeiya/testomatio-docs/docs/project/runs/rungroups.md +0 -342
  205. package/skills/testeiya/testomatio-docs/docs/project/runs/running-automated-tests.md +0 -256
  206. package/skills/testeiya/testomatio-docs/docs/project/runs/running-manual-and-automated-tests.md +0 -331
  207. package/skills/testeiya/testomatio-docs/docs/project/runs/running-tests-manually.md +0 -633
  208. package/skills/testeiya/testomatio-docs/docs/project/runs/temporary-tests-notes.md +0 -223
  209. package/skills/testeiya/testomatio-docs/docs/project/steps-snippets/snippets.md +0 -68
  210. package/skills/testeiya/testomatio-docs/docs/project/steps-snippets/steps.md +0 -181
  211. package/skills/testeiya/testomatio-docs/docs/project/tests/bdd-test-case-editor.md +0 -98
  212. package/skills/testeiya/testomatio-docs/docs/project/tests/classical-test-case-editor.md +0 -354
  213. package/skills/testeiya/testomatio-docs/docs/project/tests/classical-vs-bdd.md +0 -169
  214. package/skills/testeiya/testomatio-docs/docs/project/tests/copy-and-move-your-tests.md +0 -156
  215. package/skills/testeiya/testomatio-docs/docs/project/tests/other-features-for-test-case-design.md +0 -412
  216. package/skills/testeiya/testomatio-docs/docs/project/tests/test-case-creation-and-editing.md +0 -527
  217. package/skills/testeiya/testomatio-docs/docs/support/index.md +0 -75
  218. package/skills/testeiya/testomatio-docs/docs/test-reporting/artifacts.md +0 -388
  219. package/skills/testeiya/testomatio-docs/docs/test-reporting/cli.md +0 -215
  220. package/skills/testeiya/testomatio-docs/docs/test-reporting/configuration.md +0 -247
  221. package/skills/testeiya/testomatio-docs/docs/test-reporting/frameworks.md +0 -490
  222. package/skills/testeiya/testomatio-docs/docs/test-reporting/functions.md +0 -144
  223. package/skills/testeiya/testomatio-docs/docs/test-reporting/index.mdx +0 -48
  224. package/skills/testeiya/testomatio-docs/docs/test-reporting/junit.md +0 -248
  225. package/skills/testeiya/testomatio-docs/docs/test-reporting/logger.md +0 -138
  226. package/skills/testeiya/testomatio-docs/docs/test-reporting/php.md +0 -77
  227. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/bitbucket.md +0 -72
  228. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/csv.md +0 -23
  229. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/debug.md +0 -18
  230. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/github.md +0 -63
  231. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/gitlab.md +0 -29
  232. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/html.md +0 -80
  233. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/index.mdx +0 -57
  234. package/skills/testeiya/testomatio-docs/docs/test-reporting/pipes/testomatio.md +0 -331
  235. package/skills/testeiya/testomatio-docs/docs/test-reporting/python.md +0 -229
  236. package/skills/testeiya/testomatio-docs/docs/test-reporting/workflows.md +0 -325
  237. package/skills/testeiya/testomatio-docs/docs/tutorials/Interacting-via-API.md +0 -159
  238. package/skills/testeiya/testomatio-docs/docs/tutorials/Manual-Testing-Classic.md +0 -164
  239. package/skills/testeiya/testomatio-docs/docs/tutorials/Set-Up-Read-Only-Access.md +0 -85
  240. package/skills/testeiya/testomatio-docs/docs/tutorials/Using-AI-in-Testing.md +0 -163
  241. package/skills/testeiya/testomatio-docs/docs/tutorials/Working-with-Jira.md +0 -125
  242. package/skills/testeiya/testomatio-docs/docs/tutorials/java.md +0 -478
  243. package/skills/testeiya/testomatio-docs/docs/tutorials/playwright.md +0 -207
  244. package/skills/testeiya/testomatio-docs/docs/tutorials/webdriver.md +0 -218
  245. package/skills/testeiya/testomatio-docs/docs.lock.json +0 -6
  246. package/skills/testeiya/testomatio-reporter/SKILL.md +0 -307
  247. package/skills/testomatio/test-automation/setup-pr-testing/SKILL.md +0 -199
  248. package/skills.yaml +0 -21
  249. package/src/ai-debug.ts +0 -188
  250. package/src/api/agent-get.ts +0 -22
  251. package/src/api/agent-start.ts +0 -384
  252. package/src/api/client-log.ts +0 -29
  253. package/src/api/context.ts +0 -332
  254. package/src/api/debug-layout.ts +0 -47
  255. package/src/api/debug-report.ts +0 -29
  256. package/src/api/debug-snapshot.ts +0 -30
  257. package/src/api/debug-stream.ts +0 -52
  258. package/src/api/files-delete.ts +0 -184
  259. package/src/api/files-read.ts +0 -41
  260. package/src/api/files-rename.ts +0 -99
  261. package/src/api/files-tree.ts +0 -292
  262. package/src/api/files-write.ts +0 -41
  263. package/src/api/mcp.ts +0 -603
  264. package/src/api/memory.ts +0 -69
  265. package/src/api/open-external.ts +0 -39
  266. package/src/api/playwright-cli.ts +0 -606
  267. package/src/api/providers.ts +0 -457
  268. package/src/api/read-env-token.ts +0 -33
  269. package/src/api/sessions.ts +0 -79
  270. package/src/api/settings.ts +0 -120
  271. package/src/api/skills.ts +0 -58
  272. package/src/api/testomatio-attachment.ts +0 -89
  273. package/src/api/testomatio-auth.ts +0 -284
  274. package/src/api/testomatio-proxy.ts +0 -197
  275. package/src/api/testomatio-run-stats.ts +0 -81
  276. package/src/api/testomatio-target.ts +0 -225
  277. package/src/api/testomatio-transcription.ts +0 -82
  278. package/src/api/workspace-search.ts +0 -96
  279. package/src/api/workspace-sync.ts +0 -151
  280. package/src/api/workspace.ts +0 -165
  281. package/src/app-server.ts +0 -556
  282. package/src/bridge.ts +0 -251
  283. package/src/check-tests.ts +0 -156
  284. package/src/cli.ts +0 -17
  285. package/src/commands.ts +0 -244
  286. package/src/config.ts +0 -183
  287. package/src/connection.ts +0 -658
  288. package/src/context-store.ts +0 -265
  289. package/src/debug-bus.ts +0 -405
  290. package/src/extensions/tool-gate.ts +0 -220
  291. package/src/extensions/webui/ask-channel.ts +0 -52
  292. package/src/extensions/webui/index.ts +0 -184
  293. package/src/extensions/webui/tools/ask-question.ts +0 -88
  294. package/src/extensions/webui/tools/query-result.ts +0 -79
  295. package/src/extensions/webui/tools/render-chart.ts +0 -53
  296. package/src/extensions/webui/tools/render-item.ts +0 -61
  297. package/src/extensions/webui/tools/render-list.ts +0 -170
  298. package/src/extensions/webui/tools/render-result.ts +0 -85
  299. package/src/extensions/webui/tools/render-tree.ts +0 -71
  300. package/src/extensions/webui/tools/ui-widget.ts +0 -54
  301. package/src/extensions/webui/tools/widget-result.ts +0 -13
  302. package/src/extensions/webui/widget-channel.ts +0 -50
  303. package/src/file-log.ts +0 -196
  304. package/src/git-tracked.ts +0 -68
  305. package/src/gitignore.ts +0 -53
  306. package/src/json-store.ts +0 -43
  307. package/src/load-env.ts +0 -70
  308. package/src/loader-style.ts +0 -96
  309. package/src/main.ts +0 -140
  310. package/src/mcp-catalog.ts +0 -96
  311. package/src/models-catalog.ts +0 -72
  312. package/src/permissions.ts +0 -120
  313. package/src/project-dir.ts +0 -189
  314. package/src/project-info.ts +0 -108
  315. package/src/prompt/app-ui.ts +0 -59
  316. package/src/prompt/browser.ts +0 -27
  317. package/src/prompt/index.ts +0 -62
  318. package/src/prompt/tools.ts +0 -27
  319. package/src/server-info.ts +0 -62
  320. package/src/session-factory.ts +0 -442
  321. package/src/session-store.ts +0 -115
  322. package/src/shell-env.ts +0 -45
  323. package/src/skills.ts +0 -163
  324. package/src/sync-snapshot.ts +0 -140
  325. package/src/telemetry.ts +0 -239
  326. package/src/testomatio-auth.ts +0 -299
  327. package/src/testomatio.ts +0 -98
  328. package/src/theme.ts +0 -30
  329. package/src/user-env.ts +0 -94
  330. package/src/welcome.ts +0 -194
  331. package/src/workspace/safe-path.ts +0 -85
  332. package/src/workspace/test-md.ts +0 -70
  333. package/src/workspace-model.ts +0 -440
  334. package/testeiya.config.json +0 -14
  335. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/authentication-flows.md +0 -0
  336. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/authentication.md +0 -0
  337. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/clock-mocking.md +0 -0
  338. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/mobile-testing.md +0 -0
  339. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/multi-context.md +0 -0
  340. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/multi-user.md +0 -0
  341. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/network-advanced.md +0 -0
  342. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/advanced/third-party.md +0 -0
  343. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/architecture/pom-vs-fixtures.md +0 -0
  344. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/architecture/test-architecture.md +0 -0
  345. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/architecture/when-to-mock.md +0 -0
  346. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/browser-apis/browser-apis.md +0 -0
  347. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/browser-apis/iframes.md +0 -0
  348. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/browser-apis/service-workers.md +0 -0
  349. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/browser-apis/websockets.md +0 -0
  350. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/annotations.md +0 -0
  351. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/assertions-waiting.md +0 -0
  352. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/configuration.md +0 -0
  353. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/fixtures-hooks.md +0 -0
  354. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/global-setup.md +0 -0
  355. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/locators.md +0 -0
  356. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/page-object-model.md +0 -0
  357. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/projects-dependencies.md +0 -0
  358. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/test-data.md +0 -0
  359. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/test-suite-structure.md +0 -0
  360. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/core/test-tags.md +0 -0
  361. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/debugging/console-errors.md +0 -0
  362. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/debugging/debugging.md +0 -0
  363. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/debugging/error-testing.md +0 -0
  364. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/debugging/flaky-tests.md +0 -0
  365. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/frameworks/angular.md +0 -0
  366. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/frameworks/nextjs.md +0 -0
  367. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/frameworks/react.md +0 -0
  368. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/frameworks/vue.md +0 -0
  369. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/ci-cd.md +0 -0
  370. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/docker.md +0 -0
  371. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/github-actions.md +0 -0
  372. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/gitlab.md +0 -0
  373. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/other-providers.md +0 -0
  374. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/parallel-sharding.md +0 -0
  375. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/performance.md +0 -0
  376. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/reporting.md +0 -0
  377. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/infrastructure-ci-cd/test-coverage.md +0 -0
  378. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/accessibility.md +0 -0
  379. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/api-testing.md +0 -0
  380. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/browser-extensions.md +0 -0
  381. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/canvas-webgl.md +0 -0
  382. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/component-testing.md +0 -0
  383. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/drag-drop.md +0 -0
  384. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/electron.md +0 -0
  385. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/file-operations.md +0 -0
  386. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/file-upload-download.md +0 -0
  387. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/forms-validation.md +0 -0
  388. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/graphql-testing.md +0 -0
  389. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/i18n.md +0 -0
  390. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/performance-testing.md +0 -0
  391. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/security-testing.md +0 -0
  392. /package/skills/{playwright-best-practices-skill → playwright/playwright-best-practices}/testing-patterns/visual-regression.md +0 -0
  393. /package/skills/{playwright-cli → playwright/playwright-cli}/SKILL.md +0 -0
  394. /package/skills/{playwright-cli → playwright/playwright-cli}/references/element-attributes.md +0 -0
  395. /package/skills/{playwright-cli → playwright/playwright-cli}/references/playwright-tests.md +0 -0
  396. /package/skills/{playwright-cli → playwright/playwright-cli}/references/request-mocking.md +0 -0
  397. /package/skills/{playwright-cli → playwright/playwright-cli}/references/running-code.md +0 -0
  398. /package/skills/{playwright-cli → playwright/playwright-cli}/references/session-management.md +0 -0
  399. /package/skills/{playwright-cli → playwright/playwright-cli}/references/storage-state.md +0 -0
  400. /package/skills/{playwright-cli → playwright/playwright-cli}/references/test-generation.md +0 -0
  401. /package/skills/{playwright-cli → playwright/playwright-cli}/references/tracing.md +0 -0
  402. /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
- }