@n8n/instance-ai 1.0.0

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 (504) hide show
  1. package/LICENSE.md +88 -0
  2. package/dist/agent/instance-agent.d.ts +3 -0
  3. package/dist/agent/instance-agent.js +215 -0
  4. package/dist/agent/instance-agent.js.map +1 -0
  5. package/dist/agent/register-with-mastra.d.ts +3 -0
  6. package/dist/agent/register-with-mastra.js +19 -0
  7. package/dist/agent/register-with-mastra.js.map +1 -0
  8. package/dist/agent/sanitize-mcp-schemas.d.ts +2 -0
  9. package/dist/agent/sanitize-mcp-schemas.js +91 -0
  10. package/dist/agent/sanitize-mcp-schemas.js.map +1 -0
  11. package/dist/agent/sub-agent-factory.d.ts +14 -0
  12. package/dist/agent/sub-agent-factory.js +48 -0
  13. package/dist/agent/sub-agent-factory.js.map +1 -0
  14. package/dist/agent/system-prompt.d.ts +13 -0
  15. package/dist/agent/system-prompt.js +226 -0
  16. package/dist/agent/system-prompt.js.map +1 -0
  17. package/dist/build.tsbuildinfo +1 -0
  18. package/dist/compaction/compaction-helper.d.ts +9 -0
  19. package/dist/compaction/compaction-helper.js +58 -0
  20. package/dist/compaction/compaction-helper.js.map +1 -0
  21. package/dist/compaction/index.d.ts +2 -0
  22. package/dist/compaction/index.js +6 -0
  23. package/dist/compaction/index.js.map +1 -0
  24. package/dist/domain-access/domain-access-tracker.d.ts +9 -0
  25. package/dist/domain-access/domain-access-tracker.js +46 -0
  26. package/dist/domain-access/domain-access-tracker.js.map +1 -0
  27. package/dist/domain-access/domain-gating.d.ts +65 -0
  28. package/dist/domain-access/domain-gating.js +68 -0
  29. package/dist/domain-access/domain-gating.js.map +1 -0
  30. package/dist/domain-access/index.d.ts +4 -0
  31. package/dist/domain-access/index.js +11 -0
  32. package/dist/domain-access/index.js.map +1 -0
  33. package/dist/event-bus/event-bus.interface.d.ts +15 -0
  34. package/dist/event-bus/event-bus.interface.js +3 -0
  35. package/dist/event-bus/event-bus.interface.js.map +1 -0
  36. package/dist/event-bus/index.d.ts +1 -0
  37. package/dist/event-bus/index.js +3 -0
  38. package/dist/event-bus/index.js.map +1 -0
  39. package/dist/index.d.ts +46 -0
  40. package/dist/index.js +89 -0
  41. package/dist/index.js.map +1 -0
  42. package/dist/mcp/mcp-client-manager.d.ts +6 -0
  43. package/dist/mcp/mcp-client-manager.js +34 -0
  44. package/dist/mcp/mcp-client-manager.js.map +1 -0
  45. package/dist/memory/memory-config.d.ts +3 -0
  46. package/dist/memory/memory-config.js +29 -0
  47. package/dist/memory/memory-config.js.map +1 -0
  48. package/dist/memory/title-utils.d.ts +3 -0
  49. package/dist/memory/title-utils.js +42 -0
  50. package/dist/memory/title-utils.js.map +1 -0
  51. package/dist/memory/working-memory-template.d.ts +1 -0
  52. package/dist/memory/working-memory-template.js +25 -0
  53. package/dist/memory/working-memory-template.js.map +1 -0
  54. package/dist/planned-tasks/planned-task-service.d.ts +33 -0
  55. package/dist/planned-tasks/planned-task-service.js +151 -0
  56. package/dist/planned-tasks/planned-task-service.js.map +1 -0
  57. package/dist/runtime/background-task-manager.d.ts +53 -0
  58. package/dist/runtime/background-task-manager.js +127 -0
  59. package/dist/runtime/background-task-manager.js.map +1 -0
  60. package/dist/runtime/resumable-stream-executor.d.ts +75 -0
  61. package/dist/runtime/resumable-stream-executor.js +1552 -0
  62. package/dist/runtime/resumable-stream-executor.js.map +1 -0
  63. package/dist/runtime/run-state-registry.d.ts +109 -0
  64. package/dist/runtime/run-state-registry.js +210 -0
  65. package/dist/runtime/run-state-registry.js.map +1 -0
  66. package/dist/runtime/stream-runner.d.ts +27 -0
  67. package/dist/runtime/stream-runner.js +87 -0
  68. package/dist/runtime/stream-runner.js.map +1 -0
  69. package/dist/runtime/working-memory-tracing.d.ts +19 -0
  70. package/dist/runtime/working-memory-tracing.js +111 -0
  71. package/dist/runtime/working-memory-tracing.js.map +1 -0
  72. package/dist/storage/agent-tree-snapshot.d.ts +7 -0
  73. package/dist/storage/agent-tree-snapshot.js +3 -0
  74. package/dist/storage/agent-tree-snapshot.js.map +1 -0
  75. package/dist/storage/index.d.ts +10 -0
  76. package/dist/storage/index.js +17 -0
  77. package/dist/storage/index.js.map +1 -0
  78. package/dist/storage/iteration-log.d.ts +30 -0
  79. package/dist/storage/iteration-log.js +31 -0
  80. package/dist/storage/iteration-log.js.map +1 -0
  81. package/dist/storage/mastra-iteration-log-storage.d.ts +10 -0
  82. package/dist/storage/mastra-iteration-log-storage.js +57 -0
  83. package/dist/storage/mastra-iteration-log-storage.js.map +1 -0
  84. package/dist/storage/mastra-task-storage.d.ts +9 -0
  85. package/dist/storage/mastra-task-storage.js +35 -0
  86. package/dist/storage/mastra-task-storage.js.map +1 -0
  87. package/dist/storage/planned-task-storage.d.ts +10 -0
  88. package/dist/storage/planned-task-storage.js +97 -0
  89. package/dist/storage/planned-task-storage.js.map +1 -0
  90. package/dist/storage/thread-patch.d.ts +16 -0
  91. package/dist/storage/thread-patch.js +50 -0
  92. package/dist/storage/thread-patch.js.map +1 -0
  93. package/dist/storage/workflow-loop-storage.d.ts +217 -0
  94. package/dist/storage/workflow-loop-storage.js +59 -0
  95. package/dist/storage/workflow-loop-storage.js.map +1 -0
  96. package/dist/stream/consume-with-hitl.d.ts +22 -0
  97. package/dist/stream/consume-with-hitl.js +29 -0
  98. package/dist/stream/consume-with-hitl.js.map +1 -0
  99. package/dist/stream/map-chunk.d.ts +2 -0
  100. package/dist/stream/map-chunk.js +224 -0
  101. package/dist/stream/map-chunk.js.map +1 -0
  102. package/dist/tools/best-practices/get-best-practices.tool.d.ts +12 -0
  103. package/dist/tools/best-practices/get-best-practices.tool.js +64 -0
  104. package/dist/tools/best-practices/get-best-practices.tool.js.map +1 -0
  105. package/dist/tools/best-practices/guides/chatbot.d.ts +1 -0
  106. package/dist/tools/best-practices/guides/chatbot.js +111 -0
  107. package/dist/tools/best-practices/guides/chatbot.js.map +1 -0
  108. package/dist/tools/best-practices/guides/content-generation.d.ts +1 -0
  109. package/dist/tools/best-practices/guides/content-generation.js +108 -0
  110. package/dist/tools/best-practices/guides/content-generation.js.map +1 -0
  111. package/dist/tools/best-practices/guides/data-extraction.d.ts +1 -0
  112. package/dist/tools/best-practices/guides/data-extraction.js +115 -0
  113. package/dist/tools/best-practices/guides/data-extraction.js.map +1 -0
  114. package/dist/tools/best-practices/guides/data-persistence.d.ts +1 -0
  115. package/dist/tools/best-practices/guides/data-persistence.js +198 -0
  116. package/dist/tools/best-practices/guides/data-persistence.js.map +1 -0
  117. package/dist/tools/best-practices/guides/data-transformation.d.ts +1 -0
  118. package/dist/tools/best-practices/guides/data-transformation.js +139 -0
  119. package/dist/tools/best-practices/guides/data-transformation.js.map +1 -0
  120. package/dist/tools/best-practices/guides/document-processing.d.ts +1 -0
  121. package/dist/tools/best-practices/guides/document-processing.js +326 -0
  122. package/dist/tools/best-practices/guides/document-processing.js.map +1 -0
  123. package/dist/tools/best-practices/guides/form-input.d.ts +1 -0
  124. package/dist/tools/best-practices/guides/form-input.js +166 -0
  125. package/dist/tools/best-practices/guides/form-input.js.map +1 -0
  126. package/dist/tools/best-practices/guides/notification.d.ts +1 -0
  127. package/dist/tools/best-practices/guides/notification.js +128 -0
  128. package/dist/tools/best-practices/guides/notification.js.map +1 -0
  129. package/dist/tools/best-practices/guides/scheduling.d.ts +1 -0
  130. package/dist/tools/best-practices/guides/scheduling.js +145 -0
  131. package/dist/tools/best-practices/guides/scheduling.js.map +1 -0
  132. package/dist/tools/best-practices/guides/scraping-and-research.d.ts +1 -0
  133. package/dist/tools/best-practices/guides/scraping-and-research.js +151 -0
  134. package/dist/tools/best-practices/guides/scraping-and-research.js.map +1 -0
  135. package/dist/tools/best-practices/guides/triage.d.ts +1 -0
  136. package/dist/tools/best-practices/guides/triage.js +142 -0
  137. package/dist/tools/best-practices/guides/triage.js.map +1 -0
  138. package/dist/tools/best-practices/index.d.ts +2 -0
  139. package/dist/tools/best-practices/index.js +34 -0
  140. package/dist/tools/best-practices/index.js.map +1 -0
  141. package/dist/tools/best-practices/techniques.d.ts +20 -0
  142. package/dist/tools/best-practices/techniques.js +40 -0
  143. package/dist/tools/best-practices/techniques.js.map +1 -0
  144. package/dist/tools/credentials/delete-credential.tool.d.ts +21 -0
  145. package/dist/tools/credentials/delete-credential.tool.js +51 -0
  146. package/dist/tools/credentials/delete-credential.tool.js.map +1 -0
  147. package/dist/tools/credentials/get-credential.tool.d.ts +4 -0
  148. package/dist/tools/credentials/get-credential.tool.js +26 -0
  149. package/dist/tools/credentials/get-credential.tool.js.map +1 -0
  150. package/dist/tools/credentials/list-credentials.tool.d.ts +6 -0
  151. package/dist/tools/credentials/list-credentials.tool.js +30 -0
  152. package/dist/tools/credentials/list-credentials.tool.js.map +1 -0
  153. package/dist/tools/credentials/search-credential-types.tool.d.ts +6 -0
  154. package/dist/tools/credentials/search-credential-types.tool.js +44 -0
  155. package/dist/tools/credentials/search-credential-types.tool.js.map +1 -0
  156. package/dist/tools/credentials/setup-credentials.tool.d.ts +73 -0
  157. package/dist/tools/credentials/setup-credentials.tool.js +134 -0
  158. package/dist/tools/credentials/setup-credentials.tool.js.map +1 -0
  159. package/dist/tools/credentials/test-credential.tool.d.ts +7 -0
  160. package/dist/tools/credentials/test-credential.tool.js +30 -0
  161. package/dist/tools/credentials/test-credential.tool.js.map +1 -0
  162. package/dist/tools/data-tables/add-data-table-column.tool.d.ts +27 -0
  163. package/dist/tools/data-tables/add-data-table-column.tool.js +60 -0
  164. package/dist/tools/data-tables/add-data-table-column.tool.js.map +1 -0
  165. package/dist/tools/data-tables/create-data-table.tool.d.ts +36 -0
  166. package/dist/tools/data-tables/create-data-table.tool.js +79 -0
  167. package/dist/tools/data-tables/create-data-table.tool.js.map +1 -0
  168. package/dist/tools/data-tables/delete-data-table-column.tool.d.ts +21 -0
  169. package/dist/tools/data-tables/delete-data-table-column.tool.js +48 -0
  170. package/dist/tools/data-tables/delete-data-table-column.tool.js.map +1 -0
  171. package/dist/tools/data-tables/delete-data-table-rows.tool.d.ts +29 -0
  172. package/dist/tools/data-tables/delete-data-table-rows.tool.js +63 -0
  173. package/dist/tools/data-tables/delete-data-table-rows.tool.js.map +1 -0
  174. package/dist/tools/data-tables/delete-data-table.tool.d.ts +20 -0
  175. package/dist/tools/data-tables/delete-data-table.tool.js +46 -0
  176. package/dist/tools/data-tables/delete-data-table.tool.js.map +1 -0
  177. package/dist/tools/data-tables/get-data-table-schema.tool.d.ts +11 -0
  178. package/dist/tools/data-tables/get-data-table-schema.tool.js +27 -0
  179. package/dist/tools/data-tables/get-data-table-schema.tool.js.map +1 -0
  180. package/dist/tools/data-tables/insert-data-table-rows.tool.d.ts +21 -0
  181. package/dist/tools/data-tables/insert-data-table-rows.tool.js +52 -0
  182. package/dist/tools/data-tables/insert-data-table-rows.tool.js.map +1 -0
  183. package/dist/tools/data-tables/list-data-tables.tool.d.ts +6 -0
  184. package/dist/tools/data-tables/list-data-tables.tool.js +32 -0
  185. package/dist/tools/data-tables/list-data-tables.tool.js.map +1 -0
  186. package/dist/tools/data-tables/query-data-table-rows.tool.d.ts +21 -0
  187. package/dist/tools/data-tables/query-data-table-rows.tool.js +54 -0
  188. package/dist/tools/data-tables/query-data-table-rows.tool.js.map +1 -0
  189. package/dist/tools/data-tables/rename-data-table-column.tool.d.ts +22 -0
  190. package/dist/tools/data-tables/rename-data-table-column.tool.js +49 -0
  191. package/dist/tools/data-tables/rename-data-table-column.tool.js.map +1 -0
  192. package/dist/tools/data-tables/update-data-table-rows.tool.d.ts +29 -0
  193. package/dist/tools/data-tables/update-data-table-rows.tool.js +57 -0
  194. package/dist/tools/data-tables/update-data-table-rows.tool.js.map +1 -0
  195. package/dist/tools/executions/debug-execution.tool.d.ts +4 -0
  196. package/dist/tools/executions/debug-execution.tool.js +41 -0
  197. package/dist/tools/executions/debug-execution.tool.js.map +1 -0
  198. package/dist/tools/executions/get-execution.tool.d.ts +4 -0
  199. package/dist/tools/executions/get-execution.tool.js +26 -0
  200. package/dist/tools/executions/get-execution.tool.js.map +1 -0
  201. package/dist/tools/executions/get-node-output.tool.d.ts +7 -0
  202. package/dist/tools/executions/get-node-output.tool.js +44 -0
  203. package/dist/tools/executions/get-node-output.tool.js.map +1 -0
  204. package/dist/tools/executions/list-executions.tool.d.ts +8 -0
  205. package/dist/tools/executions/list-executions.tool.js +45 -0
  206. package/dist/tools/executions/list-executions.tool.js.map +1 -0
  207. package/dist/tools/executions/run-workflow.tool.d.ts +24 -0
  208. package/dist/tools/executions/run-workflow.tool.js +82 -0
  209. package/dist/tools/executions/run-workflow.tool.js.map +1 -0
  210. package/dist/tools/executions/stop-execution.tool.d.ts +7 -0
  211. package/dist/tools/executions/stop-execution.tool.js +22 -0
  212. package/dist/tools/executions/stop-execution.tool.js.map +1 -0
  213. package/dist/tools/filesystem/create-tools-from-mcp-server.d.ts +3 -0
  214. package/dist/tools/filesystem/create-tools-from-mcp-server.js +61 -0
  215. package/dist/tools/filesystem/create-tools-from-mcp-server.js.map +1 -0
  216. package/dist/tools/filesystem/get-file-tree.tool.d.ts +22 -0
  217. package/dist/tools/filesystem/get-file-tree.tool.js +64 -0
  218. package/dist/tools/filesystem/get-file-tree.tool.js.map +1 -0
  219. package/dist/tools/filesystem/list-files.tool.d.ts +30 -0
  220. package/dist/tools/filesystem/list-files.tool.js +100 -0
  221. package/dist/tools/filesystem/list-files.tool.js.map +1 -0
  222. package/dist/tools/filesystem/read-file.tool.d.ts +25 -0
  223. package/dist/tools/filesystem/read-file.tool.js +83 -0
  224. package/dist/tools/filesystem/read-file.tool.js.map +1 -0
  225. package/dist/tools/filesystem/search-files.tool.d.ts +31 -0
  226. package/dist/tools/filesystem/search-files.tool.js +96 -0
  227. package/dist/tools/filesystem/search-files.tool.js.map +1 -0
  228. package/dist/tools/index.d.ts +2385 -0
  229. package/dist/tools/index.js +195 -0
  230. package/dist/tools/index.js.map +1 -0
  231. package/dist/tools/nodes/explore-node-resources.tool.d.ts +21 -0
  232. package/dist/tools/nodes/explore-node-resources.tool.js +71 -0
  233. package/dist/tools/nodes/explore-node-resources.tool.js.map +1 -0
  234. package/dist/tools/nodes/get-node-description.tool.d.ts +23 -0
  235. package/dist/tools/nodes/get-node-description.tool.js +52 -0
  236. package/dist/tools/nodes/get-node-description.tool.js.map +1 -0
  237. package/dist/tools/nodes/get-node-type-definition.tool.d.ts +17 -0
  238. package/dist/tools/nodes/get-node-type-definition.tool.js +73 -0
  239. package/dist/tools/nodes/get-node-type-definition.tool.js.map +1 -0
  240. package/dist/tools/nodes/get-suggested-nodes.tool.d.ts +14 -0
  241. package/dist/tools/nodes/get-suggested-nodes.tool.js +54 -0
  242. package/dist/tools/nodes/get-suggested-nodes.tool.js.map +1 -0
  243. package/dist/tools/nodes/list-nodes.tool.d.ts +6 -0
  244. package/dist/tools/nodes/list-nodes.tool.js +33 -0
  245. package/dist/tools/nodes/list-nodes.tool.js.map +1 -0
  246. package/dist/tools/nodes/node-search-engine.d.ts +18 -0
  247. package/dist/tools/nodes/node-search-engine.js +266 -0
  248. package/dist/tools/nodes/node-search-engine.js.map +1 -0
  249. package/dist/tools/nodes/node-search-engine.types.d.ts +38 -0
  250. package/dist/tools/nodes/node-search-engine.types.js +18 -0
  251. package/dist/tools/nodes/node-search-engine.types.js.map +1 -0
  252. package/dist/tools/nodes/search-nodes.tool.d.ts +28 -0
  253. package/dist/tools/nodes/search-nodes.tool.js +87 -0
  254. package/dist/tools/nodes/search-nodes.tool.js.map +1 -0
  255. package/dist/tools/nodes/suggested-nodes-data.d.ts +11 -0
  256. package/dist/tools/nodes/suggested-nodes-data.js +326 -0
  257. package/dist/tools/nodes/suggested-nodes-data.js.map +1 -0
  258. package/dist/tools/orchestration/browser-credential-setup.tool.d.ts +14 -0
  259. package/dist/tools/orchestration/browser-credential-setup.tool.js +429 -0
  260. package/dist/tools/orchestration/browser-credential-setup.tool.js.map +1 -0
  261. package/dist/tools/orchestration/build-workflow-agent.prompt.d.ts +2 -0
  262. package/dist/tools/orchestration/build-workflow-agent.prompt.js +836 -0
  263. package/dist/tools/orchestration/build-workflow-agent.prompt.js.map +1 -0
  264. package/dist/tools/orchestration/build-workflow-agent.tool.d.ts +23 -0
  265. package/dist/tools/orchestration/build-workflow-agent.tool.js +503 -0
  266. package/dist/tools/orchestration/build-workflow-agent.tool.js.map +1 -0
  267. package/dist/tools/orchestration/cancel-background-task.tool.d.ts +6 -0
  268. package/dist/tools/orchestration/cancel-background-task.tool.js +24 -0
  269. package/dist/tools/orchestration/cancel-background-task.tool.js.map +1 -0
  270. package/dist/tools/orchestration/correct-background-task.tool.d.ts +7 -0
  271. package/dist/tools/orchestration/correct-background-task.tool.js +41 -0
  272. package/dist/tools/orchestration/correct-background-task.tool.js.map +1 -0
  273. package/dist/tools/orchestration/data-table-agent.prompt.d.ts +1 -0
  274. package/dist/tools/orchestration/data-table-agent.prompt.js +29 -0
  275. package/dist/tools/orchestration/data-table-agent.prompt.js.map +1 -0
  276. package/dist/tools/orchestration/data-table-agent.tool.d.ts +21 -0
  277. package/dist/tools/orchestration/data-table-agent.tool.js +171 -0
  278. package/dist/tools/orchestration/data-table-agent.tool.js.map +1 -0
  279. package/dist/tools/orchestration/delegate.schemas.d.ts +32 -0
  280. package/dist/tools/orchestration/delegate.schemas.js +29 -0
  281. package/dist/tools/orchestration/delegate.schemas.js.map +1 -0
  282. package/dist/tools/orchestration/delegate.tool.d.ts +27 -0
  283. package/dist/tools/orchestration/delegate.tool.js +307 -0
  284. package/dist/tools/orchestration/delegate.tool.js.map +1 -0
  285. package/dist/tools/orchestration/display-utils.d.ts +1 -0
  286. package/dist/tools/orchestration/display-utils.js +8 -0
  287. package/dist/tools/orchestration/display-utils.js.map +1 -0
  288. package/dist/tools/orchestration/plan.tool.d.ts +45 -0
  289. package/dist/tools/orchestration/plan.tool.js +99 -0
  290. package/dist/tools/orchestration/plan.tool.js.map +1 -0
  291. package/dist/tools/orchestration/report-verification-verdict.tool.d.ts +14 -0
  292. package/dist/tools/orchestration/report-verification-verdict.tool.js +66 -0
  293. package/dist/tools/orchestration/report-verification-verdict.tool.js.map +1 -0
  294. package/dist/tools/orchestration/research-agent-prompt.d.ts +1 -0
  295. package/dist/tools/orchestration/research-agent-prompt.js +28 -0
  296. package/dist/tools/orchestration/research-agent-prompt.js.map +1 -0
  297. package/dist/tools/orchestration/research-with-agent.tool.d.ts +23 -0
  298. package/dist/tools/orchestration/research-with-agent.tool.js +160 -0
  299. package/dist/tools/orchestration/research-with-agent.tool.js.map +1 -0
  300. package/dist/tools/orchestration/tracing-utils.d.ts +20 -0
  301. package/dist/tools/orchestration/tracing-utils.js +102 -0
  302. package/dist/tools/orchestration/tracing-utils.js.map +1 -0
  303. package/dist/tools/orchestration/update-tasks.tool.d.ts +10 -0
  304. package/dist/tools/orchestration/update-tasks.tool.js +26 -0
  305. package/dist/tools/orchestration/update-tasks.tool.js.map +1 -0
  306. package/dist/tools/orchestration/verify-built-workflow.tool.d.ts +13 -0
  307. package/dist/tools/orchestration/verify-built-workflow.tool.js +58 -0
  308. package/dist/tools/orchestration/verify-built-workflow.tool.js.map +1 -0
  309. package/dist/tools/shared/ask-user.tool.d.ts +61 -0
  310. package/dist/tools/shared/ask-user.tool.js +98 -0
  311. package/dist/tools/shared/ask-user.tool.js.map +1 -0
  312. package/dist/tools/templates/search-template-parameters.tool.d.ts +11 -0
  313. package/dist/tools/templates/search-template-parameters.tool.js +55 -0
  314. package/dist/tools/templates/search-template-parameters.tool.js.map +1 -0
  315. package/dist/tools/templates/search-template-structures.tool.d.ts +12 -0
  316. package/dist/tools/templates/search-template-structures.tool.js +45 -0
  317. package/dist/tools/templates/search-template-structures.tool.js.map +1 -0
  318. package/dist/tools/templates/template-api.d.ts +21 -0
  319. package/dist/tools/templates/template-api.js +104 -0
  320. package/dist/tools/templates/template-api.js.map +1 -0
  321. package/dist/tools/templates/types.d.ts +52 -0
  322. package/dist/tools/templates/types.js +37 -0
  323. package/dist/tools/templates/types.js.map +1 -0
  324. package/dist/tools/utils/mermaid.utils.d.ts +15 -0
  325. package/dist/tools/utils/mermaid.utils.js +622 -0
  326. package/dist/tools/utils/mermaid.utils.js.map +1 -0
  327. package/dist/tools/utils/node-configuration.utils.d.ts +6 -0
  328. package/dist/tools/utils/node-configuration.utils.js +77 -0
  329. package/dist/tools/utils/node-configuration.utils.js.map +1 -0
  330. package/dist/tools/web-research/fetch-url.tool.d.ts +27 -0
  331. package/dist/tools/web-research/fetch-url.tool.js +116 -0
  332. package/dist/tools/web-research/fetch-url.tool.js.map +1 -0
  333. package/dist/tools/web-research/index.d.ts +1 -0
  334. package/dist/tools/web-research/index.js +6 -0
  335. package/dist/tools/web-research/index.js.map +1 -0
  336. package/dist/tools/web-research/sanitize-web-content.d.ts +3 -0
  337. package/dist/tools/web-research/sanitize-web-content.js +36 -0
  338. package/dist/tools/web-research/sanitize-web-content.js.map +1 -0
  339. package/dist/tools/web-research/web-search.tool.d.ts +6 -0
  340. package/dist/tools/web-research/web-search.tool.js +57 -0
  341. package/dist/tools/web-research/web-search.tool.js.map +1 -0
  342. package/dist/tools/workflows/apply-workflow-credentials.tool.d.ts +10 -0
  343. package/dist/tools/workflows/apply-workflow-credentials.tool.js +87 -0
  344. package/dist/tools/workflows/apply-workflow-credentials.tool.js.map +1 -0
  345. package/dist/tools/workflows/build-workflow.tool.d.ts +16 -0
  346. package/dist/tools/workflows/build-workflow.tool.js +163 -0
  347. package/dist/tools/workflows/build-workflow.tool.js.map +1 -0
  348. package/dist/tools/workflows/delete-workflow.tool.d.ts +21 -0
  349. package/dist/tools/workflows/delete-workflow.tool.js +51 -0
  350. package/dist/tools/workflows/delete-workflow.tool.js.map +1 -0
  351. package/dist/tools/workflows/get-workflow-as-code.tool.d.ts +14 -0
  352. package/dist/tools/workflows/get-workflow-as-code.tool.js +37 -0
  353. package/dist/tools/workflows/get-workflow-as-code.tool.js.map +1 -0
  354. package/dist/tools/workflows/get-workflow-version.tool.d.ts +21 -0
  355. package/dist/tools/workflows/get-workflow-version.tool.js +38 -0
  356. package/dist/tools/workflows/get-workflow-version.tool.js.map +1 -0
  357. package/dist/tools/workflows/get-workflow.tool.d.ts +18 -0
  358. package/dist/tools/workflows/get-workflow.tool.js +36 -0
  359. package/dist/tools/workflows/get-workflow.tool.js.map +1 -0
  360. package/dist/tools/workflows/list-workflow-versions.tool.d.ts +8 -0
  361. package/dist/tools/workflows/list-workflow-versions.tool.js +47 -0
  362. package/dist/tools/workflows/list-workflow-versions.tool.js.map +1 -0
  363. package/dist/tools/workflows/list-workflows.tool.d.ts +14 -0
  364. package/dist/tools/workflows/list-workflows.tool.js +42 -0
  365. package/dist/tools/workflows/list-workflows.tool.js.map +1 -0
  366. package/dist/tools/workflows/materialize-node-type.tool.d.ts +23 -0
  367. package/dist/tools/workflows/materialize-node-type.tool.js +105 -0
  368. package/dist/tools/workflows/materialize-node-type.tool.js.map +1 -0
  369. package/dist/tools/workflows/publish-workflow.tool.d.ts +24 -0
  370. package/dist/tools/workflows/publish-workflow.tool.js +92 -0
  371. package/dist/tools/workflows/publish-workflow.tool.js.map +1 -0
  372. package/dist/tools/workflows/resolve-credentials.d.ts +14 -0
  373. package/dist/tools/workflows/resolve-credentials.js +89 -0
  374. package/dist/tools/workflows/resolve-credentials.js.map +1 -0
  375. package/dist/tools/workflows/restore-workflow-version.tool.d.ts +22 -0
  376. package/dist/tools/workflows/restore-workflow-version.tool.js +65 -0
  377. package/dist/tools/workflows/restore-workflow-version.tool.js.map +1 -0
  378. package/dist/tools/workflows/setup-workflow.schema.d.ts +331 -0
  379. package/dist/tools/workflows/setup-workflow.schema.js +21 -0
  380. package/dist/tools/workflows/setup-workflow.schema.js.map +1 -0
  381. package/dist/tools/workflows/setup-workflow.service.d.ts +40 -0
  382. package/dist/tools/workflows/setup-workflow.service.js +470 -0
  383. package/dist/tools/workflows/setup-workflow.service.js.map +1 -0
  384. package/dist/tools/workflows/setup-workflow.tool.d.ts +150 -0
  385. package/dist/tools/workflows/setup-workflow.tool.js +219 -0
  386. package/dist/tools/workflows/setup-workflow.tool.js.map +1 -0
  387. package/dist/tools/workflows/submit-workflow.tool.d.ts +33 -0
  388. package/dist/tools/workflows/submit-workflow.tool.js +258 -0
  389. package/dist/tools/workflows/submit-workflow.tool.js.map +1 -0
  390. package/dist/tools/workflows/unpublish-workflow.tool.d.ts +22 -0
  391. package/dist/tools/workflows/unpublish-workflow.tool.js +61 -0
  392. package/dist/tools/workflows/unpublish-workflow.tool.js.map +1 -0
  393. package/dist/tools/workflows/update-workflow-version.tool.d.ts +9 -0
  394. package/dist/tools/workflows/update-workflow-version.tool.js +35 -0
  395. package/dist/tools/workflows/update-workflow-version.tool.js.map +1 -0
  396. package/dist/tools/workflows/write-sandbox-file.tool.d.ts +13 -0
  397. package/dist/tools/workflows/write-sandbox-file.tool.js +53 -0
  398. package/dist/tools/workflows/write-sandbox-file.tool.js.map +1 -0
  399. package/dist/tools/workspace/cleanup-test-executions.tool.d.ts +22 -0
  400. package/dist/tools/workspace/cleanup-test-executions.tool.js +58 -0
  401. package/dist/tools/workspace/cleanup-test-executions.tool.js.map +1 -0
  402. package/dist/tools/workspace/create-folder.tool.d.ts +24 -0
  403. package/dist/tools/workspace/create-folder.tool.js +59 -0
  404. package/dist/tools/workspace/create-folder.tool.js.map +1 -0
  405. package/dist/tools/workspace/delete-folder.tool.d.ts +24 -0
  406. package/dist/tools/workspace/delete-folder.tool.js +60 -0
  407. package/dist/tools/workspace/delete-folder.tool.js.map +1 -0
  408. package/dist/tools/workspace/list-folders.tool.d.ts +6 -0
  409. package/dist/tools/workspace/list-folders.tool.js +26 -0
  410. package/dist/tools/workspace/list-folders.tool.js.map +1 -0
  411. package/dist/tools/workspace/list-projects.tool.d.ts +4 -0
  412. package/dist/tools/workspace/list-projects.tool.js +24 -0
  413. package/dist/tools/workspace/list-projects.tool.js.map +1 -0
  414. package/dist/tools/workspace/list-tags.tool.d.ts +7 -0
  415. package/dist/tools/workspace/list-tags.tool.js +23 -0
  416. package/dist/tools/workspace/list-tags.tool.js.map +1 -0
  417. package/dist/tools/workspace/move-workflow-to-folder.tool.d.ts +23 -0
  418. package/dist/tools/workspace/move-workflow-to-folder.tool.js +56 -0
  419. package/dist/tools/workspace/move-workflow-to-folder.tool.js.map +1 -0
  420. package/dist/tools/workspace/tag-workflow.tool.d.ts +22 -0
  421. package/dist/tools/workspace/tag-workflow.tool.js +52 -0
  422. package/dist/tools/workspace/tag-workflow.tool.js.map +1 -0
  423. package/dist/tracing/langsmith-tracing.d.ts +56 -0
  424. package/dist/tracing/langsmith-tracing.js +810 -0
  425. package/dist/tracing/langsmith-tracing.js.map +1 -0
  426. package/dist/types.d.ts +709 -0
  427. package/dist/types.js +3 -0
  428. package/dist/types.js.map +1 -0
  429. package/dist/utils/agent-tree.d.ts +3 -0
  430. package/dist/utils/agent-tree.js +23 -0
  431. package/dist/utils/agent-tree.js.map +1 -0
  432. package/dist/utils/format-timestamp.d.ts +1 -0
  433. package/dist/utils/format-timestamp.js +19 -0
  434. package/dist/utils/format-timestamp.js.map +1 -0
  435. package/dist/utils/stream-helpers.d.ts +15 -0
  436. package/dist/utils/stream-helpers.js +26 -0
  437. package/dist/utils/stream-helpers.js.map +1 -0
  438. package/dist/workflow-builder/extract-code.d.ts +5 -0
  439. package/dist/workflow-builder/extract-code.js +105 -0
  440. package/dist/workflow-builder/extract-code.js.map +1 -0
  441. package/dist/workflow-builder/index.d.ts +5 -0
  442. package/dist/workflow-builder/index.js +19 -0
  443. package/dist/workflow-builder/index.js.map +1 -0
  444. package/dist/workflow-builder/parse-validate.d.ts +6 -0
  445. package/dist/workflow-builder/parse-validate.js +49 -0
  446. package/dist/workflow-builder/parse-validate.js.map +1 -0
  447. package/dist/workflow-builder/patch-code.d.ts +14 -0
  448. package/dist/workflow-builder/patch-code.js +117 -0
  449. package/dist/workflow-builder/patch-code.js.map +1 -0
  450. package/dist/workflow-builder/sdk-prompt-sections.d.ts +4 -0
  451. package/dist/workflow-builder/sdk-prompt-sections.js +517 -0
  452. package/dist/workflow-builder/sdk-prompt-sections.js.map +1 -0
  453. package/dist/workflow-builder/types.d.ts +11 -0
  454. package/dist/workflow-builder/types.js +3 -0
  455. package/dist/workflow-builder/types.js.map +1 -0
  456. package/dist/workflow-loop/guidance.d.ts +5 -0
  457. package/dist/workflow-loop/guidance.js +37 -0
  458. package/dist/workflow-loop/guidance.js.map +1 -0
  459. package/dist/workflow-loop/index.d.ts +5 -0
  460. package/dist/workflow-loop/index.js +25 -0
  461. package/dist/workflow-loop/index.js.map +1 -0
  462. package/dist/workflow-loop/runtime.d.ts +8 -0
  463. package/dist/workflow-loop/runtime.js +40 -0
  464. package/dist/workflow-loop/runtime.js.map +1 -0
  465. package/dist/workflow-loop/workflow-loop-controller.d.ts +11 -0
  466. package/dist/workflow-loop/workflow-loop-controller.js +212 -0
  467. package/dist/workflow-loop/workflow-loop-controller.js.map +1 -0
  468. package/dist/workflow-loop/workflow-loop-state.d.ts +189 -0
  469. package/dist/workflow-loop/workflow-loop-state.js +77 -0
  470. package/dist/workflow-loop/workflow-loop-state.js.map +1 -0
  471. package/dist/workflow-loop/workflow-task-service.d.ts +13 -0
  472. package/dist/workflow-loop/workflow-task-service.js +35 -0
  473. package/dist/workflow-loop/workflow-task-service.js.map +1 -0
  474. package/dist/workspace/builder-sandbox-factory.d.ts +25 -0
  475. package/dist/workspace/builder-sandbox-factory.js +199 -0
  476. package/dist/workspace/builder-sandbox-factory.js.map +1 -0
  477. package/dist/workspace/create-workspace.d.ts +33 -0
  478. package/dist/workspace/create-workspace.js +56 -0
  479. package/dist/workspace/create-workspace.js.map +1 -0
  480. package/dist/workspace/daytona-filesystem.d.ts +25 -0
  481. package/dist/workspace/daytona-filesystem.js +109 -0
  482. package/dist/workspace/daytona-filesystem.js.map +1 -0
  483. package/dist/workspace/n8n-sandbox-client.d.ts +105 -0
  484. package/dist/workspace/n8n-sandbox-client.js +335 -0
  485. package/dist/workspace/n8n-sandbox-client.js.map +1 -0
  486. package/dist/workspace/n8n-sandbox-filesystem.d.ts +25 -0
  487. package/dist/workspace/n8n-sandbox-filesystem.js +128 -0
  488. package/dist/workspace/n8n-sandbox-filesystem.js.map +1 -0
  489. package/dist/workspace/n8n-sandbox-image-manager.d.ts +5 -0
  490. package/dist/workspace/n8n-sandbox-image-manager.js +25 -0
  491. package/dist/workspace/n8n-sandbox-image-manager.js.map +1 -0
  492. package/dist/workspace/n8n-sandbox-sandbox.d.ts +27 -0
  493. package/dist/workspace/n8n-sandbox-sandbox.js +103 -0
  494. package/dist/workspace/n8n-sandbox-sandbox.js.map +1 -0
  495. package/dist/workspace/sandbox-fs.d.ts +9 -0
  496. package/dist/workspace/sandbox-fs.js +43 -0
  497. package/dist/workspace/sandbox-fs.js.map +1 -0
  498. package/dist/workspace/sandbox-setup.d.ts +11 -0
  499. package/dist/workspace/sandbox-setup.js +139 -0
  500. package/dist/workspace/sandbox-setup.js.map +1 -0
  501. package/dist/workspace/snapshot-manager.d.ts +8 -0
  502. package/dist/workspace/snapshot-manager.js +31 -0
  503. package/dist/workspace/snapshot-manager.js.map +1 -0
  504. package/package.json +54 -0
