@engenty/wizards-runtime 0.0.0-stage → 0.7.5

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 (518) hide show
  1. package/LICENSE +110 -0
  2. package/README.md +214 -2
  3. package/apps/runtime/dist/agents/architect.js +444 -0
  4. package/apps/runtime/dist/agents/studio-assistant.js +883 -0
  5. package/apps/runtime/dist/agents/subscription.js +207 -0
  6. package/apps/runtime/dist/agents/thought.js +21 -0
  7. package/apps/runtime/dist/agents/website.js +480 -0
  8. package/apps/runtime/dist/app.js +359 -0
  9. package/apps/runtime/dist/apple/wizards-apple +0 -0
  10. package/apps/runtime/dist/assistant/browser.js +26 -0
  11. package/apps/runtime/dist/assistant/docs.js +158 -0
  12. package/apps/runtime/dist/assistant/knows.js +353 -0
  13. package/apps/runtime/dist/assistant/primer.js +26 -0
  14. package/apps/runtime/dist/assistant/runs.js +24 -0
  15. package/apps/runtime/dist/auth/account.js +175 -0
  16. package/apps/runtime/dist/auth/device.js +112 -0
  17. package/apps/runtime/dist/auth/index.js +358 -0
  18. package/apps/runtime/dist/auth/keys.js +55 -0
  19. package/apps/runtime/dist/auth/local-ticket.js +26 -0
  20. package/apps/runtime/dist/authoring/example.js +74 -0
  21. package/apps/runtime/dist/authoring/guide.js +433 -0
  22. package/apps/runtime/dist/authoring/ops.js +117 -0
  23. package/apps/runtime/dist/browser/fast/action-space.js +160 -0
  24. package/apps/runtime/dist/browser/fast/classifier.js +91 -0
  25. package/apps/runtime/dist/browser/fast/decide.js +171 -0
  26. package/apps/runtime/dist/browser/fast/driver.js +141 -0
  27. package/apps/runtime/dist/browser/fast/instructions.js +33 -0
  28. package/apps/runtime/dist/browser/fast/run.js +249 -0
  29. package/apps/runtime/dist/browser/fast/span-picker.js +153 -0
  30. package/apps/runtime/dist/browser/fast/text-helper.js +178 -0
  31. package/apps/runtime/dist/browser/snapshot.js +335 -0
  32. package/apps/runtime/dist/cli/account.js +385 -0
  33. package/apps/runtime/dist/cli/autostart.js +182 -0
  34. package/apps/runtime/dist/cli/autoupdate.js +221 -0
  35. package/apps/runtime/dist/cli/clients.js +44 -0
  36. package/apps/runtime/dist/cli/connect.js +540 -0
  37. package/apps/runtime/dist/cli/environment.js +93 -0
  38. package/apps/runtime/dist/cli/exec.js +45 -0
  39. package/apps/runtime/dist/cli/features.js +50 -0
  40. package/apps/runtime/dist/cli/home.js +88 -0
  41. package/apps/runtime/dist/cli/install-env.js +33 -0
  42. package/apps/runtime/dist/cli/machine.js +107 -0
  43. package/apps/runtime/dist/cli/main.js +222 -0
  44. package/apps/runtime/dist/cli/mcp.js +136 -0
  45. package/apps/runtime/dist/cli/menu.js +202 -0
  46. package/apps/runtime/dist/cli/processes.js +72 -0
  47. package/apps/runtime/dist/cli/report.js +66 -0
  48. package/apps/runtime/dist/cli/setup.js +335 -0
  49. package/apps/runtime/dist/cli/start.js +276 -0
  50. package/apps/runtime/dist/cli/status.js +203 -0
  51. package/apps/runtime/dist/cli/ui.js +59 -0
  52. package/apps/runtime/dist/cli/uninstall-main.js +20 -0
  53. package/apps/runtime/dist/cli/uninstall.js +231 -0
  54. package/apps/runtime/dist/cli/update.js +86 -0
  55. package/apps/runtime/dist/cli/validate.js +75 -0
  56. package/apps/runtime/dist/cli/versions.js +123 -0
  57. package/apps/runtime/dist/connectors/builtin.js +86 -0
  58. package/apps/runtime/dist/connectors/external.js +409 -0
  59. package/apps/runtime/dist/connectors/gmail.js +107 -0
  60. package/apps/runtime/dist/connectors/imap.js +261 -0
  61. package/apps/runtime/dist/connectors/index.js +325 -0
  62. package/apps/runtime/dist/connectors/mail.js +72 -0
  63. package/apps/runtime/dist/connectors/outlook.js +90 -0
  64. package/apps/runtime/dist/connectors/plugin-connections.js +343 -0
  65. package/apps/runtime/dist/connectors/via-account.js +65 -0
  66. package/apps/runtime/dist/credits/credits.js +100 -0
  67. package/apps/runtime/dist/credits/estimate.js +152 -0
  68. package/apps/runtime/dist/db/adopt.js +149 -0
  69. package/apps/runtime/dist/db/client.js +173 -0
  70. package/apps/runtime/dist/db/control-schema.js +133 -0
  71. package/apps/runtime/dist/db/migrations/control/0000_last_absorbing_man.sql +47 -0
  72. package/apps/runtime/dist/db/migrations/control/0001_gorgeous_nicolaos.sql +41 -0
  73. package/apps/runtime/dist/db/migrations/control/0002_secret_penance.sql +1 -0
  74. package/apps/runtime/dist/db/migrations/control/0003_nasty_mordo.sql +3 -0
  75. package/apps/runtime/dist/db/migrations/control/0004_breezy_eddie_brock.sql +6 -0
  76. package/apps/runtime/dist/db/migrations/control/0005_chilly_oracle.sql +1 -0
  77. package/apps/runtime/dist/db/migrations/control/0006_sleepy_mojo.sql +1 -0
  78. package/apps/runtime/dist/db/migrations/control/0007_common_the_hand.sql +15 -0
  79. package/apps/runtime/dist/db/migrations/control/0008_runner.sql +8 -0
  80. package/apps/runtime/dist/db/migrations/control/0009_plugin_claim.sql +9 -0
  81. package/apps/runtime/dist/db/migrations/control/0010_tan_snowbird.sql +6 -0
  82. package/apps/runtime/dist/db/migrations/control/meta/0000_snapshot.json +311 -0
  83. package/apps/runtime/dist/db/migrations/control/meta/0001_snapshot.json +599 -0
  84. package/apps/runtime/dist/db/migrations/control/meta/0002_snapshot.json +607 -0
  85. package/apps/runtime/dist/db/migrations/control/meta/0003_snapshot.json +311 -0
  86. package/apps/runtime/dist/db/migrations/control/meta/0004_snapshot.json +350 -0
  87. package/apps/runtime/dist/db/migrations/control/meta/0005_snapshot.json +358 -0
  88. package/apps/runtime/dist/db/migrations/control/meta/0006_snapshot.json +365 -0
  89. package/apps/runtime/dist/db/migrations/control/meta/0007_snapshot.json +460 -0
  90. package/apps/runtime/dist/db/migrations/control/meta/0008_snapshot.json +505 -0
  91. package/apps/runtime/dist/db/migrations/control/meta/0009_snapshot.json +561 -0
  92. package/apps/runtime/dist/db/migrations/control/meta/0010_snapshot.json +600 -0
  93. package/apps/runtime/dist/db/migrations/control/meta/_journal.json +83 -0
  94. package/apps/runtime/dist/db/migrations/tenant/0000_eminent_freak.sql +188 -0
  95. package/apps/runtime/dist/db/migrations/tenant/0001_salty_master_chief.sql +1 -0
  96. package/apps/runtime/dist/db/migrations/tenant/0002_cloudy_firebird.sql +1 -0
  97. package/apps/runtime/dist/db/migrations/tenant/0003_brown_warbound.sql +52 -0
  98. package/apps/runtime/dist/db/migrations/tenant/0004_romantic_nocturne.sql +6 -0
  99. package/apps/runtime/dist/db/migrations/tenant/0005_reflective_forgotten_one.sql +2 -0
  100. package/apps/runtime/dist/db/migrations/tenant/0006_hard_war_machine.sql +30 -0
  101. package/apps/runtime/dist/db/migrations/tenant/0007_space_data.sql +43 -0
  102. package/apps/runtime/dist/db/migrations/tenant/0008_run_event_note.sql +1 -0
  103. package/apps/runtime/dist/db/migrations/tenant/0009_knowledge.sql +104 -0
  104. package/apps/runtime/dist/db/migrations/tenant/0010_plugin_connection.sql +15 -0
  105. package/apps/runtime/dist/db/migrations/tenant/0011_runners.sql +2 -0
  106. package/apps/runtime/dist/db/migrations/tenant/0012_assistant_chat.sql +40 -0
  107. package/apps/runtime/dist/db/migrations/tenant/0013_run_origin.sql +1 -0
  108. package/apps/runtime/dist/db/migrations/tenant/0014_run_answer.sql +2 -0
  109. package/apps/runtime/dist/db/migrations/tenant/0015_device_calls.sql +13 -0
  110. package/apps/runtime/dist/db/migrations/tenant/0016_even_trish_tilby.sql +12 -0
  111. package/apps/runtime/dist/db/migrations/tenant/meta/0000_snapshot.json +1323 -0
  112. package/apps/runtime/dist/db/migrations/tenant/meta/0001_snapshot.json +1330 -0
  113. package/apps/runtime/dist/db/migrations/tenant/meta/0002_snapshot.json +1337 -0
  114. package/apps/runtime/dist/db/migrations/tenant/meta/0003_snapshot.json +1605 -0
  115. package/apps/runtime/dist/db/migrations/tenant/meta/0004_snapshot.json +1645 -0
  116. package/apps/runtime/dist/db/migrations/tenant/meta/0005_snapshot.json +1659 -0
  117. package/apps/runtime/dist/db/migrations/tenant/meta/0006_snapshot.json +1696 -0
  118. package/apps/runtime/dist/db/migrations/tenant/meta/0007_snapshot.json +2012 -0
  119. package/apps/runtime/dist/db/migrations/tenant/meta/0008_snapshot.json +2019 -0
  120. package/apps/runtime/dist/db/migrations/tenant/meta/0009_snapshot.json +2837 -0
  121. package/apps/runtime/dist/db/migrations/tenant/meta/0010_snapshot.json +2942 -0
  122. package/apps/runtime/dist/db/migrations/tenant/meta/0011_snapshot.json +2956 -0
  123. package/apps/runtime/dist/db/migrations/tenant/meta/0012_snapshot.json +3132 -0
  124. package/apps/runtime/dist/db/migrations/tenant/meta/0013_snapshot.json +3139 -0
  125. package/apps/runtime/dist/db/migrations/tenant/meta/0014_snapshot.json +3154 -0
  126. package/apps/runtime/dist/db/migrations/tenant/meta/0015_snapshot.json +3243 -0
  127. package/apps/runtime/dist/db/migrations/tenant/meta/0016_snapshot.json +3326 -0
  128. package/apps/runtime/dist/db/migrations/tenant/meta/_journal.json +125 -0
  129. package/apps/runtime/dist/db/schema.js +602 -0
  130. package/apps/runtime/dist/debug.js +196 -0
  131. package/apps/runtime/dist/docs/dev/index.md +41 -0
  132. package/apps/runtime/dist/docs/dev/meta.json +7 -0
  133. package/apps/runtime/dist/docs/dev/plugins/connections.md +74 -0
  134. package/apps/runtime/dist/docs/dev/plugins/events.md +89 -0
  135. package/apps/runtime/dist/docs/dev/plugins/examples.md +101 -0
  136. package/apps/runtime/dist/docs/dev/plugins/index.md +78 -0
  137. package/apps/runtime/dist/docs/dev/plugins/layout.md +90 -0
  138. package/apps/runtime/dist/docs/dev/plugins/meta.json +28 -0
  139. package/apps/runtime/dist/docs/dev/plugins/quick-start.md +94 -0
  140. package/apps/runtime/dist/docs/dev/plugins/reference.md +348 -0
  141. package/apps/runtime/dist/docs/dev/plugins/reloading.md +76 -0
  142. package/apps/runtime/dist/docs/dev/plugins/routes.md +185 -0
  143. package/apps/runtime/dist/docs/dev/plugins/runners.md +230 -0
  144. package/apps/runtime/dist/docs/dev/plugins/server.md +281 -0
  145. package/apps/runtime/dist/docs/dev/plugins/shipping.md +79 -0
  146. package/apps/runtime/dist/docs/dev/plugins/space.md +297 -0
  147. package/apps/runtime/dist/docs/dev/plugins/starters.md +70 -0
  148. package/apps/runtime/dist/docs/dev/plugins/studio.md +363 -0
  149. package/apps/runtime/dist/docs/dev/plugins/styling.md +129 -0
  150. package/apps/runtime/dist/docs/dev/plugins/tables.md +104 -0
  151. package/apps/runtime/dist/docs/dev/plugins/tools.md +139 -0
  152. package/apps/runtime/dist/docs/dev/wizard-format.md +125 -0
  153. package/apps/runtime/dist/docs/meta.json +3 -0
  154. package/apps/runtime/dist/docs/user/ai-apps.md +112 -0
  155. package/apps/runtime/dist/docs/user/assistant.md +77 -0
  156. package/apps/runtime/dist/docs/user/build-a-wizard.md +116 -0
  157. package/apps/runtime/dist/docs/user/command-line.md +83 -0
  158. package/apps/runtime/dist/docs/user/connectors.md +90 -0
  159. package/apps/runtime/dist/docs/user/create-account.md +52 -0
  160. package/apps/runtime/dist/docs/user/data.md +66 -0
  161. package/apps/runtime/dist/docs/user/first-start.md +60 -0
  162. package/apps/runtime/dist/docs/user/index.md +49 -0
  163. package/apps/runtime/dist/docs/user/install.md +123 -0
  164. package/apps/runtime/dist/docs/user/local-only.md +42 -0
  165. package/apps/runtime/dist/docs/user/meta.json +32 -0
  166. package/apps/runtime/dist/docs/user/models.md +156 -0
  167. package/apps/runtime/dist/docs/user/plugins.md +71 -0
  168. package/apps/runtime/dist/docs/user/run.md +98 -0
  169. package/apps/runtime/dist/docs/user/server.md +52 -0
  170. package/apps/runtime/dist/docs/user/space.md +126 -0
  171. package/apps/runtime/dist/docs/user/steps.md +220 -0
  172. package/apps/runtime/dist/docs/user/test-and-share.md +224 -0
  173. package/apps/runtime/dist/docs/user/troubleshooting.md +67 -0
  174. package/apps/runtime/dist/docs/user/wordpress.md +121 -0
  175. package/apps/runtime/dist/documents/parse.js +246 -0
  176. package/apps/runtime/dist/engenty/connections-external/build-connector.js +193 -0
  177. package/apps/runtime/dist/engenty/connections-external/errors.js +11 -0
  178. package/apps/runtime/dist/engenty/connections-external/import-service.js +270 -0
  179. package/apps/runtime/dist/engenty/connections-external/importer/classify.js +34 -0
  180. package/apps/runtime/dist/engenty/connections-external/importer/map-auth.js +185 -0
  181. package/apps/runtime/dist/engenty/connections-external/importer/normalize-mcp.js +63 -0
  182. package/apps/runtime/dist/engenty/connections-external/importer/normalize-openapi.js +130 -0
  183. package/apps/runtime/dist/engenty/connections-external/invoke/http-invoker.js +143 -0
  184. package/apps/runtime/dist/engenty/connections-external/invoke/mcp-client.js +143 -0
  185. package/apps/runtime/dist/engenty/connections-external/net/guarded-fetch.js +119 -0
  186. package/apps/runtime/dist/engenty/connections-external/oauth-dcr.js +88 -0
  187. package/apps/runtime/dist/engenty/connections-external/registry-client.js +336 -0
  188. package/apps/runtime/dist/engenty/connections-external/registry-source.js +82 -0
  189. package/apps/runtime/dist/engenty/connections-external/types.js +7 -0
  190. package/apps/runtime/dist/engenty/connections-github/connector.js +209 -0
  191. package/apps/runtime/dist/engenty/connections-google/connectors/calendar.js +381 -0
  192. package/apps/runtime/dist/engenty/connections-google/connectors/contacts.js +94 -0
  193. package/apps/runtime/dist/engenty/connections-google/connectors/drive.js +290 -0
  194. package/apps/runtime/dist/engenty/connections-google/connectors/gmail.js +567 -0
  195. package/apps/runtime/dist/engenty/connections-google/definitions.js +11 -0
  196. package/apps/runtime/dist/engenty/connections-google/shared.js +73 -0
  197. package/apps/runtime/dist/engenty/connections-hubspot/connector.js +140 -0
  198. package/apps/runtime/dist/engenty/connections-microsoft/action.js +17 -0
  199. package/apps/runtime/dist/engenty/connections-microsoft/graph.js +114 -0
  200. package/apps/runtime/dist/engenty/connections-microsoft/onedrive.js +286 -0
  201. package/apps/runtime/dist/engenty/connections-microsoft/outlook.js +492 -0
  202. package/apps/runtime/dist/engenty/connections-s3/s3.js +328 -0
  203. package/apps/runtime/dist/engenty/connections-sdk/files-capability.js +86 -0
  204. package/apps/runtime/dist/engenty/connections-sdk/oauth2.js +150 -0
  205. package/apps/runtime/dist/engenty/connections-sdk/registry.js +89 -0
  206. package/apps/runtime/dist/engenty/connections-sdk/storage-capability.js +84 -0
  207. package/apps/runtime/dist/engenty/connections-sdk/types.js +30 -0
  208. package/apps/runtime/dist/engenty/connections-slack/connector.js +360 -0
  209. package/apps/runtime/dist/engenty/csv-import/csv-matrix.js +178 -0
  210. package/apps/runtime/dist/engenty/csv-import/import-sources.js +87 -0
  211. package/apps/runtime/dist/engenty/csv-import/parse-csv.js +129 -0
  212. package/apps/runtime/dist/engenty/csv-import/serialize-csv.js +20 -0
  213. package/apps/runtime/dist/engenty/csv-import/types.js +1 -0
  214. package/apps/runtime/dist/engenty/csv-import/xlsx-workbook.js +159 -0
  215. package/apps/runtime/dist/engenty/doc-converter/interface.js +9 -0
  216. package/apps/runtime/dist/engenty/doc-converter/page-break.js +92 -0
  217. package/apps/runtime/dist/engenty/doc-converter/providers/local/index.js +72 -0
  218. package/apps/runtime/dist/engenty/document-scanner/schemas/classifier.js +30 -0
  219. package/apps/runtime/dist/engenty/document-scanner/schemas/index.js +4 -0
  220. package/apps/runtime/dist/engenty/document-scanner/schemas/invoice.js +73 -0
  221. package/apps/runtime/dist/engenty/document-scanner/schemas/receipt.js +63 -0
  222. package/apps/runtime/dist/engenty/document-scanner/schemas/shared.js +40 -0
  223. package/apps/runtime/dist/engenty/search-index/chunks.js +164 -0
  224. package/apps/runtime/dist/engenty/search-index/contracts.js +9 -0
  225. package/apps/runtime/dist/engenty/shims/connections-sdk.js +39 -0
  226. package/apps/runtime/dist/engenty/shims/plugin-sdk.js +1 -0
  227. package/apps/runtime/dist/engenty/shims/web-ingest.js +19 -0
  228. package/apps/runtime/dist/engenty/web-ingest/ssrf.js +277 -0
  229. package/apps/runtime/dist/engine/asks.js +82 -0
  230. package/apps/runtime/dist/engine/decide.js +82 -0
  231. package/apps/runtime/dist/engine/device.js +194 -0
  232. package/apps/runtime/dist/engine/events.js +128 -0
  233. package/apps/runtime/dist/engine/input.js +208 -0
  234. package/apps/runtime/dist/engine/owner.js +32 -0
  235. package/apps/runtime/dist/engine/prepare.js +90 -0
  236. package/apps/runtime/dist/engine/push.js +58 -0
  237. package/apps/runtime/dist/engine/requirements.js +355 -0
  238. package/apps/runtime/dist/engine/resources.js +198 -0
  239. package/apps/runtime/dist/engine/runner.js +970 -0
  240. package/apps/runtime/dist/engine/steps.js +1000 -0
  241. package/apps/runtime/dist/engine/surface.js +91 -0
  242. package/apps/runtime/dist/engine/template.js +240 -0
  243. package/apps/runtime/dist/engine/types.js +4 -0
  244. package/apps/runtime/dist/env.js +295 -0
  245. package/apps/runtime/dist/features.js +123 -0
  246. package/apps/runtime/dist/files/blobs.js +22 -0
  247. package/apps/runtime/dist/files/objects.js +86 -0
  248. package/apps/runtime/dist/files/storage.js +120 -0
  249. package/apps/runtime/dist/files/web-images.js +101 -0
  250. package/apps/runtime/dist/film/project.js +257 -0
  251. package/apps/runtime/dist/film/skills.js +91 -0
  252. package/apps/runtime/dist/film/sounds.js +122 -0
  253. package/apps/runtime/dist/film/step.js +289 -0
  254. package/apps/runtime/dist/film/tools.js +99 -0
  255. package/apps/runtime/dist/geocode.js +58 -0
  256. package/apps/runtime/dist/harness/antigravity.js +129 -0
  257. package/apps/runtime/dist/harness/apple.js +270 -0
  258. package/apps/runtime/dist/harness/claude.js +147 -0
  259. package/apps/runtime/dist/harness/codex.js +229 -0
  260. package/apps/runtime/dist/harness/cursor.js +93 -0
  261. package/apps/runtime/dist/harness/env.js +124 -0
  262. package/apps/runtime/dist/harness/index.js +95 -0
  263. package/apps/runtime/dist/harness/model.js +279 -0
  264. package/apps/runtime/dist/harness/prompt.js +121 -0
  265. package/apps/runtime/dist/harness/terminal.js +194 -0
  266. package/apps/runtime/dist/harness/types.js +7 -0
  267. package/apps/runtime/dist/index.js +113 -0
  268. package/apps/runtime/dist/limits.js +81 -0
  269. package/apps/runtime/dist/link-preview.js +60 -0
  270. package/apps/runtime/dist/log.js +106 -0
  271. package/apps/runtime/dist/manage.js +249 -0
  272. package/apps/runtime/dist/mcp/auth.js +161 -0
  273. package/apps/runtime/dist/mcp/bridge.js +59 -0
  274. package/apps/runtime/dist/mcp/flow-app.js +97 -0
  275. package/apps/runtime/dist/mcp/handler.js +54 -0
  276. package/apps/runtime/dist/mcp/scopes.js +14 -0
  277. package/apps/runtime/dist/mcp/seen.js +65 -0
  278. package/apps/runtime/dist/mcp/tools.js +572 -0
  279. package/apps/runtime/dist/media/conversation.js +167 -0
  280. package/apps/runtime/dist/media/ffmpeg.js +121 -0
  281. package/apps/runtime/dist/media/generate.js +120 -0
  282. package/apps/runtime/dist/media/marking.js +121 -0
  283. package/apps/runtime/dist/media/transcribe.js +198 -0
  284. package/apps/runtime/dist/model-errors.js +42 -0
  285. package/apps/runtime/dist/models.js +1164 -0
  286. package/apps/runtime/dist/plugin.js +61 -0
  287. package/apps/runtime/dist/plugins/channels.js +78 -0
  288. package/apps/runtime/dist/plugins/claims.js +56 -0
  289. package/apps/runtime/dist/plugins/discovery.js +155 -0
  290. package/apps/runtime/dist/plugins/events.js +63 -0
  291. package/apps/runtime/dist/plugins/jobs.js +64 -0
  292. package/apps/runtime/dist/plugins/loader.js +508 -0
  293. package/apps/runtime/dist/plugins/migrations.js +69 -0
  294. package/apps/runtime/dist/plugins/pro-keys.js +34 -0
  295. package/apps/runtime/dist/plugins/pro-state.js +83 -0
  296. package/apps/runtime/dist/plugins/pro.js +310 -0
  297. package/apps/runtime/dist/plugins/public.js +44 -0
  298. package/apps/runtime/dist/plugins/registry.js +122 -0
  299. package/apps/runtime/dist/plugins/runs.js +210 -0
  300. package/apps/runtime/dist/render/browser-path.js +54 -0
  301. package/apps/runtime/dist/render/chromium.js +98 -0
  302. package/apps/runtime/dist/render/convert.js +158 -0
  303. package/apps/runtime/dist/render/downloads.js +299 -0
  304. package/apps/runtime/dist/render/guard.js +25 -0
  305. package/apps/runtime/dist/render/shaped.js +137 -0
  306. package/apps/runtime/dist/routes/api.js +440 -0
  307. package/apps/runtime/dist/routes/debug.js +42 -0
  308. package/apps/runtime/dist/routes/delivery.js +90 -0
  309. package/apps/runtime/dist/routes/internal.js +81 -0
  310. package/apps/runtime/dist/routes/lang.js +25 -0
  311. package/apps/runtime/dist/routes/marketplace.js +43 -0
  312. package/apps/runtime/dist/routes/plugin-public.js +113 -0
  313. package/apps/runtime/dist/routes/plugins.js +212 -0
  314. package/apps/runtime/dist/routes/runs.js +1422 -0
  315. package/apps/runtime/dist/routes/studio.js +1629 -0
  316. package/apps/runtime/dist/routes/wizard-stream.js +30 -0
  317. package/apps/runtime/dist/running.js +39 -0
  318. package/apps/runtime/dist/sandbox/docker.js +75 -0
  319. package/apps/runtime/dist/sandbox/index.js +23 -0
  320. package/apps/runtime/dist/sandbox/types.js +1 -0
  321. package/apps/runtime/dist/secrets/crypto.js +28 -0
  322. package/apps/runtime/dist/secrets/signing.js +52 -0
  323. package/apps/runtime/dist/secrets/vault.js +59 -0
  324. package/apps/runtime/dist/services/access.js +88 -0
  325. package/apps/runtime/dist/services/api.js +248 -0
  326. package/apps/runtime/dist/services/architect.js +95 -0
  327. package/apps/runtime/dist/services/assistant-chats.js +311 -0
  328. package/apps/runtime/dist/services/brand.js +85 -0
  329. package/apps/runtime/dist/services/cloud.js +456 -0
  330. package/apps/runtime/dist/services/draft-events.js +27 -0
  331. package/apps/runtime/dist/services/engenty-shapes.js +71 -0
  332. package/apps/runtime/dist/services/errors.js +29 -0
  333. package/apps/runtime/dist/services/files.js +178 -0
  334. package/apps/runtime/dist/services/knowledge-model.js +559 -0
  335. package/apps/runtime/dist/services/knowledge.js +721 -0
  336. package/apps/runtime/dist/services/links.js +16 -0
  337. package/apps/runtime/dist/services/marketplace.js +492 -0
  338. package/apps/runtime/dist/services/onboarding.js +152 -0
  339. package/apps/runtime/dist/services/package-file.js +82 -0
  340. package/apps/runtime/dist/services/package.js +170 -0
  341. package/apps/runtime/dist/services/profile.js +51 -0
  342. package/apps/runtime/dist/services/project-files.js +439 -0
  343. package/apps/runtime/dist/services/project-index.js +707 -0
  344. package/apps/runtime/dist/services/projects.js +387 -0
  345. package/apps/runtime/dist/services/relevance.js +58 -0
  346. package/apps/runtime/dist/services/runners.js +178 -0
  347. package/apps/runtime/dist/services/runs.js +524 -0
  348. package/apps/runtime/dist/services/shares.js +130 -0
  349. package/apps/runtime/dist/services/site.js +270 -0
  350. package/apps/runtime/dist/services/space-categories.js +861 -0
  351. package/apps/runtime/dist/services/space-data.js +792 -0
  352. package/apps/runtime/dist/services/space-origin.js +207 -0
  353. package/apps/runtime/dist/services/spaces.js +656 -0
  354. package/apps/runtime/dist/services/translations.js +306 -0
  355. package/apps/runtime/dist/services/widgets.js +34 -0
  356. package/apps/runtime/dist/services/wizard-icon.js +157 -0
  357. package/apps/runtime/dist/services/wizards.js +420 -0
  358. package/apps/runtime/dist/settings.js +16 -0
  359. package/apps/runtime/dist/store/errors.js +4 -0
  360. package/apps/runtime/dist/store/index.js +299 -0
  361. package/apps/runtime/dist/store/shared-lists.js +123 -0
  362. package/apps/runtime/dist/tenants/control.js +238 -0
  363. package/apps/runtime/dist/tenants/tenant.js +26 -0
  364. package/apps/runtime/dist/texts.js +207 -0
  365. package/apps/runtime/dist/tools/browser.js +703 -0
  366. package/apps/runtime/dist/tools/connector.js +204 -0
  367. package/apps/runtime/dist/tools/index.js +291 -0
  368. package/apps/runtime/dist/tools/mail.js +104 -0
  369. package/apps/runtime/dist/tools/net-guard.js +170 -0
  370. package/apps/runtime/dist/tools/pages.js +81 -0
  371. package/apps/runtime/dist/tools/plugin.js +180 -0
  372. package/apps/runtime/dist/tools/project.js +154 -0
  373. package/apps/runtime/dist/tools/shared.js +69 -0
  374. package/apps/runtime/dist/tools/store.js +238 -0
  375. package/apps/runtime/dist/update.js +113 -0
  376. package/apps/runtime/dist/widgets/bundle.js +99 -0
  377. package/apps/runtime/dist/widgets/render.js +329 -0
  378. package/apps/runtime/dist/widgets/runtime.js +108 -0
  379. package/apps/runtime/dist/widgets/script.js +30 -0
  380. package/apps/runtime/dist/widgets/step.js +223 -0
  381. package/apps/web/dist/ai-labels/ai-black.svg +20 -0
  382. package/apps/web/dist/ai-labels/ai-generated-black.svg +31 -0
  383. package/apps/web/dist/ai-labels/ai-generated-white.svg +32 -0
  384. package/apps/web/dist/ai-labels/ai-modified-black.svg +30 -0
  385. package/apps/web/dist/ai-labels/ai-modified-white.svg +31 -0
  386. package/apps/web/dist/ai-labels/ai-white.svg +21 -0
  387. package/apps/web/dist/assets/AboutDialog-D4mvc-zu.js +1 -0
  388. package/apps/web/dist/assets/ChangelogDialog-DLqpJsF6.js +1 -0
  389. package/apps/web/dist/assets/ChatView-3laypRcE.js +10 -0
  390. package/apps/web/dist/assets/EditorPage-BalA5U2Y.js +3 -0
  391. package/apps/web/dist/assets/FlowPreview-CusP7ci9.js +1 -0
  392. package/apps/web/dist/assets/Harness-BrP-ENHg.css +1 -0
  393. package/apps/web/dist/assets/Harness-iYLtOLaK.js +16 -0
  394. package/apps/web/dist/assets/NewWizardChannels-CbwJ9A56.js +1 -0
  395. package/apps/web/dist/assets/NewWizardPage-BOBYiB9i.js +7 -0
  396. package/apps/web/dist/assets/OnboardingPage-CUwCiVIr.js +1 -0
  397. package/apps/web/dist/assets/ProjectPage-Bb16MdYG.js +1 -0
  398. package/apps/web/dist/assets/PublicRunner-BCt7Q6C-.js +1 -0
  399. package/apps/web/dist/assets/ReadOnly-kIHX2TEy.js +1 -0
  400. package/apps/web/dist/assets/RunDrawer-hZ9oeSXu.js +4 -0
  401. package/apps/web/dist/assets/RunnerView-DUS9fPmx.js +1 -0
  402. package/apps/web/dist/assets/SettingsPage-BzwR50fi.js +1 -0
  403. package/apps/web/dist/assets/SetupPage-gAp7rPxp.js +1 -0
  404. package/apps/web/dist/assets/SharePage-DqZWHva_.js +1 -0
  405. package/apps/web/dist/assets/changelog-DugmCNSf.js +1 -0
  406. package/apps/web/dist/assets/engenty-eXZ-EAwd.js +1 -0
  407. package/apps/web/dist/assets/esm-DXeMu8Lb.js +7 -0
  408. package/apps/web/dist/assets/fluffy-engenty-ClRou7yu.js +456 -0
  409. package/apps/web/dist/assets/index-AfUa8xKD.css +1 -0
  410. package/apps/web/dist/assets/index-C5Sm7tTR.js +14 -0
  411. package/apps/web/dist/assets/jsx-runtime-BNakU3Ej.js +1 -0
  412. package/apps/web/dist/assets/lock-R_CfU0Xo.js +1 -0
  413. package/apps/web/dist/assets/oss-credits-cZ9NUaLZ.js +1 -0
  414. package/apps/web/dist/assets/pdfmake-Cx9scTbD.js +228 -0
  415. package/apps/web/dist/assets/phone-CgrIS4_-.js +1 -0
  416. package/apps/web/dist/assets/preload-helper-CNEI7N0N.js +1 -0
  417. package/apps/web/dist/assets/qr-scanner-worker.min-CJaXo3yu.js +98 -0
  418. package/apps/web/dist/assets/qr-scanner.min-C_UI0gH-.js +1 -0
  419. package/apps/web/dist/assets/rolldown-runtime-hePW80VL.js +1 -0
  420. package/apps/web/dist/assets/settings-menu-2IMOOlLl.js +1 -0
  421. package/apps/web/dist/assets/ui-dzGvc3xk.js +137 -0
  422. package/apps/web/dist/assets/upload-BSuTilFF.js +1 -0
  423. package/apps/web/dist/assets/vfs_fonts-DllDSYt1.js +1 -0
  424. package/apps/web/dist/embed.js +266 -0
  425. package/apps/web/dist/favicon.svg +1 -0
  426. package/apps/web/dist/icons/apple-touch-icon.png +0 -0
  427. package/apps/web/dist/icons/icon-192.png +0 -0
  428. package/apps/web/dist/icons/icon-512.png +0 -0
  429. package/apps/web/dist/icons/icon-maskable-512.png +0 -0
  430. package/apps/web/dist/index.html +48 -0
  431. package/apps/web/dist/install.sh +577 -0
  432. package/apps/web/dist/manifest.webmanifest +21 -0
  433. package/apps/web/dist/mcp/flow.html +980 -0
  434. package/apps/web/dist/sw.js +15 -0
  435. package/bin/wizards.mjs +288 -0
  436. package/modules/README.md +15 -0
  437. package/node_modules/@engenty/wizards/dist/plugin/index.d.ts +1150 -0
  438. package/node_modules/@engenty/wizards/dist/plugin/index.js +4 -0
  439. package/node_modules/@engenty/wizards/dist/plugin/studio.d.ts +322 -0
  440. package/node_modules/@engenty/wizards/dist/plugin/studio.js +4 -0
  441. package/node_modules/@engenty/wizards/dist/plugin/thread.d.ts +174 -0
  442. package/node_modules/@engenty/wizards/dist/plugin/thread.js +821 -0
  443. package/node_modules/@engenty/wizards/package.json +11 -0
  444. package/node_modules/@engenty-wizards/shared/dist/assistant.d.ts +174 -0
  445. package/node_modules/@engenty-wizards/shared/dist/assistant.js +65 -0
  446. package/node_modules/@engenty-wizards/shared/dist/changes.d.ts +22 -0
  447. package/node_modules/@engenty-wizards/shared/dist/changes.js +61 -0
  448. package/node_modules/@engenty-wizards/shared/dist/connectors.d.ts +77 -0
  449. package/node_modules/@engenty-wizards/shared/dist/connectors.js +2 -0
  450. package/node_modules/@engenty-wizards/shared/dist/decision.d.ts +76 -0
  451. package/node_modules/@engenty-wizards/shared/dist/decision.js +147 -0
  452. package/node_modules/@engenty-wizards/shared/dist/definition.d.ts +2922 -0
  453. package/node_modules/@engenty-wizards/shared/dist/definition.js +1920 -0
  454. package/node_modules/@engenty-wizards/shared/dist/engenty/data-tables/columns-format.d.ts +5 -0
  455. package/node_modules/@engenty-wizards/shared/dist/engenty/data-tables/columns-format.js +132 -0
  456. package/node_modules/@engenty-wizards/shared/dist/engenty/data-tables/columns-value.d.ts +11 -0
  457. package/node_modules/@engenty-wizards/shared/dist/engenty/data-tables/columns-value.js +209 -0
  458. package/node_modules/@engenty-wizards/shared/dist/engenty/data-tables/columns.d.ts +532 -0
  459. package/node_modules/@engenty-wizards/shared/dist/engenty/data-tables/columns.js +217 -0
  460. package/node_modules/@engenty-wizards/shared/dist/engenty/data-tables/index.d.ts +3 -0
  461. package/node_modules/@engenty-wizards/shared/dist/engenty/data-tables/index.js +3 -0
  462. package/node_modules/@engenty-wizards/shared/dist/engenty/search-index/catalog-lexical.d.ts +14 -0
  463. package/node_modules/@engenty-wizards/shared/dist/engenty/search-index/catalog-lexical.js +166 -0
  464. package/node_modules/@engenty-wizards/shared/dist/engenty/search-index/catalog-rank.d.ts +33 -0
  465. package/node_modules/@engenty-wizards/shared/dist/engenty/search-index/catalog-rank.js +99 -0
  466. package/node_modules/@engenty-wizards/shared/dist/feature-flags.d.ts +78 -0
  467. package/node_modules/@engenty-wizards/shared/dist/feature-flags.js +70 -0
  468. package/node_modules/@engenty-wizards/shared/dist/features.d.ts +41 -0
  469. package/node_modules/@engenty-wizards/shared/dist/features.js +89 -0
  470. package/node_modules/@engenty-wizards/shared/dist/fit.d.ts +71 -0
  471. package/node_modules/@engenty-wizards/shared/dist/fit.js +382 -0
  472. package/node_modules/@engenty-wizards/shared/dist/json-schema.d.ts +14 -0
  473. package/node_modules/@engenty-wizards/shared/dist/json-schema.js +66 -0
  474. package/node_modules/@engenty-wizards/shared/dist/knowledge.d.ts +199 -0
  475. package/node_modules/@engenty-wizards/shared/dist/knowledge.js +68 -0
  476. package/node_modules/@engenty-wizards/shared/dist/marketplace-entry.d.ts +35 -0
  477. package/node_modules/@engenty-wizards/shared/dist/marketplace-entry.js +107 -0
  478. package/node_modules/@engenty-wizards/shared/dist/marketplace-search.d.ts +20 -0
  479. package/node_modules/@engenty-wizards/shared/dist/marketplace-search.js +136 -0
  480. package/node_modules/@engenty-wizards/shared/dist/marketplace.d.ts +227 -0
  481. package/node_modules/@engenty-wizards/shared/dist/marketplace.js +354 -0
  482. package/node_modules/@engenty-wizards/shared/dist/merge.d.ts +7 -0
  483. package/node_modules/@engenty-wizards/shared/dist/merge.js +40 -0
  484. package/node_modules/@engenty-wizards/shared/dist/numbers.d.ts +24 -0
  485. package/node_modules/@engenty-wizards/shared/dist/numbers.js +54 -0
  486. package/node_modules/@engenty-wizards/shared/dist/projects.d.ts +224 -0
  487. package/node_modules/@engenty-wizards/shared/dist/projects.js +319 -0
  488. package/node_modules/@engenty-wizards/shared/dist/providers.d.ts +101 -0
  489. package/node_modules/@engenty-wizards/shared/dist/providers.js +390 -0
  490. package/node_modules/@engenty-wizards/shared/dist/run.d.ts +680 -0
  491. package/node_modules/@engenty-wizards/shared/dist/run.js +620 -0
  492. package/node_modules/@engenty-wizards/shared/dist/runner-texts.d.ts +546 -0
  493. package/node_modules/@engenty-wizards/shared/dist/runner-texts.js +523 -0
  494. package/node_modules/@engenty-wizards/shared/dist/runners.d.ts +93 -0
  495. package/node_modules/@engenty-wizards/shared/dist/runners.js +146 -0
  496. package/node_modules/@engenty-wizards/shared/dist/shape.d.ts +102 -0
  497. package/node_modules/@engenty-wizards/shared/dist/shape.js +318 -0
  498. package/node_modules/@engenty-wizards/shared/dist/space-data.d.ts +89 -0
  499. package/node_modules/@engenty-wizards/shared/dist/space-data.js +47 -0
  500. package/node_modules/@engenty-wizards/shared/dist/store.d.ts +117 -0
  501. package/node_modules/@engenty-wizards/shared/dist/store.js +81 -0
  502. package/node_modules/@engenty-wizards/shared/dist/surface.d.ts +115 -0
  503. package/node_modules/@engenty-wizards/shared/dist/surface.js +442 -0
  504. package/node_modules/@engenty-wizards/shared/dist/texts.d.ts +45 -0
  505. package/node_modules/@engenty-wizards/shared/dist/texts.js +54 -0
  506. package/node_modules/@engenty-wizards/shared/dist/translation.d.ts +23 -0
  507. package/node_modules/@engenty-wizards/shared/dist/translation.js +154 -0
  508. package/node_modules/@engenty-wizards/shared/dist/wizard-package.d.ts +48 -0
  509. package/node_modules/@engenty-wizards/shared/dist/wizard-package.js +49 -0
  510. package/node_modules/@engenty-wizards/shared/dist/workspace.d.ts +16 -0
  511. package/node_modules/@engenty-wizards/shared/dist/workspace.js +51 -0
  512. package/node_modules/@engenty-wizards/shared/package.json +10 -0
  513. package/package.json +77 -4
  514. package/plugin/.claude-plugin/plugin.json +9 -0
  515. package/plugin/.mcp.json +8 -0
  516. package/plugin/commands/wizard.md +8 -0
  517. package/plugin/skills/build-wizard/SKILL.md +27 -0
  518. package/plugin/skills/use-wizard/SKILL.md +18 -0
@@ -0,0 +1,90 @@
1
+ ---
2
+ title: Connectors
3
+ description: Services a wizard works in for the person who runs it – built in, from the registry or over MCP.
4
+ version: 0.5.0
5
+ ---
6
+
7
+ Settings → Connectors lists the services the space’s wizards can work in. A wizard uses a
8
+ connector with the account of the person who runs it: they connect their account during the run,
9
+ on a page that asks for it. Each space has its own connectors. In a team on engenty.ai, the owner
10
+ and the admins add and remove them. In the cloud, a space you publish from your computer shows
11
+ its connectors without letting you change them: you change them on your computer.
12
+
13
+ ## Built in
14
+
15
+ | Service | The person signs in with |
16
+ |---|---|
17
+ | Gmail, Google Drive, Google Calendar, Google Contacts | Google (OAuth) |
18
+ | Outlook, OneDrive | Microsoft (OAuth) |
19
+ | Slack | Slack (OAuth) |
20
+ | GitHub | GitHub (OAuth) |
21
+ | HubSpot | A token they enter |
22
+ | S3 | Keys they enter |
23
+
24
+ The OAuth services need an OAuth client of your own, which you enter in the settings file of
25
+ engenty wizards. A built-in connector shows up in the list once it can be connected, so a service
26
+ without its client doesn’t appear. Google is the exception on your computer: without a Google
27
+ client of your own, Gmail, Drive, Calendar and Contacts connect through your engenty account,
28
+ which holds the client. Connecting then asks you to sign in to the account first (Settings →
29
+ Account).
30
+
31
+ | Service | Settings |
32
+ |---|---|
33
+ | Google | `GOOGLE_OAUTH_CLIENT_ID`, `GOOGLE_OAUTH_CLIENT_SECRET` |
34
+ | Microsoft | `MICROSOFT_OAUTH_CLIENT_ID`, `MICROSOFT_OAUTH_CLIENT_SECRET` |
35
+ | Slack | `SLACK_OAUTH_CLIENT_ID`, `SLACK_OAUTH_CLIENT_SECRET` |
36
+ | GitHub | `GITHUB_OAUTH_CLIENT_ID`, `GITHUB_OAUTH_CLIENT_SECRET` |
37
+
38
+ - Give each client the redirect address `<your address>/api/connect/callback`.
39
+ `CONNECT_REDIRECT_URL` sets a different one.
40
+ - For Google, enable the APIs you use and add their scopes to the consent screen.
41
+ - A connection asks only for what the wizard’s actions need.
42
+
43
+ You find the settings file under [Command line](./command-line.md#settings).
44
+
45
+ ## From the registry
46
+
47
+ Any other service comes from the [integrations.sh](https://integrations.sh) registry:
48
+
49
+ 1. Search for the service, for example Notion or Stripe.
50
+ 2. “Import” adds it from its API description or its MCP server.
51
+ 3. Its actions appear, marked as “reads”, “changes” or “deletes”. Some services list them only
52
+ once an account is connected. “Reload actions” asks the service again.
53
+
54
+ If a service needs an OAuth client of your own, it says so. Remove it and import it again with
55
+ “Your own OAuth client”.
56
+
57
+ The editor’s chat does the same while it builds a wizard: ask it to work with a service, and it
58
+ finds and imports the connector. An [AI app](./ai-apps.md) connected to engenty wizards can do
59
+ this too.
60
+
61
+ ## What a wizard may do
62
+
63
+ A wizard names the actions it uses. Without a list, it uses only the actions that read. During a
64
+ run:
65
+
66
+ | The action | What happens |
67
+ |---|---|
68
+ | Reads | It runs without asking, unless the wizard says to ask |
69
+ | Changes something | The person allows each call, or chooses “Allow for the rest of this run”. A wizard can let it run without asking |
70
+ | Deletes | The person allows it like a change. A wizard can never let it run without asking |
71
+
72
+ ## The person’s mailbox
73
+
74
+ A wizard can ask for the person’s mailbox and read it: search emails, read them and keep
75
+ attachments. It never writes. The person chooses how to connect:
76
+
77
+ | Way | What engenty wizards needs |
78
+ |---|---|
79
+ | Any mailbox over IMAP | Nothing |
80
+ | “Gmail” button | The Google client, with the Gmail API enabled and the scope `gmail.readonly`. On your computer without one, your engenty account |
81
+ | “Outlook” button | The Microsoft client, with the delegated permission `Mail.Read` |
82
+
83
+ ## Connected systems
84
+
85
+ This section also holds “Connected systems”: MCP servers of your own, each with a name, its MCP
86
+ URL and, if the server wants one, an authorization header. AI steps read from and write to these
87
+ systems only where you allow the server on the step.
88
+
89
+ This is the other direction of [AI apps](./ai-apps.md): here engenty calls other servers, there
90
+ your AI app calls engenty.
@@ -0,0 +1,52 @@
1
+ ---
2
+ title: Create an account
3
+ description: Your team, its space and your wizards live in your account at engenty.ai. Sign up with an invitation code, answer four questions, build.
4
+ version: 0.5.0
5
+ ---
6
+
7
+ engenty wizards is in a closed beta, so a new account needs an invitation code. “Get started” on
8
+ [engenty.ai](https://engenty.ai) takes your email and puts you on the list. The code comes by
9
+ email as soon as a seat is free. Once you have a code, the same button opens the sign-up.
10
+
11
+ ## Sign up
12
+
13
+ 1. Enter the code at [account.engenty.ai/sign-up](https://account.engenty.ai/sign-up). The link
14
+ in the invitation email has it filled in.
15
+ 2. Sign in with Google, GitHub or a link by email. There is no password.
16
+ 3. The studio opens at [engenty.ai/studio](https://engenty.ai/studio).
17
+
18
+ Your account is a **team**: it holds your credits, your spaces and, on the Team plan, your
19
+ colleagues. It starts with credits, and some of them expire on a set date. The account pages at
20
+ [account.engenty.ai](https://account.engenty.ai) show them.
21
+
22
+ ## The first visit
23
+
24
+ The studio asks four things, one per page. You can skip each one after the first and change it
25
+ later.
26
+
27
+ | Page | Asks | Goes to |
28
+ |---|---|---|
29
+ | Who you are | “What’s your team called?”: your company, your club or just your name | The team’s name at account.engenty.ai |
30
+ | About you & your brand | “Where can the wizards read about you?”: your website. engenty reads your name, what you do, your logo and colours from it, or you write a line about yourself | [Space → Info & brand](./space.md#info--brand) |
31
+ | Knowledge | “What should the wizards know?”: documents the wizards may look things up in, such as price lists, your terms or an FAQ | [Space → Knowledge](./space.md#knowledge) |
32
+ | Your space | Nothing. It explains the space that holds all of this, “My wizards” (“Meine Wizards” in German) | – |
33
+
34
+ Then “Build your first wizard” opens the page for a new wizard: you describe a task in a
35
+ sentence, or start from a template. See [Build a wizard](./build-a-wizard.md).
36
+
37
+ ## What the cloud does
38
+
39
+ - Wizards you build here run behind a link that works day and night, on the team’s credits.
40
+ - Share links, the tag for your website, QR codes and the channels of [Test and share](./test-and-share.md) work as they do on your computer.
41
+ - The team decides what the wizards run on: see [Models and account](./models.md).
42
+
43
+ ## Also on your computer
44
+
45
+ The same account works on your own computer: you [install](./install.md) engenty wizards there
46
+ and sign in during the setup. It then runs on your Claude, ChatGPT, Google AI or Cursor
47
+ subscription, reads your files and browses the web for you. What you publish there runs in the
48
+ cloud too, behind the same links. In the cloud studio that space is marked “Edited on your
49
+ computer.” and you only look at it there: you change it on your computer.
50
+
51
+ On the studio’s start page, the “Also on your computer” card has “Email me the command”, which
52
+ sends you the install command.
@@ -0,0 +1,66 @@
1
+ ---
2
+ title: Your data
3
+ description: Where wizards, results, files and keys are kept, how to back them up and how to start over.
4
+ version: 0.5.0
5
+ ---
6
+
7
+ ## Where it is
8
+
9
+ Everything engenty wizards keeps on your computer is in one folder:
10
+
11
+ ```bash
12
+ ~/.engenty/wizards/data
13
+ ```
14
+
15
+ | In it | What |
16
+ |---|---|
17
+ | Databases | Your wizards, their versions, runs and results (a run from a website tag also keeps the page it was started on); what wizards keep for people |
18
+ | Files | Uploads, generated media, documents, the files of each wizard |
19
+ | A secret | Signs the studio’s sign-in and its links, and encrypts what is stored encrypted |
20
+
21
+ On a Mac, the API keys you enter in the studio and the sign-in of your account are kept in the
22
+ Keychain (as `engenty-wizards`). On other systems they are stored encrypted in the data folder.
23
+
24
+ ## Back up, move, start over
25
+
26
+ | To | Do |
27
+ |---|---|
28
+ | Back up | Stop engenty wizards (`wizards stop`) and copy the folder |
29
+ | Move to another computer | Install engenty wizards there, stop it and put the folder in place. On a Mac, enter your API keys and sign in to your account again: the Keychain doesn’t move |
30
+ | Start over | Run `wizards uninstall`, choose to delete your data, then install again. On a Mac, the keys in the Keychain stay and are used again. To remove them, delete the `engenty-wizards` entries in Keychain Access |
31
+ | Keep it elsewhere | Set `ENGENTY_HOME` to another folder. engenty wizards then keeps everything in its `wizards` folder there |
32
+
33
+ After an update, engenty wizards brings your data up to date the next time it starts.
34
+
35
+ ## What leaves your computer
36
+
37
+ - **Model calls** go to whatever the models run on: your AI client’s provider, the provider of
38
+ your API key, or your engenty account. With Ollama, or Apple Intelligence on a Mac, they stay
39
+ on your computer.
40
+ - **Steps that use the web** send what they search for, open or call.
41
+ - **Connected services** get what a wizard’s actions send them.
42
+ - **Published wizards**, with an account signed in: when you publish, engenty.ai receives the
43
+ published version and its files, the space’s name, title, “About”, colours, facts and main
44
+ logo, and the space’s own tables and pages ([Test and share](./test-and-share.md#in-the-cloud)).
45
+ Documents, drafts, runs and connected accounts stay on your computer.
46
+ - **Templates** come from the marketplace at engenty.ai. `MARKETPLACE_URL=off` in the settings
47
+ file turns that off.
48
+ - **The update check** asks GitHub for the newest release.
49
+ - **The studio’s typefaces** are loaded by your browser from Google Fonts.
50
+ - **A location** is sent to a geocoder only if you set one up (`GEOCODER_URL`). Without one, it
51
+ stays coordinates.
52
+ - **`wizards report`** sends the status, the model settings (never a key) and log lines to your
53
+ account, and only when you run it.
54
+
55
+ Without an account, your wizards, the space and its files stay on your computer.
56
+
57
+ ## How long things are kept
58
+
59
+ | What | How long |
60
+ |---|---|
61
+ | Your wizards and your test runs | Until you delete them |
62
+ | A real run of a published wizard (over its link or from an AI app), its result and the result’s shared link | 7 days |
63
+ | What a wizard keeps for a person: lists, files, connected accounts, sign-ins | Until they delete it, or 400 days after its last use |
64
+ | The space’s tables and pages, and what wizards keep for every run: shared lists, pages | Until you delete them, or the wizard they belong to |
65
+
66
+ Connected accounts and remembered sign-ins are stored encrypted.
@@ -0,0 +1,60 @@
1
+ ---
2
+ title: First start
3
+ description: Choose how the AI runs on your computer. The studio opens once a test call works.
4
+ version: 0.5.0
5
+ ---
6
+
7
+ The first page of the studio on your computer is the setup, “Choose how the AI runs”. It asks
8
+ one thing: what should engenty wizards run on?
9
+
10
+ ## Your account
11
+
12
+ Your account stands above the choices. If you signed in during the [install](./install.md), it
13
+ shows your name, your team and your credits. If you aren’t signed in yet, “Your engenty account”
14
+ has a “Sign in” button that opens your browser for it. If you set engenty wizards up
15
+ [only for this computer](./local-only.md), the page shows nothing here.
16
+
17
+ ## Choose how the AI runs
18
+
19
+ | Choice | Runs on | Needs |
20
+ |---|---|---|
21
+ | engenty credits | Your account’s credits, as in the cloud | An account signed in. Shown only then |
22
+ | Claude Code | Your Claude subscription | The client installed and signed in |
23
+ | Codex | Your ChatGPT subscription | The client installed and signed in |
24
+ | Antigravity | Your Google AI subscription | The client (`agy`) installed and signed in |
25
+ | Cursor Agent | Your Cursor subscription | The client installed and signed in |
26
+ | Apple Intelligence | The model on this Mac, without an account or the internet | A Mac with Apple silicon on macOS 26 or later, with Apple Intelligence switched on. Shown only on such a Mac |
27
+ | Your own keys | OpenAI, Anthropic, Google or Vercel AI Gateway, or a model on your computer | One API key, or [Ollama](https://ollama.com) running |
28
+
29
+ - **An AI client that is not installed** installs right on the page, in a terminal shown there.
30
+ It takes about a minute.
31
+ - **Signing in** happens in the same terminal, with the client’s own sign-in. Your browser opens
32
+ for it, and the terminal closes once you are signed in.
33
+ - **A client signed in with an API key from your shell** does not run on your subscription.
34
+ Click “Sign in here” on the page to change that.
35
+ - **Apple Intelligence** has nothing to connect: the test runs once it is switched on (System
36
+ Settings → Apple Intelligence & Siri). It handles short texts and decisions on this Mac.
37
+ Research, long documents and code stay with a client you chose before it, or you add another
38
+ option for them later under Settings → Models. See [Apple Intelligence](./models.md#apple-intelligence).
39
+
40
+ ## The test
41
+
42
+ After you connect, one short call checks that the model can be reached. The setup stays until
43
+ that call works. Then “Open the studio” takes you in.
44
+
45
+ With your own keys, each key has its own Test. It checks the key with the provider, stores it in
46
+ this computer’s keychain and sets that provider’s models for what no other key covers yet. One
47
+ key that works is enough. Which model does which job you change later under
48
+ [Settings → Models](./models.md).
49
+
50
+ ## What an AI client does not cover
51
+
52
+ An installed AI client writes and reasons. Codex also makes images on your sign-in; with the
53
+ other clients, images need a key. Video and audio need a key with every client, or the credits
54
+ of an engenty account. A Mac with Apple silicon on macOS 26 can write down voice notes by itself.
55
+ One Vercel AI Gateway key covers text, images, video and web search. You can add it later under
56
+ [Models and account](./models.md).
57
+
58
+ ## Change it later
59
+
60
+ You change it under Settings → Models. See [Models and account](./models.md).
@@ -0,0 +1,49 @@
1
+ ---
2
+ title: User Guide
3
+ description: Install engenty wizards, build a wizard, run and share it.
4
+ version: 0.5.0
5
+ ---
6
+
7
+ engenty wizards turns something you do again and again into a wizard: pages that ask what it
8
+ needs, AI steps that do the work, and a link to share. A post with an image, a research
9
+ briefing, an invoice, a quote, a damage report.
10
+
11
+ ## What you do with it
12
+
13
+ | | |
14
+ |---|---|
15
+ | **Describe it** | You say in plain words what the wizard should do. The assistant builds the flow, and you see it as a diagram and can change any step. |
16
+ | **Let AI steps work** | They research the web, write, draw images, render video, read PDFs, scans and emails, build documents and dashboards, and write into other services. Anything that changes an account asks first. |
17
+ | **Share a link** | Anyone can run the wizard in a browser, on a phone too. Results download as PDF, Word, HTML, Markdown, PNG, MP4, MP3, CSV, Excel or JSON, or go out as a link. |
18
+ | **In the cloud, or on your computer** | You sign up and build in the browser, and links run on your team’s credits. Or you install it on your computer: there it runs on Codex, Claude Code, Antigravity or Cursor Agent with your own subscription, on your own API keys or on a local model, and your files stay with you. |
19
+
20
+ ## Where to start
21
+
22
+ 1. [Create an account](./create-account.md) at engenty.ai, with an invitation code.
23
+ 2. [Build a wizard](./build-a-wizard.md) from a sentence or a template.
24
+ 3. [Test and share](./test-and-share.md) it.
25
+ 4. Also on your computer: [install](./install.md) it there, signed in to the same account, and at the [first start](./first-start.md) choose how the AI runs.
26
+ 5. Use it from your [AI apps](./ai-apps.md): Claude Desktop, Cursor, Codex and others.
27
+
28
+ ## Words used here
29
+
30
+ | Word | Means |
31
+ |---|---|
32
+ | Account | You, signed in at engenty.ai with Google, GitHub or a link by email |
33
+ | Team | What the sign-up creates: it holds your credits, your spaces and, on the Team plan, your colleagues |
34
+ | Space | What all your wizards know and produce: name, logo, colours, facts, documents, data, results. A team’s first one in the cloud is “My wizards”; on your computer it is “My computer” (in German: “Meine Wizards”, “Mein Computer”) |
35
+ | Studio | Where you build wizards: engenty.ai/studio, or `/studio` on your computer |
36
+ | Wizard | A flow of steps a person walks through on a link |
37
+ | Step | One part of the flow: a page, an AI step, a review, the result |
38
+ | Run | One person going through a wizard once |
39
+ | Model class | The kind of model a step needs. Which model serves a class is a setting, not part of the wizard |
40
+
41
+ ## Two places it runs
42
+
43
+ Your team, its spaces and your wizards live in your account. engenty.ai is the cloud: you build
44
+ there in the browser, and links run day and night on the team’s credits. Your computer can join:
45
+ you [install](./install.md) engenty wizards there and sign in to the same account. It then uses
46
+ the AI clients and keys on that computer, and what you publish there runs in the cloud as well
47
+ ([Test and share](./test-and-share.md#in-the-cloud)). In the cloud studio, that space is marked
48
+ “Edited on your computer.” – you change it on your computer, not there. Without an account,
49
+ engenty wizards stays [only on your computer](./local-only.md).
@@ -0,0 +1,123 @@
1
+ ---
2
+ title: Install
3
+ description: One command on macOS or Linux. It brings its own Node.js and asks for no password.
4
+ version: 0.5.0
5
+ ---
6
+
7
+ ## Install
8
+
9
+ In a terminal, on macOS or Linux (arm64 or x64; on Windows, in WSL):
10
+
11
+ ```bash
12
+ curl -fsSL https://engenty.ai/install.sh | bash
13
+ ```
14
+
15
+ Or, with Node.js 20 or newer on the machine:
16
+
17
+ ```bash
18
+ npx wizards
19
+ ```
20
+
21
+ Both do the same. `npx wizards` downloads only a small launcher (no dependencies) and runs the
22
+ installer it brings along, then the setup, then the
23
+ `wizards` menu, where “Start as service” starts it and opens the studio. Run again, it hands over
24
+ to the installed `wizards`, and brings an older install up to its own version first.
25
+
26
+ The installer needs nothing but `curl` and `tar`. It brings its own Node.js (a Node you already
27
+ have is left alone), installs engenty wizards into `~/.engenty/wizards` (about 650 MB), links the
28
+ `wizards` command into `~/.local/bin` and then walks you through the rest:
29
+
30
+ | Step | What it does |
31
+ |---|---|
32
+ | Your engenty account | Asks “Sign in or create your account now?”. If you say yes, it shows a link and a code and opens your browser for the sign-in at account.engenty.ai; check that the page shows the same code (if you have no account yet, the page creates one with your invitation code, or puts you on the waitlist). While it waits, Enter opens the page again and Esc goes on without an account. Once you are signed in, what you publish on this computer runs in the cloud too. If you say no, `wizards account sign-in` does it any time. Setting it up again with `--local` signs an account out. `--local` leaves the account out altogether: see [Local only](./local-only.md) |
33
+ | An AI client | Looks for Codex, Claude Code, Antigravity and Cursor Agent and offers to install the ones that are missing. It puts first the one whose app (ChatGPT, Claude, Antigravity, Cursor) is on your Mac, as you most likely have that subscription already. You can also use your account’s credits, an API key, [Ollama](https://ollama.com) or, on a Mac with Apple silicon and macOS 26, Apple Intelligence: the studio’s [first page](./first-start.md) offers them |
34
+ | A browser and ffmpeg | Names the browser for PDF and PNG exports and steps on websites: the first of Chrome, Edge and Chromium it finds (on a Mac also Brave). engenty wizards uses that one; [`CHROME_PATH`](./command-line.md#settings) picks another. It also says whether ffmpeg is there for MP4 videos of animated widgets, and with Homebrew it offers to install it |
35
+ | Start at login (optional) | engenty wizards starts in the background when you log in, so links and AI apps can always reach it. It is a LaunchAgent on a Mac and a systemd user service on Linux |
36
+ | Your AI apps (optional) | Offers to add your wizards to the [AI apps](./ai-apps.md) it finds, such as Claude Desktop, Cursor or Codex |
37
+ | The command | If `~/.local/bin` is not on your PATH, it offers to add it in your shell’s settings file |
38
+
39
+ The installer starts nothing. At the end it says whether engenty wizards is running and how to
40
+ start, stop and check it. You install once; from then on you use the `wizards` command.
41
+
42
+ ## Start, stop, check
43
+
44
+ | Command | What it does |
45
+ |---|---|
46
+ | `wizards start` | Starts it and opens the studio. It runs while that terminal is open; Ctrl-C stops it |
47
+ | `wizards start -s` | Starts it in the background, so the terminal stays free |
48
+ | `wizards studio` | Opens the studio. If engenty wizards isn’t running, it starts it in the background first |
49
+ | `wizards stop` | Stops it. Your data is kept |
50
+ | `wizards status` | Shows whether it is running, and where |
51
+ | `wizards restart` | Stops it and starts it again |
52
+ | `wizards account` | Shows the account this computer is signed in to; `sign-in` and `sign-out` change it |
53
+ | `wizards` | Opens a menu with all of it |
54
+
55
+ The studio is at `http://localhost:24368/studio/`. The link the command opens signs this browser
56
+ in, and it works once. For another browser, see [`wizards open`](./command-line.md).
57
+
58
+ If the command is not found, open a new terminal or run `~/.local/bin/wizards`.
59
+
60
+ ## Install it as an app
61
+
62
+ In Chrome or Edge you can install the studio as an app, with its own window and its own icon in
63
+ the Dock or taskbar. The studio offers it in a banner at the top, or you click the install icon at
64
+ the right of the address bar.
65
+
66
+ ## Other ways to get it
67
+
68
+ | Way | For |
69
+ |---|---|
70
+ | [From source](https://github.com/engenty/wizards#from-source) | Working on the code |
71
+ | [Docker](./server.md) | A server others can reach |
72
+
73
+ ## Update
74
+
75
+ engenty wizards updates itself: it looks for a new version when it starts and once a day,
76
+ downloads it in the background and checks it, and switches to it at the next start (a restart or
77
+ the next login), never while a wizard runs. The version before stays beside it. `wizards status`
78
+ and the studio then say “Updated to …” with what changed. To turn it off:
79
+
80
+ ```bash
81
+ wizards autoupdate off
82
+ ```
83
+
84
+ or set `WIZARDS_DISABLE_AUTOUPDATE=1` (in the terminal or in `~/.engenty/wizards/.env`). In CI,
85
+ and for an install set up without a terminal, it is off unless you turn it on with `wizards
86
+ autoupdate on`. `npx wizards` never updates itself. To update now:
87
+
88
+ ```bash
89
+ wizards update
90
+ ```
91
+
92
+ This runs the installer again without its questions. If engenty wizards is running, `wizards
93
+ restart` then starts the new version; the command tells you so. "Update" in the `wizards` menu
94
+ restarts it into the new version by itself.
95
+
96
+ The studio also tells you in a banner at the top when a new version is out (“Version … of
97
+ engenty wizards is out.”). “Update” there installs it and starts the new version. The About
98
+ dialog behind the engenty mark in the app bar shows the same, and so does the line at the top of
99
+ Settings → Account: its version number opens the About dialog with what is new. Your data is
100
+ brought up to date at the next start.
101
+
102
+ ## Remove
103
+
104
+ ```bash
105
+ wizards uninstall
106
+ ```
107
+
108
+ First it shows what it will remove: your wizards in your AI apps, starting at login, everything of
109
+ engenty wizards that is running, the program in `~/.engenty/wizards` and the command
110
+ `~/.local/bin/wizards`. Your data in `~/.engenty/wizards/data` is kept unless you say to delete
111
+ it, and installing again picks it up. [Back it up](./data.md) first if you delete it. At the end
112
+ it lists anything it couldn’t remove.
113
+
114
+ If the `wizards` command is no longer on your path, `npx wizards uninstall` hands over to the
115
+ installed one.
116
+
117
+ | Option | What it does |
118
+ |---|---|
119
+ | `--dry-run` | Only shows what it would remove |
120
+ | `--yes` | Removes everything without asking and keeps your data |
121
+ | `--yes --delete-data` | Deletes your data as well |
122
+
123
+ Without a terminal, it asks for `--yes`.
@@ -0,0 +1,42 @@
1
+ ---
2
+ title: Local only
3
+ description: engenty wizards on your computer without an account. Nothing leaves your computer, and links work only there. The flag, what it means, and how to connect an account later.
4
+ version: 0.5.0
5
+ ---
6
+
7
+ During the setup, engenty wizards on your computer normally signs in to your account. What you
8
+ publish then runs in the cloud too. You can also keep it on your computer alone.
9
+
10
+ ## The flag
11
+
12
+ ```bash
13
+ curl -fsSL https://engenty.ai/install.sh | bash -s -- --local
14
+ ```
15
+
16
+ `--local` skips the account step of the setup and switches the account off on this computer.
17
+ If engenty wizards is already installed, run `wizards setup --local`.
18
+
19
+ ## What it means
20
+
21
+ - There is no account, and nothing leaves this computer. Your wizards, your space and results
22
+ stay in `~/.engenty/wizards/data` ([Your data](./data.md)).
23
+ - Links work on this computer only: `http://localhost:24368/w/…`. If others should open them,
24
+ run engenty wizards [on a server](./server.md) of your own.
25
+ - It runs on your AI clients, your own API keys, Ollama or Apple Intelligence
26
+ ([First start](./first-start.md)). Without an account, video and voice need your own API key.
27
+ - The studio shows nothing about an account: no sign-in, no credits, no copy in the cloud. The
28
+ feature switch `account` is off in the `.features` file in `~/.engenty/wizards`, and
29
+ `wizards features` lists it.
30
+ - `wizards status` and the `wizards` menu say “only on this computer, no account”.
31
+
32
+ ## Connect an account later
33
+
34
+ ```bash
35
+ wizards account sign-in
36
+ ```
37
+
38
+ The command shows a link and a code and opens your browser for the sign-in. After that,
39
+ engenty wizards is connected to the account and the switch is on again. `wizards account` shows
40
+ where it stands, and `wizards account sign-out` disconnects it. As long as the account is
41
+ switched off, the studio offers no sign-in, so you use the command. Once you are connected,
42
+ Settings → Account in the studio shows the account and can sign you out too.
@@ -0,0 +1,32 @@
1
+ {
2
+ "title": "User Guide",
3
+ "description": "Create an account, build a wizard, run and share it, install it on your computer.",
4
+ "root": true,
5
+ "icon": "LifeBuoy",
6
+ "pages": [
7
+ "index",
8
+ "---Start---",
9
+ "create-account",
10
+ "install",
11
+ "first-start",
12
+ "---Wizards---",
13
+ "build-a-wizard",
14
+ "steps",
15
+ "test-and-share",
16
+ "wordpress",
17
+ "run",
18
+ "space",
19
+ "assistant",
20
+ "---Settings---",
21
+ "connectors",
22
+ "models",
23
+ "ai-apps",
24
+ "plugins",
25
+ "---Your install---",
26
+ "command-line",
27
+ "data",
28
+ "local-only",
29
+ "server",
30
+ "troubleshooting"
31
+ ]
32
+ }