@@ -0,0 +1,709 @@
1
+ import type { LanguageModelV2 } from '@ai-sdk/provider-v5';
2
+ import type { ToolsInput } from '@mastra/core/agent';
3
+ import type { MastraCompositeStore } from '@mastra/core/storage';
4
+ import type { Workspace } from '@mastra/core/workspace';
5
+ import type { Memory } from '@mastra/memory';
6
+ import type { TaskList, InstanceAiPermissions, McpTool, McpToolCallRequest, McpToolCallResult } from '@n8n/api-types';
7
+ import type { WorkflowJSON } from '@n8n/workflow-sdk';
8
+ import type { DomainAccessTracker } from './domain-access/domain-access-tracker';
9
+ import type { InstanceAiEventBus } from './event-bus/event-bus.interface';
10
+ import type { IterationLog } from './storage/iteration-log';
11
+ import type { VerificationResult, WorkflowBuildOutcome, WorkflowLoopAction } from './workflow-loop/workflow-loop-state';
12
+ import type { BuilderSandboxFactory } from './workspace/builder-sandbox-factory';
13
+ export interface WorkflowSummary {
14
+ id: string;
15
+ name: string;
16
+ versionId: string;
17
+ activeVersionId: string | null;
18
+ createdAt: string;
19
+ updatedAt: string;
20
+ tags?: string[];
21
+ }
22
+ export interface WorkflowDetail extends WorkflowSummary {
23
+ nodes: WorkflowNode[];
24
+ connections: Record<string, unknown>;
25
+ settings?: Record<string, unknown>;
26
+ }
27
+ export interface WorkflowNode {
28
+ name: string;
29
+ type: string;
30
+ parameters?: Record<string, unknown>;
31
+ position: number[];
32
+ webhookId?: string;
33
+ }
34
+ export interface ExecutionResult {
35
+ executionId: string;
36
+ status: 'running' | 'success' | 'error' | 'waiting' | 'unknown';
37
+ data?: Record<string, unknown>;
38
+ error?: string;
39
+ startedAt?: string;
40
+ finishedAt?: string;
41
+ }
42
+ export interface NodeOutputResult {
43
+ nodeName: string;
44
+ items: unknown[];
45
+ totalItems: number;
46
+ returned: {
47
+ from: number;
48
+ to: number;
49
+ };
50
+ }
51
+ export interface ExecutionDebugInfo extends ExecutionResult {
52
+ failedNode?: {
53
+ name: string;
54
+ type: string;
55
+ error: string;
56
+ inputData?: Record<string, unknown> | string;
57
+ };
58
+ nodeTrace: Array<{
59
+ name: string;
60
+ type: string;
61
+ status: 'success' | 'error';
62
+ startedAt?: string;
63
+ finishedAt?: string;
64
+ }>;
65
+ }
66
+ export interface CredentialSummary {
67
+ id: string;
68
+ name: string;
69
+ type: string;
70
+ createdAt: string;
71
+ updatedAt: string;
72
+ }
73
+ export interface CredentialDetail extends CredentialSummary {
74
+ nodesWithAccess?: Array<{
75
+ nodeType: string;
76
+ }>;
77
+ }
78
+ export interface NodeSummary {
79
+ name: string;
80
+ displayName: string;
81
+ description: string;
82
+ group: string[];
83
+ version: number;
84
+ }
85
+ export interface NodeDescription extends NodeSummary {
86
+ properties: Array<{
87
+ displayName: string;
88
+ name: string;
89
+ type: string;
90
+ required?: boolean;
91
+ description?: string;
92
+ default?: unknown;
93
+ options?: Array<{
94
+ name: string;
95
+ value: string | number | boolean;
96
+ }>;
97
+ }>;
98
+ credentials?: Array<{
99
+ name: string;
100
+ required?: boolean;
101
+ }>;
102
+ inputs: string[];
103
+ outputs: string[];
104
+ webhooks?: unknown[];
105
+ polling?: boolean;
106
+ triggerPanel?: unknown;
107
+ }
108
+ export interface WorkflowVersionSummary {
109
+ versionId: string;
110
+ name: string | null;
111
+ description: string | null;
112
+ authors: string;
113
+ createdAt: string;
114
+ autosaved: boolean;
115
+ isActive: boolean;
116
+ isCurrentDraft: boolean;
117
+ }
118
+ export interface WorkflowVersionDetail extends WorkflowVersionSummary {
119
+ nodes: WorkflowNode[];
120
+ connections: Record<string, unknown>;
121
+ }
122
+ export interface InstanceAiWorkflowService {
123
+ list(options?: {
124
+ query?: string;
125
+ limit?: number;
126
+ }): Promise<WorkflowSummary[]>;
127
+ get(workflowId: string): Promise<WorkflowDetail>;
128
+ getAsWorkflowJSON(workflowId: string): Promise<WorkflowJSON>;
129
+ createFromWorkflowJSON(json: WorkflowJSON, options?: {
130
+ projectId?: string;
131
+ }): Promise<WorkflowDetail>;
132
+ updateFromWorkflowJSON(workflowId: string, json: WorkflowJSON, options?: {
133
+ projectId?: string;
134
+ }): Promise<WorkflowDetail>;
135
+ archive(workflowId: string): Promise<void>;
136
+ delete(workflowId: string): Promise<void>;
137
+ publish(workflowId: string, options?: {
138
+ versionId?: string;
139
+ name?: string;
140
+ description?: string;
141
+ }): Promise<{
142
+ activeVersionId: string;
143
+ }>;
144
+ unpublish(workflowId: string): Promise<void>;
145
+ listVersions?(workflowId: string, options?: {
146
+ limit?: number;
147
+ skip?: number;
148
+ }): Promise<WorkflowVersionSummary[]>;
149
+ getVersion?(workflowId: string, versionId: string): Promise<WorkflowVersionDetail>;
150
+ restoreVersion?(workflowId: string, versionId: string): Promise<void>;
151
+ updateVersion?(workflowId: string, versionId: string, data: {
152
+ name?: string | null;
153
+ description?: string | null;
154
+ }): Promise<void>;
155
+ }
156
+ export interface ExecutionSummary {
157
+ id: string;
158
+ workflowId: string;
159
+ workflowName: string;
160
+ status: string;
161
+ startedAt: string;
162
+ finishedAt?: string;
163
+ mode: string;
164
+ }
165
+ export interface InstanceAiExecutionService {
166
+ list(options?: {
167
+ workflowId?: string;
168
+ status?: string;
169
+ limit?: number;
170
+ }): Promise<ExecutionSummary[]>;
171
+ run(workflowId: string, inputData?: Record<string, unknown>, options?: {
172
+ timeout?: number;
173
+ pinData?: Record<string, unknown[]>;
174
+ triggerNodeName?: string;
175
+ }): Promise<ExecutionResult>;
176
+ getStatus(executionId: string): Promise<ExecutionResult>;
177
+ getResult(executionId: string): Promise<ExecutionResult>;
178
+ stop(executionId: string): Promise<{
179
+ success: boolean;
180
+ message: string;
181
+ }>;
182
+ getDebugInfo(executionId: string): Promise<ExecutionDebugInfo>;
183
+ getNodeOutput(executionId: string, nodeName: string, options?: {
184
+ startIndex?: number;
185
+ maxItems?: number;
186
+ }): Promise<NodeOutputResult>;
187
+ }
188
+ export interface CredentialTypeSearchResult {
189
+ type: string;
190
+ displayName: string;
191
+ }
192
+ export interface InstanceAiCredentialService {
193
+ list(options?: {
194
+ type?: string;
195
+ }): Promise<CredentialSummary[]>;
196
+ get(credentialId: string): Promise<CredentialDetail>;
197
+ delete(credentialId: string): Promise<void>;
198
+ test(credentialId: string): Promise<{
199
+ success: boolean;
200
+ message?: string;
201
+ }>;
202
+ isTestable?(credentialType: string): Promise<boolean>;
203
+ getDocumentationUrl?(credentialType: string): Promise<string | null>;
204
+ getCredentialFields?(credentialType: string): CredentialFieldInfo[] | Promise<CredentialFieldInfo[]>;
205
+ searchCredentialTypes?(query: string): Promise<CredentialTypeSearchResult[]>;
206
+ }
207
+ export interface CredentialFieldInfo {
208
+ name: string;
209
+ displayName: string;
210
+ type: string;
211
+ required: boolean;
212
+ description?: string;
213
+ }
214
+ export interface ExploreResourcesParams {
215
+ nodeType: string;
216
+ version: number;
217
+ methodName: string;
218
+ methodType: 'listSearch' | 'loadOptions';
219
+ credentialType: string;
220
+ credentialId: string;
221
+ filter?: string;
222
+ paginationToken?: string;
223
+ currentNodeParameters?: Record<string, unknown>;
224
+ }
225
+ export interface ExploreResourcesResult {
226
+ results: Array<{
227
+ name: string;
228
+ value: string | number | boolean;
229
+ url?: string;
230
+ description?: string;
231
+ }>;
232
+ paginationToken?: unknown;
233
+ }
234
+ export interface InstanceAiNodeService {
235
+ listAvailable(options?: {
236
+ query?: string;
237
+ }): Promise<NodeSummary[]>;
238
+ getDescription(nodeType: string, version?: number): Promise<NodeDescription>;
239
+ listSearchable(): Promise<SearchableNodeDescription[]>;
240
+ getNodeTypeDefinition?(nodeType: string, options?: {
241
+ version?: string;
242
+ resource?: string;
243
+ operation?: string;
244
+ mode?: string;
245
+ }): Promise<{
246
+ content: string;
247
+ version?: string;
248
+ error?: string;
249
+ } | null>;
250
+ listDiscriminators?(nodeType: string): Promise<{
251
+ resources: Array<{
252
+ name: string;
253
+ operations: string[];
254
+ }>;
255
+ } | null>;
256
+ exploreResources?(params: ExploreResourcesParams): Promise<ExploreResourcesResult>;
257
+ getParameterIssues?(nodeType: string, typeVersion: number, parameters: Record<string, unknown>): Promise<Record<string, string[]>>;
258
+ getNodeCredentialTypes?(nodeType: string, typeVersion: number, parameters: Record<string, unknown>, existingCredentials?: Record<string, unknown>): Promise<string[]>;
259
+ }
260
+ export interface SearchableNodeDescription {
261
+ name: string;
262
+ displayName: string;
263
+ description: string;
264
+ version: number | number[];
265
+ inputs: string[] | string;
266
+ outputs: string[] | string;
267
+ codex?: {
268
+ alias?: string[];
269
+ };
270
+ builderHint?: {
271
+ message?: string;
272
+ inputs?: Record<string, {
273
+ required: boolean;
274
+ displayOptions?: Record<string, unknown>;
275
+ }>;
276
+ };
277
+ }
278
+ export interface DataTableSummary {
279
+ id: string;
280
+ name: string;
281
+ projectId?: string;
282
+ columns: Array<{
283
+ id: string;
284
+ name: string;
285
+ type: string;
286
+ }>;
287
+ createdAt: string;
288
+ updatedAt: string;
289
+ }
290
+ export interface DataTableColumnInfo {
291
+ id: string;
292
+ name: string;
293
+ type: 'string' | 'number' | 'boolean' | 'date';
294
+ index: number;
295
+ }
296
+ export interface DataTableFilterInput {
297
+ type: 'and' | 'or';
298
+ filters: Array<{
299
+ columnName: string;
300
+ condition: 'eq' | 'neq' | 'like' | 'gt' | 'gte' | 'lt' | 'lte';
301
+ value: string | number | boolean | null;
302
+ }>;
303
+ }
304
+ export interface InstanceAiDataTableService {
305
+ list(options?: {
306
+ projectId?: string;
307
+ }): Promise<DataTableSummary[]>;
308
+ create(name: string, columns: Array<{
309
+ name: string;
310
+ type: 'string' | 'number' | 'boolean' | 'date';
311
+ }>, options?: {
312
+ projectId?: string;
313
+ }): Promise<DataTableSummary>;
314
+ delete(dataTableId: string): Promise<void>;
315
+ getSchema(dataTableId: string): Promise<DataTableColumnInfo[]>;
316
+ addColumn(dataTableId: string, column: {
317
+ name: string;
318
+ type: 'string' | 'number' | 'boolean' | 'date';
319
+ }): Promise<DataTableColumnInfo>;
320
+ deleteColumn(dataTableId: string, columnId: string): Promise<void>;
321
+ renameColumn(dataTableId: string, columnId: string, newName: string): Promise<void>;
322
+ queryRows(dataTableId: string, options?: {
323
+ filter?: DataTableFilterInput;
324
+ limit?: number;
325
+ offset?: number;
326
+ }): Promise<{
327
+ count: number;
328
+ data: Array<Record<string, unknown>>;
329
+ }>;
330
+ insertRows(dataTableId: string, rows: Array<Record<string, unknown>>): Promise<{
331
+ insertedCount: number;
332
+ }>;
333
+ updateRows(dataTableId: string, filter: DataTableFilterInput, data: Record<string, unknown>): Promise<{
334
+ updatedCount: number;
335
+ }>;
336
+ deleteRows(dataTableId: string, filter: DataTableFilterInput): Promise<{
337
+ deletedCount: number;
338
+ }>;
339
+ }
340
+ export interface FetchedPage {
341
+ url: string;
342
+ finalUrl: string;
343
+ title: string;
344
+ content: string;
345
+ truncated: boolean;
346
+ contentLength: number;
347
+ safetyFlags?: {
348
+ jsRenderingSuspected?: boolean;
349
+ loginRequired?: boolean;
350
+ };
351
+ }
352
+ export interface WebSearchResult {
353
+ title: string;
354
+ url: string;
355
+ snippet: string;
356
+ publishedDate?: string;
357
+ }
358
+ export interface WebSearchResponse {
359
+ query: string;
360
+ results: WebSearchResult[];
361
+ }
362
+ export interface InstanceAiWebResearchService {
363
+ search?(query: string, options?: {
364
+ maxResults?: number;
365
+ includeDomains?: string[];
366
+ excludeDomains?: string[];
367
+ }): Promise<WebSearchResponse>;
368
+ fetchUrl(url: string, options?: {
369
+ maxContentLength?: number;
370
+ maxResponseBytes?: number;
371
+ timeoutMs?: number;
372
+ authorizeUrl?: (url: string) => Promise<void>;
373
+ }): Promise<FetchedPage>;
374
+ }
375
+ export interface FileEntry {
376
+ path: string;
377
+ type: 'file' | 'directory';
378
+ sizeBytes?: number;
379
+ }
380
+ export interface FileContent {
381
+ path: string;
382
+ content: string;
383
+ truncated: boolean;
384
+ totalLines: number;
385
+ }
386
+ export interface FileSearchMatch {
387
+ path: string;
388
+ lineNumber: number;
389
+ line: string;
390
+ }
391
+ export interface FileSearchResult {
392
+ query: string;
393
+ matches: FileSearchMatch[];
394
+ truncated: boolean;
395
+ totalMatches: number;
396
+ }
397
+ export interface InstanceAiFilesystemService {
398
+ listFiles(dirPath: string, opts?: {
399
+ pattern?: string;
400
+ maxResults?: number;
401
+ type?: 'file' | 'directory' | 'all';
402
+ recursive?: boolean;
403
+ }): Promise<FileEntry[]>;
404
+ readFile(filePath: string, opts?: {
405
+ maxLines?: number;
406
+ startLine?: number;
407
+ }): Promise<FileContent>;
408
+ searchFiles(dirPath: string, opts: {
409
+ query: string;
410
+ filePattern?: string;
411
+ ignoreCase?: boolean;
412
+ maxResults?: number;
413
+ }): Promise<FileSearchResult>;
414
+ getFileTree(dirPath: string, opts?: {
415
+ maxDepth?: number;
416
+ exclude?: string[];
417
+ }): Promise<string>;
418
+ }
419
+ export interface LocalMcpServer {
420
+ getAvailableTools(): McpTool[];
421
+ getToolsByCategory(category: string): McpTool[];
422
+ callTool(req: McpToolCallRequest): Promise<McpToolCallResult>;
423
+ }
424
+ export interface ProjectSummary {
425
+ id: string;
426
+ name: string;
427
+ type: 'personal' | 'team';
428
+ }
429
+ export interface FolderSummary {
430
+ id: string;
431
+ name: string;
432
+ parentFolderId: string | null;
433
+ }
434
+ export interface InstanceAiWorkspaceService {
435
+ getProject?(projectId: string): Promise<ProjectSummary | null>;
436
+ listProjects(): Promise<ProjectSummary[]>;
437
+ listFolders?(projectId: string): Promise<FolderSummary[]>;
438
+ createFolder?(name: string, projectId: string, parentFolderId?: string): Promise<FolderSummary>;
439
+ deleteFolder?(folderId: string, projectId: string, transferToFolderId?: string): Promise<void>;
440
+ moveWorkflowToFolder?(workflowId: string, folderId: string): Promise<void>;
441
+ tagWorkflow(workflowId: string, tagNames: string[]): Promise<string[]>;
442
+ listTags(): Promise<Array<{
443
+ id: string;
444
+ name: string;
445
+ }>>;
446
+ createTag(name: string): Promise<{
447
+ id: string;
448
+ name: string;
449
+ }>;
450
+ cleanupTestExecutions(workflowId: string, options?: {
451
+ olderThanHours?: number;
452
+ }): Promise<{
453
+ deletedCount: number;
454
+ }>;
455
+ }
456
+ export type LocalGatewayStatus = {
457
+ status: 'connected';
458
+ } | {
459
+ status: 'disconnected';
460
+ capabilities: string[];
461
+ } | {
462
+ status: 'disabled';
463
+ };
464
+ export interface InstanceAiContext {
465
+ userId: string;
466
+ workflowService: InstanceAiWorkflowService;
467
+ executionService: InstanceAiExecutionService;
468
+ credentialService: InstanceAiCredentialService;
469
+ nodeService: InstanceAiNodeService;
470
+ dataTableService: InstanceAiDataTableService;
471
+ webResearchService?: InstanceAiWebResearchService;
472
+ filesystemService?: InstanceAiFilesystemService;
473
+ workspaceService?: InstanceAiWorkspaceService;
474
+ localMcpServer?: LocalMcpServer;
475
+ localGatewayStatus?: LocalGatewayStatus;
476
+ permissions?: InstanceAiPermissions;
477
+ licenseHints?: string[];
478
+ domainAccessTracker?: DomainAccessTracker;
479
+ runId?: string;
480
+ }
481
+ export interface TaskStorage {
482
+ get(threadId: string): Promise<TaskList | null>;
483
+ save(threadId: string, tasks: TaskList): Promise<void>;
484
+ }
485
+ export type PlannedTaskKind = 'delegate' | 'build-workflow' | 'manage-data-tables' | 'research';
486
+ export interface PlannedTask {
487
+ id: string;
488
+ title: string;
489
+ kind: PlannedTaskKind;
490
+ spec: string;
491
+ deps: string[];
492
+ tools?: string[];
493
+ workflowId?: string;
494
+ }
495
+ export type PlannedTaskStatus = 'planned' | 'running' | 'succeeded' | 'failed' | 'cancelled';
496
+ export interface PlannedTaskRecord extends PlannedTask {
497
+ status: PlannedTaskStatus;
498
+ agentId?: string;
499
+ backgroundTaskId?: string;
500
+ result?: string;
501
+ error?: string;
502
+ outcome?: Record<string, unknown>;
503
+ startedAt?: number;
504
+ finishedAt?: number;
505
+ }
506
+ export type PlannedTaskGraphStatus = 'active' | 'awaiting_replan' | 'completed' | 'cancelled';
507
+ export interface PlannedTaskGraph {
508
+ planRunId: string;
509
+ messageGroupId?: string;
510
+ status: PlannedTaskGraphStatus;
511
+ tasks: PlannedTaskRecord[];
512
+ }
513
+ export type PlannedTaskSchedulerAction = {
514
+ type: 'none';
515
+ graph: PlannedTaskGraph | null;
516
+ } | {
517
+ type: 'dispatch';
518
+ graph: PlannedTaskGraph;
519
+ tasks: PlannedTaskRecord[];
520
+ } | {
521
+ type: 'replan';
522
+ graph: PlannedTaskGraph;
523
+ failedTask: PlannedTaskRecord;
524
+ } | {
525
+ type: 'synthesize';
526
+ graph: PlannedTaskGraph;
527
+ };
528
+ export interface PlannedTaskService {
529
+ createPlan(threadId: string, tasks: PlannedTask[], metadata: {
530
+ planRunId: string;
531
+ messageGroupId?: string;
532
+ }): Promise<PlannedTaskGraph>;
533
+ getGraph(threadId: string): Promise<PlannedTaskGraph | null>;
534
+ markRunning(threadId: string, taskId: string, update: {
535
+ agentId?: string;
536
+ backgroundTaskId?: string;
537
+ startedAt?: number;
538
+ }): Promise<PlannedTaskGraph | null>;
539
+ markSucceeded(threadId: string, taskId: string, update: {
540
+ result?: string;
541
+ outcome?: Record<string, unknown>;
542
+ finishedAt?: number;
543
+ }): Promise<PlannedTaskGraph | null>;
544
+ markFailed(threadId: string, taskId: string, update: {
545
+ error?: string;
546
+ finishedAt?: number;
547
+ }): Promise<PlannedTaskGraph | null>;
548
+ markCancelled(threadId: string, taskId: string, update?: {
549
+ error?: string;
550
+ finishedAt?: number;
551
+ }): Promise<PlannedTaskGraph | null>;
552
+ tick(threadId: string, options?: {
553
+ availableSlots?: number;
554
+ }): Promise<PlannedTaskSchedulerAction>;
555
+ clear(threadId: string): Promise<void>;
556
+ }
557
+ export interface McpServerConfig {
558
+ name: string;
559
+ url?: string;
560
+ command?: string;
561
+ args?: string[];
562
+ env?: Record<string, string>;
563
+ }
564
+ export interface InstanceAiMemoryConfig {
565
+ storage: MastraCompositeStore;
566
+ embedderModel?: string;
567
+ lastMessages?: number;
568
+ semanticRecallTopK?: number;
569
+ threadTtlDays?: number;
570
+ }
571
+ export type ModelConfig = string | {
572
+ id: `${string}/${string}`;
573
+ url: string;
574
+ apiKey?: string;
575
+ headers?: Record<string, string>;
576
+ } | LanguageModelV2;
577
+ export interface ServiceProxyConfig {
578
+ apiUrl: string;
579
+ headers: Record<string, string>;
580
+ }
581
+ export interface InstanceAiTraceRun {
582
+ id: string;
583
+ name: string;
584
+ runType: string;
585
+ projectName: string;
586
+ startTime: number;
587
+ endTime?: number;
588
+ traceId: string;
589
+ dottedOrder: string;
590
+ executionOrder: number;
591
+ childExecutionOrder: number;
592
+ parentRunId?: string;
593
+ tags?: string[];
594
+ metadata?: Record<string, unknown>;
595
+ inputs?: Record<string, unknown>;
596
+ outputs?: Record<string, unknown>;
597
+ error?: string;
598
+ }
599
+ export interface InstanceAiTraceRunInit {
600
+ name: string;
601
+ runType?: string;
602
+ tags?: string[];
603
+ metadata?: Record<string, unknown>;
604
+ inputs?: unknown;
605
+ }
606
+ export interface InstanceAiTraceRunFinishOptions {
607
+ outputs?: unknown;
608
+ metadata?: Record<string, unknown>;
609
+ error?: string;
610
+ }
611
+ export interface InstanceAiToolTraceOptions {
612
+ agentRole?: string;
613
+ tags?: string[];
614
+ metadata?: Record<string, unknown>;
615
+ }
616
+ export interface InstanceAiTraceContext {
617
+ projectName: string;
618
+ traceKind: 'message_turn' | 'detached_subagent';
619
+ rootRun: InstanceAiTraceRun;
620
+ actorRun: InstanceAiTraceRun;
621
+ messageRun: InstanceAiTraceRun;
622
+ orchestratorRun: InstanceAiTraceRun;
623
+ startChildRun: (parentRun: InstanceAiTraceRun, options: InstanceAiTraceRunInit) => Promise<InstanceAiTraceRun>;
624
+ withRunTree: <T>(run: InstanceAiTraceRun, fn: () => Promise<T>) => Promise<T>;
625
+ finishRun: (run: InstanceAiTraceRun, options?: InstanceAiTraceRunFinishOptions) => Promise<void>;
626
+ failRun: (run: InstanceAiTraceRun, error: unknown, metadata?: Record<string, unknown>) => Promise<void>;
627
+ toHeaders: (run: InstanceAiTraceRun) => Record<string, string>;
628
+ wrapTools: (tools: ToolsInput, options?: InstanceAiToolTraceOptions) => ToolsInput;
629
+ }
630
+ export interface BackgroundTaskResult {
631
+ text: string;
632
+ outcome?: Record<string, unknown>;
633
+ }
634
+ export interface SpawnBackgroundTaskOptions {
635
+ taskId: string;
636
+ threadId: string;
637
+ agentId: string;
638
+ role: string;
639
+ traceContext?: InstanceAiTraceContext;
640
+ plannedTaskId?: string;
641
+ workItemId?: string;
642
+ run: (signal: AbortSignal, drainCorrections: () => string[]) => Promise<string | BackgroundTaskResult>;
643
+ }
644
+ export interface WorkflowTaskService {
645
+ reportBuildOutcome(outcome: WorkflowBuildOutcome): Promise<WorkflowLoopAction>;
646
+ reportVerificationVerdict(verdict: VerificationResult): Promise<WorkflowLoopAction>;
647
+ getBuildOutcome(workItemId: string): Promise<WorkflowBuildOutcome | undefined>;
648
+ updateBuildOutcome(workItemId: string, update: Partial<WorkflowBuildOutcome>): Promise<void>;
649
+ }
650
+ export interface OrchestrationContext {
651
+ threadId: string;
652
+ runId: string;
653
+ messageGroupId?: string;
654
+ userId: string;
655
+ orchestratorAgentId: string;
656
+ modelId: ModelConfig;
657
+ storage: MastraCompositeStore;
658
+ subAgentMaxSteps: number;
659
+ eventBus: InstanceAiEventBus;
660
+ domainTools: ToolsInput;
661
+ abortSignal: AbortSignal;
662
+ taskStorage: TaskStorage;
663
+ tracing?: InstanceAiTraceContext;
664
+ waitForConfirmation?: (requestId: string) => Promise<{
665
+ approved: boolean;
666
+ credentialId?: string;
667
+ credentials?: Record<string, string>;
668
+ autoSetup?: {
669
+ credentialType: string;
670
+ };
671
+ userInput?: string;
672
+ domainAccessAction?: string;
673
+ answers?: Array<{
674
+ questionId: string;
675
+ selectedOptions: string[];
676
+ customText?: string;
677
+ skipped?: boolean;
678
+ }>;
679
+ }>;
680
+ browserMcpConfig?: McpServerConfig;
681
+ localMcpServer?: LocalMcpServer;
682
+ mcpTools?: ToolsInput;
683
+ oauth2CallbackUrl?: string;
684
+ webhookBaseUrl?: string;
685
+ spawnBackgroundTask?: (opts: SpawnBackgroundTaskOptions) => void;
686
+ cancelBackgroundTask?: (taskId: string) => Promise<void>;
687
+ plannedTaskService?: PlannedTaskService;
688
+ schedulePlannedTasks?: () => Promise<void>;
689
+ workspace?: Workspace;
690
+ builderSandboxFactory?: BuilderSandboxFactory;
691
+ nodeDefinitionDirs?: string[];
692
+ domainContext?: InstanceAiContext;
693
+ researchMode?: boolean;
694
+ iterationLog?: IterationLog;
695
+ sendCorrectionToTask?: (taskId: string, correction: string) => 'queued' | 'task-completed' | 'task-not-found';
696
+ workflowTaskService?: WorkflowTaskService;
697
+ tracingProxyConfig?: ServiceProxyConfig;
698
+ }
699
+ export interface CreateInstanceAgentOptions {
700
+ modelId: ModelConfig;
701
+ context: InstanceAiContext;
702
+ orchestrationContext?: OrchestrationContext;
703
+ mcpServers?: McpServerConfig[];
704
+ memoryConfig: InstanceAiMemoryConfig;
705
+ memory?: Memory;
706
+ workspace?: Workspace;
707
+ disableDeferredTools?: boolean;
708
+ timeZone?: string;
709
+ }
package/dist/types.js ADDED
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}