@mastra/agent-builder 0.0.0-iterate-traces-ui-again-20250912091900 → 0.0.0-main-test-20251105183450

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 (28) hide show
  1. package/CHANGELOG.md +318 -4
  2. package/README.md +0 -4
  3. package/dist/agent/index.d.ts +5 -7
  4. package/dist/agent/index.d.ts.map +1 -1
  5. package/dist/defaults.d.ts +87 -1685
  6. package/dist/defaults.d.ts.map +1 -1
  7. package/dist/index.js +242 -264
  8. package/dist/index.js.map +1 -1
  9. package/dist/processors/tool-summary.d.ts.map +1 -1
  10. package/dist/types.d.ts +2 -2
  11. package/dist/utils.d.ts +5 -5
  12. package/dist/utils.d.ts.map +1 -1
  13. package/dist/workflows/shared/schema.d.ts +2 -2
  14. package/dist/workflows/task-planning/schema.d.ts +10 -10
  15. package/dist/workflows/task-planning/task-planning.d.ts +31 -19
  16. package/dist/workflows/task-planning/task-planning.d.ts.map +1 -1
  17. package/dist/workflows/template-builder/template-builder.d.ts +119 -21
  18. package/dist/workflows/template-builder/template-builder.d.ts.map +1 -1
  19. package/dist/workflows/workflow-builder/prompts.d.ts +1 -1
  20. package/dist/workflows/workflow-builder/prompts.d.ts.map +1 -1
  21. package/dist/workflows/workflow-builder/schema.d.ts +16 -16
  22. package/dist/workflows/workflow-builder/tools.d.ts +3 -179
  23. package/dist/workflows/workflow-builder/tools.d.ts.map +1 -1
  24. package/dist/workflows/workflow-builder/workflow-builder.d.ts +84 -52
  25. package/dist/workflows/workflow-builder/workflow-builder.d.ts.map +1 -1
  26. package/dist/workflows/workflow-map.d.ts +2 -3767
  27. package/dist/workflows/workflow-map.d.ts.map +1 -1
  28. package/package.json +10 -10
package/dist/workflows/template-builder/template-builder.d.ts CHANGED
@@ -1,5 +1,9 @@
1
1
  import { z } from 'zod';
2
- export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflows").Workflow<import("@mastra/core").DefaultEngineType, (import("@mastra/core").Step<"clone-template", z.ZodObject<{
2
+ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflows").Workflow<import("@mastra/core/workflows").DefaultEngineType, (import("@mastra/core/workflows").Step<"clone-template", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
3
+ [x: string]: any;
4
+ }, {
5
+ [x: string]: any;
6
+ }>, z.ZodObject<{
3
7
  repo: z.ZodString;
4
8
  ref: z.ZodOptional<z.ZodString>;
5
9
  slug: z.ZodOptional<z.ZodString>;
@@ -38,7 +42,11 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
38
42
  targetPath?: string | undefined;
39
43
  success?: boolean | undefined;
40
44
  error?: string | undefined;
41
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"analyze-package", z.ZodObject<{
45
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"analyze-package", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
46
+ [x: string]: any;
47
+ }, {
48
+ [x: string]: any;
49
+ }>, z.ZodObject<{
42
50
  templateDir: z.ZodString;
43
51
  commitSha: z.ZodString;
44
52
  slug: z.ZodString;
@@ -89,7 +97,11 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
89
97
  devDependencies?: Record<string, string> | undefined;
90
98
  peerDependencies?: Record<string, string> | undefined;
91
99
  scripts?: Record<string, string> | undefined;
92
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"discover-units", z.ZodObject<{
100
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"discover-units", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
101
+ [x: string]: any;
102
+ }, {
103
+ [x: string]: any;
104
+ }>, z.ZodObject<{
93
105
  templateDir: z.ZodString;
94
106
  commitSha: z.ZodString;
95
107
  slug: z.ZodString;
@@ -142,7 +154,11 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
142
154
  }[];
143
155
  success?: boolean | undefined;
144
156
  error?: string | undefined;
145
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"order-units", z.ZodObject<{
157
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"order-units", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
158
+ [x: string]: any;
159
+ }, {
160
+ [x: string]: any;
161
+ }>, z.ZodObject<{
146
162
  units: z.ZodArray<z.ZodObject<{
147
163
  kind: z.ZodEnum<["mcp-server", "tool", "workflow", "agent", "integration", "network", "other"]>;
148
164
  id: z.ZodString;
@@ -206,7 +222,11 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
206
222
  }[];
207
223
  success?: boolean | undefined;
208
224
  error?: string | undefined;
209
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"package-merge", z.ZodObject<{
225
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"package-merge", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
226
+ [x: string]: any;
227
+ }, {
228
+ [x: string]: any;
229
+ }>, z.ZodObject<{
210
230
  commitSha: z.ZodString;
211
231
  slug: z.ZodString;
212
232
  targetPath: z.ZodOptional<z.ZodString>;
@@ -286,7 +306,11 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
286
306
  success: boolean;
287
307
  applied: boolean;
288
308
  error?: string | undefined;
289
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"install", z.ZodObject<{
309
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"install", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
310
+ [x: string]: any;
311
+ }, {
312
+ [x: string]: any;
313
+ }>, z.ZodObject<{
290
314
  targetPath: z.ZodString;
291
315
  }, "strip", z.ZodTypeAny, {
292
316
  targetPath: string;
@@ -301,7 +325,11 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
301
325
  }, {
302
326
  success: boolean;
303
327
  error?: string | undefined;
304
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"programmatic-file-copy", z.ZodObject<{
328
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"programmatic-file-copy", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
329
+ [x: string]: any;
330
+ }, {
331
+ [x: string]: any;
332
+ }>, z.ZodObject<{
305
333
  orderedUnits: z.ZodArray<z.ZodObject<{
306
334
  kind: z.ZodEnum<["mcp-server", "tool", "workflow", "agent", "integration", "network", "other"]>;
307
335
  id: z.ZodString;
@@ -447,7 +475,11 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
447
475
  targetFile: string;
448
476
  }[];
449
477
  error?: string | undefined;
450
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"intelligent-merge", z.ZodObject<{
478
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"intelligent-merge", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
479
+ [x: string]: any;
480
+ }, {
481
+ [x: string]: any;
482
+ }>, z.ZodObject<{
451
483
  conflicts: z.ZodArray<z.ZodObject<{
452
484
  unit: z.ZodObject<{
453
485
  kind: z.ZodEnum<["mcp-server", "tool", "workflow", "agent", "integration", "network", "other"]>;
@@ -617,7 +649,11 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
617
649
  resolution: string;
618
650
  }[];
619
651
  error?: string | undefined;
620
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"validation-and-fix", z.ZodObject<{
652
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"validation-and-fix", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
653
+ [x: string]: any;
654
+ }, {
655
+ [x: string]: any;
656
+ }>, z.ZodObject<{
621
657
  commitSha: z.ZodString;
622
658
  slug: z.ZodString;
623
659
  targetPath: z.ZodOptional<z.ZodString>;
@@ -789,7 +825,11 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
789
825
  errors?: any[] | undefined;
790
826
  };
791
827
  error?: string | undefined;
792
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType>)[], "agent-builder-template", z.ZodObject<{
828
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType>)[], "agent-builder-template", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
829
+ [x: string]: any;
830
+ }, {
831
+ [x: string]: any;
832
+ }>, z.ZodObject<{
793
833
  repo: z.ZodString;
794
834
  ref: z.ZodOptional<z.ZodString>;
795
835
  slug: z.ZodOptional<z.ZodString>;
@@ -1052,7 +1092,29 @@ export declare const agentBuilderTemplateWorkflow: import("@mastra/core/workflow
1052
1092
  validationSuccess?: boolean | undefined;
1053
1093
  } | undefined;
1054
1094
  }>>;
1055
- export declare function mergeTemplateBySlug(slug: string, targetPath?: string): Promise<import("@mastra/core").WorkflowResult<z.ZodObject<{
1095
+ export declare function mergeTemplateBySlug(slug: string, targetPath?: string): Promise<import("@mastra/core/workflows").WorkflowResult<z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1096
+ [x: string]: any;
1097
+ }, {
1098
+ [x: string]: any;
1099
+ }>, z.ZodObject<{
1100
+ repo: z.ZodString;
1101
+ ref: z.ZodOptional<z.ZodString>;
1102
+ slug: z.ZodOptional<z.ZodString>;
1103
+ targetPath: z.ZodOptional<z.ZodString>;
1104
+ variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1105
+ }, "strip", z.ZodTypeAny, {
1106
+ repo: string;
1107
+ slug?: string | undefined;
1108
+ ref?: string | undefined;
1109
+ targetPath?: string | undefined;
1110
+ variables?: Record<string, string> | undefined;
1111
+ }, {
1112
+ repo: string;
1113
+ slug?: string | undefined;
1114
+ ref?: string | undefined;
1115
+ targetPath?: string | undefined;
1116
+ variables?: Record<string, string> | undefined;
1117
+ }>, z.ZodObject<{
1056
1118
  success: z.ZodBoolean;
1057
1119
  applied: z.ZodBoolean;
1058
1120
  branchName: z.ZodOptional<z.ZodString>;
@@ -1174,7 +1236,11 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1174
1236
  mergeSuccess?: boolean | undefined;
1175
1237
  validationSuccess?: boolean | undefined;
1176
1238
  } | undefined;
1177
- }>, (import("@mastra/core").Step<"clone-template", z.ZodObject<{
1239
+ }>, (import("@mastra/core/workflows").Step<"clone-template", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1240
+ [x: string]: any;
1241
+ }, {
1242
+ [x: string]: any;
1243
+ }>, z.ZodObject<{
1178
1244
  repo: z.ZodString;
1179
1245
  ref: z.ZodOptional<z.ZodString>;
1180
1246
  slug: z.ZodOptional<z.ZodString>;
@@ -1213,7 +1279,11 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1213
1279
  targetPath?: string | undefined;
1214
1280
  success?: boolean | undefined;
1215
1281
  error?: string | undefined;
1216
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"analyze-package", z.ZodObject<{
1282
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"analyze-package", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1283
+ [x: string]: any;
1284
+ }, {
1285
+ [x: string]: any;
1286
+ }>, z.ZodObject<{
1217
1287
  templateDir: z.ZodString;
1218
1288
  commitSha: z.ZodString;
1219
1289
  slug: z.ZodString;
@@ -1264,7 +1334,11 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1264
1334
  devDependencies?: Record<string, string> | undefined;
1265
1335
  peerDependencies?: Record<string, string> | undefined;
1266
1336
  scripts?: Record<string, string> | undefined;
1267
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"discover-units", z.ZodObject<{
1337
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"discover-units", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1338
+ [x: string]: any;
1339
+ }, {
1340
+ [x: string]: any;
1341
+ }>, z.ZodObject<{
1268
1342
  templateDir: z.ZodString;
1269
1343
  commitSha: z.ZodString;
1270
1344
  slug: z.ZodString;
@@ -1317,7 +1391,11 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1317
1391
  }[];
1318
1392
  success?: boolean | undefined;
1319
1393
  error?: string | undefined;
1320
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"order-units", z.ZodObject<{
1394
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"order-units", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1395
+ [x: string]: any;
1396
+ }, {
1397
+ [x: string]: any;
1398
+ }>, z.ZodObject<{
1321
1399
  units: z.ZodArray<z.ZodObject<{
1322
1400
  kind: z.ZodEnum<["mcp-server", "tool", "workflow", "agent", "integration", "network", "other"]>;
1323
1401
  id: z.ZodString;
@@ -1381,7 +1459,11 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1381
1459
  }[];
1382
1460
  success?: boolean | undefined;
1383
1461
  error?: string | undefined;
1384
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"package-merge", z.ZodObject<{
1462
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"package-merge", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1463
+ [x: string]: any;
1464
+ }, {
1465
+ [x: string]: any;
1466
+ }>, z.ZodObject<{
1385
1467
  commitSha: z.ZodString;
1386
1468
  slug: z.ZodString;
1387
1469
  targetPath: z.ZodOptional<z.ZodString>;
@@ -1461,7 +1543,11 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1461
1543
  success: boolean;
1462
1544
  applied: boolean;
1463
1545
  error?: string | undefined;
1464
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"install", z.ZodObject<{
1546
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"install", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1547
+ [x: string]: any;
1548
+ }, {
1549
+ [x: string]: any;
1550
+ }>, z.ZodObject<{
1465
1551
  targetPath: z.ZodString;
1466
1552
  }, "strip", z.ZodTypeAny, {
1467
1553
  targetPath: string;
@@ -1476,7 +1562,11 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1476
1562
  }, {
1477
1563
  success: boolean;
1478
1564
  error?: string | undefined;
1479
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"programmatic-file-copy", z.ZodObject<{
1565
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"programmatic-file-copy", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1566
+ [x: string]: any;
1567
+ }, {
1568
+ [x: string]: any;
1569
+ }>, z.ZodObject<{
1480
1570
  orderedUnits: z.ZodArray<z.ZodObject<{
1481
1571
  kind: z.ZodEnum<["mcp-server", "tool", "workflow", "agent", "integration", "network", "other"]>;
1482
1572
  id: z.ZodString;
@@ -1622,7 +1712,11 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1622
1712
  targetFile: string;
1623
1713
  }[];
1624
1714
  error?: string | undefined;
1625
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"intelligent-merge", z.ZodObject<{
1715
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"intelligent-merge", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1716
+ [x: string]: any;
1717
+ }, {
1718
+ [x: string]: any;
1719
+ }>, z.ZodObject<{
1626
1720
  conflicts: z.ZodArray<z.ZodObject<{
1627
1721
  unit: z.ZodObject<{
1628
1722
  kind: z.ZodEnum<["mcp-server", "tool", "workflow", "agent", "integration", "network", "other"]>;
@@ -1792,7 +1886,11 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1792
1886
  resolution: string;
1793
1887
  }[];
1794
1888
  error?: string | undefined;
1795
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType> | import("@mastra/core").Step<"validation-and-fix", z.ZodObject<{
1889
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType> | import("@mastra/core/workflows").Step<"validation-and-fix", z.ZodObject<any, z.UnknownKeysParam, z.ZodTypeAny, {
1890
+ [x: string]: any;
1891
+ }, {
1892
+ [x: string]: any;
1893
+ }>, z.ZodObject<{
1796
1894
  commitSha: z.ZodString;
1797
1895
  slug: z.ZodString;
1798
1896
  targetPath: z.ZodOptional<z.ZodString>;
@@ -1964,5 +2062,5 @@ export declare function mergeTemplateBySlug(slug: string, targetPath?: string):
1964
2062
  errors?: any[] | undefined;
1965
2063
  };
1966
2064
  error?: string | undefined;
1967
- }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core").DefaultEngineType>)[]>>;
2065
+ }>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, import("@mastra/core/workflows").DefaultEngineType>)[]>>;
1968
2066
  //# sourceMappingURL=template-builder.d.ts.map
package/dist/workflows/template-builder/template-builder.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"template-builder.d.ts","sourceRoot":"","sources":["../../../src/workflows/template-builder/template-builder.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0gDxB,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0N9B,CAAC;AAGZ,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yHAU1E"}
1
+ {"version":3,"file":"template-builder.d.ts","sourceRoot":"","sources":["../../../src/workflows/template-builder/template-builder.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAghDxB,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0N9B,CAAC;AAGZ,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mIAU1E"}
package/dist/workflows/workflow-builder/prompts.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export declare const workflowResearch = "\n## \uD83D\uDD0D **COMPREHENSIVE MASTRA WORKFLOW RESEARCH SUMMARY**\n\nBased on extensive research of Mastra documentation and examples, here's essential information for building effective Mastra workflows:\n\n### **\uD83D\uDCCB WORKFLOW FUNDAMENTALS**\n\n**Core Components:**\n- **`createWorkflow()`**: Main factory function that creates workflow instances\n- **`createStep()`**: Creates individual workflow steps with typed inputs/outputs \n- **`.commit()`**: Finalizes workflow definition (REQUIRED to make workflows executable)\n- **Zod schemas**: Used for strict input/output typing and validation\n\n**Basic Structure:**\n```typescript\nimport { createWorkflow, createStep } from \"@mastra/core/workflows\";\nimport { z } from \"zod\";\n\nconst workflow = createWorkflow({\n id: \"unique-workflow-id\", // Required: kebab-case recommended\n description: \"What this workflow does\", // Optional but recommended\n inputSchema: z.object({...}), // Required: Defines workflow inputs\n outputSchema: z.object({...}) // Required: Defines final outputs\n})\n .then(step1) // Chain steps sequentially\n .then(step2)\n .commit(); // CRITICAL: Makes workflow executable\n```\n\n### **\uD83D\uDD27 STEP CREATION PATTERNS**\n\n**Standard Step Definition:**\n```typescript\nconst myStep = createStep({\n id: \"step-id\", // Required: unique identifier\n description: \"Step description\", // Recommended for clarity\n inputSchema: z.object({...}), // Required: input validation\n outputSchema: z.object({...}), // Required: output validation\n execute: async ({ inputData, mastra, getStepResult, getInitData }) => {\n // Step logic here\n return { /* matches outputSchema */ };\n }\n});\n```\n\n**Execute Function Parameters:**\n- `inputData`: Validated input matching inputSchema\n- `mastra`: Access to Mastra instance (agents, tools, other workflows)\n- `getStepResult(stepInstance)`: Get results from previous steps\n- `getInitData()`: Access original workflow input data\n- `runtimeContext`: Runtime dependency injection context\n- `runCount`: Number of times this step has run (useful for retries)\n\n### **\uD83D\uDD04 CONTROL FLOW METHODS**\n\n**Sequential Execution:**\n- `.then(step)`: Execute steps one after another\n- Data flows automatically if schemas match\n\n**Parallel Execution:**\n- `.parallel([step1, step2])`: Run steps simultaneously\n- All parallel steps complete before continuing\n\n**Conditional Logic:**\n- `.branch([[condition, step], [condition, step]])`: Execute different steps based on conditions\n- Conditions evaluated sequentially, matching steps run in parallel\n\n**Loops:**\n- `.dountil(step, condition)`: Repeat until condition becomes true\n- `.dowhile(step, condition)`: Repeat while condition is true \n- `.foreach(step, {concurrency: N})`: Execute step for each array item\n\n**Data Transformation:**\n- `.map(({ inputData, getStepResult, getInitData }) => transformedData)`: Transform data between steps\n\n### **\u23F8\uFE0F SUSPEND & RESUME CAPABILITIES**\n\n**For Human-in-the-Loop Workflows:**\n```typescript\nconst userInputStep = createStep({\n id: \"user-input\",\n suspendSchema: z.object({}), // Schema for suspension payload\n resumeSchema: z.object({ // Schema for resume data\n userResponse: z.string()\n }),\n execute: async ({ resumeData, suspend }) => {\n if (!resumeData?.userResponse) {\n await suspend({}); // Pause workflow\n return { response: \"\" };\n }\n return { response: resumeData.userResponse };\n }\n});\n```\n\n**Resume Workflow:**\n```typescript\nconst result = await run.start({ inputData: {...} });\nif (result.status === \"suspended\") {\n await run.resume({\n step: result.suspended[0], // Or specific step ID\n resumeData: { userResponse: \"answer\" }\n });\n}\n```\n\n### **\uD83D\uDEE0\uFE0F INTEGRATING AGENTS & TOOLS**\n\n**Using Agents in Steps:**\n```typescript\n// Method 1: Agent as step\nconst agentStep = createStep(myAgent);\n\n// Method 2: Call agent in execute function\nconst step = createStep({\n execute: async ({ inputData }) => {\n const result = await myAgent.generate(prompt);\n return { output: result.text };\n }\n});\n```\n\n**Using Tools in Steps:**\n```typescript\n// Method 1: Tool as step \nconst toolStep = createStep(myTool);\n\n// Method 2: Call tool in execute function\nconst step = createStep({\n execute: async ({ inputData, runtimeContext }) => {\n const result = await myTool.execute({\n context: inputData,\n runtimeContext\n });\n return result;\n }\n});\n```\n\n### **\uD83D\uDDC2\uFE0F PROJECT ORGANIZATION PATTERNS**\n\n**MANDATORY Workflow Organization:**\nEach workflow MUST be organized in its own dedicated folder with separated concerns:\n\n```\nsrc/mastra/workflows/\n\u251C\u2500\u2500 my-workflow-name/ # Kebab-case folder name\n\u2502 \u251C\u2500\u2500 types.ts # All Zod schemas and TypeScript types\n\u2502 \u251C\u2500\u2500 steps.ts # All individual step definitions\n\u2502 \u251C\u2500\u2500 workflow.ts # Main workflow composition and export\n\u2502 \u2514\u2500\u2500 utils.ts # Helper functions (if needed)\n\u251C\u2500\u2500 another-workflow/\n\u2502 \u251C\u2500\u2500 types.ts\n\u2502 \u251C\u2500\u2500 steps.ts\n\u2502 \u251C\u2500\u2500 workflow.ts\n\u2502 \u2514\u2500\u2500 utils.ts\n\u2514\u2500\u2500 index.ts # Export all workflows\n```\n\n**CRITICAL File Organization Rules:**\n- **ALWAYS create a dedicated folder** for each workflow\n- **Folder names MUST be kebab-case** version of workflow name\n- **types.ts**: Define all input/output schemas, validation types, and interfaces\n- **steps.ts**: Create all individual step definitions using createStep()\n- **workflow.ts**: Compose steps into workflow using createWorkflow() and export the final workflow\n- **utils.ts**: Any helper functions, constants, or utilities (create only if needed)\n- **NEVER put everything in one file** - always separate concerns properly\n\n**Workflow Registration:**\n```typescript\n// src/mastra/index.ts\nexport const mastra = new Mastra({\n workflows: {\n sendEmailWorkflow, // Use camelCase for keys\n dataProcessingWorkflow\n },\n storage: new LibSQLStore({ url: 'file:./mastra.db' }), // Required for suspend/resume\n});\n```\n\n### **\uD83D\uDCE6 ESSENTIAL DEPENDENCIES**\n\n**Required Packages:**\n```json\n{\n \"dependencies\": {\n \"@mastra/core\": \"latest\",\n \"zod\": \"^3.25.67\"\n }\n}\n```\n\n**Additional Packages (as needed):**\n- `@mastra/libsql`: For workflow state persistence\n- `@ai-sdk/openai`: For AI model integration\n- `ai`: For AI SDK functionality\n\n### **\u2705 WORKFLOW BEST PRACTICES**\n\n**Schema Design:**\n- Use descriptive property names in schemas\n- Make schemas as specific as possible (avoid `z.any()`)\n- Include validation for required business logic\n\n**Error Handling:**\n- Use `try/catch` blocks in step execute functions\n- Return meaningful error messages\n- Consider using `bail()` for early successful exits\n\n**Step Organization:**\n- Keep steps focused on single responsibilities\n- Use descriptive step IDs (kebab-case recommended)\n- Create reusable steps for common operations\n\n**Data Flow:**\n- Use `.map()` when schemas don't align between steps\n- Access previous step results with `getStepResult(stepInstance)`\n- Use `getInitData()` to access original workflow input\n\n### **\uD83D\uDE80 EXECUTION PATTERNS**\n\n**Running Workflows:**\n```typescript\n// Create and start run\nconst run = await workflow.createRunAsync();\nconst result = await run.start({ inputData: {...} });\n\n// Stream execution for real-time monitoring\nconst stream = await run.streamVNext({ inputData: {...} });\nfor await (const chunk of stream) {\n console.log(chunk);\n}\n\n// Watch for events\nrun.watch((event) => console.log(event));\n```\n\n**Workflow Status Types:**\n- `\"success\"`: Completed successfully\n- `\"suspended\"`: Paused awaiting input\n- `\"failed\"`: Encountered error\n\n### **\uD83D\uDD17 ADVANCED FEATURES**\n\n**Nested Workflows:**\n- Use workflows as steps: `.then(otherWorkflow)`\n- Enable complex workflow composition\n\n**Runtime Context:**\n- Pass shared data across all steps\n- Enable dependency injection patterns\n\n**Streaming & Events:**\n- Real-time workflow monitoring\n- Integration with external event systems\n\n**Cloning:**\n- `cloneWorkflow(original, {id: \"new-id\"})`: Reuse workflow structure\n- `cloneStep(original, {id: \"new-id\"})`: Reuse step logic\n\nThis comprehensive research provides the foundation for creating robust, maintainable Mastra workflows with proper typing, error handling, and architectural patterns.\n";
1
+ export declare const workflowResearch = "\n## \uD83D\uDD0D **COMPREHENSIVE MASTRA WORKFLOW RESEARCH SUMMARY**\n\nBased on extensive research of Mastra documentation and examples, here's essential information for building effective Mastra workflows:\n\n### **\uD83D\uDCCB WORKFLOW FUNDAMENTALS**\n\n**Core Components:**\n- **`createWorkflow()`**: Main factory function that creates workflow instances\n- **`createStep()`**: Creates individual workflow steps with typed inputs/outputs \n- **`.commit()`**: Finalizes workflow definition (REQUIRED to make workflows executable)\n- **Zod schemas**: Used for strict input/output typing and validation\n\n**Basic Structure:**\n```typescript\nimport { createWorkflow, createStep } from \"@mastra/core/workflows\";\nimport { z } from \"zod\";\n\nconst workflow = createWorkflow({\n id: \"unique-workflow-id\", // Required: kebab-case recommended\n description: \"What this workflow does\", // Optional but recommended\n inputSchema: z.object({...}), // Required: Defines workflow inputs\n outputSchema: z.object({...}) // Required: Defines final outputs\n})\n .then(step1) // Chain steps sequentially\n .then(step2)\n .commit(); // CRITICAL: Makes workflow executable\n```\n\n### **\uD83D\uDD27 STEP CREATION PATTERNS**\n\n**Standard Step Definition:**\n```typescript\nconst myStep = createStep({\n id: \"step-id\", // Required: unique identifier\n description: \"Step description\", // Recommended for clarity\n inputSchema: z.object({...}), // Required: input validation\n outputSchema: z.object({...}), // Required: output validation\n execute: async ({ inputData, mastra, getStepResult, getInitData }) => {\n // Step logic here\n return { /* matches outputSchema */ };\n }\n});\n```\n\n**Execute Function Parameters:**\n- `inputData`: Validated input matching inputSchema\n- `mastra`: Access to Mastra instance (agents, tools, other workflows)\n- `getStepResult(stepInstance)`: Get results from previous steps\n- `getInitData()`: Access original workflow input data\n- `requestContext`: Runtime dependency injection context\n- `runCount`: Number of times this step has run (useful for retries)\n\n### **\uD83D\uDD04 CONTROL FLOW METHODS**\n\n**Sequential Execution:**\n- `.then(step)`: Execute steps one after another\n- Data flows automatically if schemas match\n\n**Parallel Execution:**\n- `.parallel([step1, step2])`: Run steps simultaneously\n- All parallel steps complete before continuing\n\n**Conditional Logic:**\n- `.branch([[condition, step], [condition, step]])`: Execute different steps based on conditions\n- Conditions evaluated sequentially, matching steps run in parallel\n\n**Loops:**\n- `.dountil(step, condition)`: Repeat until condition becomes true\n- `.dowhile(step, condition)`: Repeat while condition is true \n- `.foreach(step, {concurrency: N})`: Execute step for each array item\n\n**Data Transformation:**\n- `.map(({ inputData, getStepResult, getInitData }) => transformedData)`: Transform data between steps\n\n### **\u23F8\uFE0F SUSPEND & RESUME CAPABILITIES**\n\n**For Human-in-the-Loop Workflows:**\n```typescript\nconst userInputStep = createStep({\n id: \"user-input\",\n suspendSchema: z.object({}), // Schema for suspension payload\n resumeSchema: z.object({ // Schema for resume data\n userResponse: z.string()\n }),\n execute: async ({ resumeData, suspend }) => {\n if (!resumeData?.userResponse) {\n await suspend({}); // Pause workflow\n return { response: \"\" };\n }\n return { response: resumeData.userResponse };\n }\n});\n```\n\n**Resume Workflow:**\n```typescript\nconst result = await run.start({ inputData: {...} });\nif (result.status === \"suspended\") {\n await run.resume({\n step: result.suspended[0], // Or specific step ID\n resumeData: { userResponse: \"answer\" }\n });\n}\n```\n\n### **\uD83D\uDEE0\uFE0F INTEGRATING AGENTS & TOOLS**\n\n**Using Agents in Steps:**\n```typescript\n// Method 1: Agent as step\nconst agentStep = createStep(myAgent);\n\n// Method 2: Call agent in execute function\nconst step = createStep({\n execute: async ({ inputData }) => {\n const result = await myAgent.generate(prompt);\n return { output: result.text };\n }\n});\n```\n\n**Using Tools in Steps:**\n```typescript\n// Method 1: Tool as step \nconst toolStep = createStep(myTool);\n\n// Method 2: Call tool in execute function\nconst step = createStep({\n execute: async ({ inputData, requestContext }) => {\n const result = await myTool.execute({\n context: inputData,\n requestContext\n });\n return result;\n }\n});\n```\n\n### **\uD83D\uDDC2\uFE0F PROJECT ORGANIZATION PATTERNS**\n\n**MANDATORY Workflow Organization:**\nEach workflow MUST be organized in its own dedicated folder with separated concerns:\n\n```\nsrc/mastra/workflows/\n\u251C\u2500\u2500 my-workflow-name/ # Kebab-case folder name\n\u2502 \u251C\u2500\u2500 types.ts # All Zod schemas and TypeScript types\n\u2502 \u251C\u2500\u2500 steps.ts # All individual step definitions\n\u2502 \u251C\u2500\u2500 workflow.ts # Main workflow composition and export\n\u2502 \u2514\u2500\u2500 utils.ts # Helper functions (if needed)\n\u251C\u2500\u2500 another-workflow/\n\u2502 \u251C\u2500\u2500 types.ts\n\u2502 \u251C\u2500\u2500 steps.ts\n\u2502 \u251C\u2500\u2500 workflow.ts\n\u2502 \u2514\u2500\u2500 utils.ts\n\u2514\u2500\u2500 index.ts # Export all workflows\n```\n\n**CRITICAL File Organization Rules:**\n- **ALWAYS create a dedicated folder** for each workflow\n- **Folder names MUST be kebab-case** version of workflow name\n- **types.ts**: Define all input/output schemas, validation types, and interfaces\n- **steps.ts**: Create all individual step definitions using createStep()\n- **workflow.ts**: Compose steps into workflow using createWorkflow() and export the final workflow\n- **utils.ts**: Any helper functions, constants, or utilities (create only if needed)\n- **NEVER put everything in one file** - always separate concerns properly\n\n**Workflow Registration:**\n```typescript\n// src/mastra/index.ts\nexport const mastra = new Mastra({\n workflows: {\n sendEmailWorkflow, // Use camelCase for keys\n dataProcessingWorkflow\n },\n storage: new LibSQLStore({ url: 'file:./mastra.db' }), // Required for suspend/resume\n});\n```\n\n### **\uD83D\uDCE6 ESSENTIAL DEPENDENCIES**\n\n**Required Packages:**\n```json\n{\n \"dependencies\": {\n \"@mastra/core\": \"latest\",\n \"zod\": \"^3.25.67\"\n }\n}\n```\n\n**Additional Packages (as needed):**\n- `@mastra/libsql`: For workflow state persistence\n- `@ai-sdk/openai`: For AI model integration\n- `ai`: For AI SDK functionality\n\n### **\u2705 WORKFLOW BEST PRACTICES**\n\n**Schema Design:**\n- Use descriptive property names in schemas\n- Make schemas as specific as possible (avoid `z.any()`)\n- Include validation for required business logic\n\n**Error Handling:**\n- Use `try/catch` blocks in step execute functions\n- Return meaningful error messages\n- Consider using `bail()` for early successful exits\n\n**Step Organization:**\n- Keep steps focused on single responsibilities\n- Use descriptive step IDs (kebab-case recommended)\n- Create reusable steps for common operations\n\n**Data Flow:**\n- Use `.map()` when schemas don't align between steps\n- Access previous step results with `getStepResult(stepInstance)`\n- Use `getInitData()` to access original workflow input\n\n### **\uD83D\uDE80 EXECUTION PATTERNS**\n\n**Running Workflows:**\n```typescript\n// Create and start run\nconst run = await workflow.createRun();\nconst result = await run.start({ inputData: {...} });\n\n// Stream execution for real-time monitoring\nconst stream = await run.streamVNext({ inputData: {...} });\nfor await (const chunk of stream) {\n console.log(chunk);\n}\n\n// Watch for events\nrun.watch((event) => console.log(event));\n```\n\n**Workflow Status Types:**\n- `\"success\"`: Completed successfully\n- `\"suspended\"`: Paused awaiting input\n- `\"failed\"`: Encountered error\n\n### **\uD83D\uDD17 ADVANCED FEATURES**\n\n**Nested Workflows:**\n- Use workflows as steps: `.then(otherWorkflow)`\n- Enable complex workflow composition\n\n**Request Context:**\n- Pass shared data across all steps\n- Enable dependency injection patterns\n\n**Streaming & Events:**\n- Real-time workflow monitoring\n- Integration with external event systems\n\n**Cloning:**\n- `cloneWorkflow(original, {id: \"new-id\"})`: Reuse workflow structure\n- `cloneStep(original, {id: \"new-id\"})`: Reuse step logic\n\nThis comprehensive research provides the foundation for creating robust, maintainable Mastra workflows with proper typing, error handling, and architectural patterns.\n";
2
2
  /**
3
3
  * Prompts and instructions for workflow builder agents
4
4
  */
package/dist/workflows/workflow-builder/prompts.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/workflows/workflow-builder/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,0qRAqQ5B,CAAC;AACF;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,CAAC,OAAO,EAAE;YAAE,gBAAgB,EAAE,GAAG,CAAC;YAAC,YAAY,EAAE,GAAG,CAAC;YAAC,eAAe,EAAE,OAAO,CAAA;SAAE,KAAK,MAAM,CAAC;KACrG,CAAC;IACF,cAAc,EAAE;QACd,YAAY,EAAE,CAAC,OAAO,EAAE;YACtB,MAAM,EAAE,MAAM,CAAC;YACf,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,WAAW,EAAE,MAAM,CAAC;YACpB,kBAAkB,EAAE,MAAM,CAAC;YAC3B,mBAAmB,EAAE,GAAG,CAAC;YACzB,gBAAgB,EAAE,GAAG,CAAC;YACtB,QAAQ,EAAE,GAAG,CAAC;YACd,KAAK,EAAE,GAAG,EAAE,CAAC;YACb,UAAU,CAAC,EAAE,GAAG,CAAC;SAClB,KAAK,MAAM,CAAC;QACb,MAAM,EAAE,CAAC,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,GAAG,EAAE,CAAC;YAAC,UAAU,CAAC,EAAE,GAAG,CAAA;SAAE,KAAK,MAAM,CAAC;QACvG,eAAe,EAAE,CAAC,OAAO,EAAE;YACzB,cAAc,EAAE,GAAG,EAAE,CAAC;YACtB,YAAY,EAAE,GAAG,EAAE,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,UAAU,CAAC,EAAE,GAAG,CAAC;SAClB,KAAK,MAAM,CAAC;KACd,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,eAAO,MAAM,sBAAsB,EAAE,sBAsIpC,CAAC"}
1
+ {"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/workflows/workflow-builder/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,qqRAqQ5B,CAAC;AACF;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,CAAC,OAAO,EAAE;YAAE,gBAAgB,EAAE,GAAG,CAAC;YAAC,YAAY,EAAE,GAAG,CAAC;YAAC,eAAe,EAAE,OAAO,CAAA;SAAE,KAAK,MAAM,CAAC;KACrG,CAAC;IACF,cAAc,EAAE;QACd,YAAY,EAAE,CAAC,OAAO,EAAE;YACtB,MAAM,EAAE,MAAM,CAAC;YACf,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,WAAW,EAAE,MAAM,CAAC;YACpB,kBAAkB,EAAE,MAAM,CAAC;YAC3B,mBAAmB,EAAE,GAAG,CAAC;YACzB,gBAAgB,EAAE,GAAG,CAAC;YACtB,QAAQ,EAAE,GAAG,CAAC;YACd,KAAK,EAAE,GAAG,EAAE,CAAC;YACb,UAAU,CAAC,EAAE,GAAG,CAAC;SAClB,KAAK,MAAM,CAAC;QACb,MAAM,EAAE,CAAC,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,GAAG,EAAE,CAAC;YAAC,UAAU,CAAC,EAAE,GAAG,CAAA;SAAE,KAAK,MAAM,CAAC;QACvG,eAAe,EAAE,CAAC,OAAO,EAAE;YACzB,cAAc,EAAE,GAAG,EAAE,CAAC;YACtB,YAAY,EAAE,GAAG,EAAE,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,UAAU,CAAC,EAAE,GAAG,CAAC;SAClB,KAAK,MAAM,CAAC;KACd,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,eAAO,MAAM,sBAAsB,EAAE,sBAsIpC,CAAC"}
package/dist/workflows/workflow-builder/schema.d.ts CHANGED
@@ -29,16 +29,16 @@ export declare const DiscoveredWorkflowSchema: z.ZodObject<{
29
29
  file: string;
30
30
  name: string;
31
31
  description?: string | undefined;
32
- steps?: string[] | undefined;
33
32
  outputSchema?: any;
34
33
  inputSchema?: any;
34
+ steps?: string[] | undefined;
35
35
  }, {
36
36
  file: string;
37
37
  name: string;
38
38
  description?: string | undefined;
39
- steps?: string[] | undefined;
40
39
  outputSchema?: any;
41
40
  inputSchema?: any;
41
+ steps?: string[] | undefined;
42
42
  }>;
43
43
  export declare const WorkflowDiscoveryResultSchema: z.ZodObject<{
44
44
  success: z.ZodBoolean;
@@ -53,16 +53,16 @@ export declare const WorkflowDiscoveryResultSchema: z.ZodObject<{
53
53
  file: string;
54
54
  name: string;
55
55
  description?: string | undefined;
56
- steps?: string[] | undefined;
57
56
  outputSchema?: any;
58
57
  inputSchema?: any;
58
+ steps?: string[] | undefined;
59
59
  }, {
60
60
  file: string;
61
61
  name: string;
62
62
  description?: string | undefined;
63
- steps?: string[] | undefined;
64
63
  outputSchema?: any;
65
64
  inputSchema?: any;
65
+ steps?: string[] | undefined;
66
66
  }>, "many">;
67
67
  mastraIndexExists: z.ZodBoolean;
68
68
  message: z.ZodString;
@@ -74,9 +74,9 @@ export declare const WorkflowDiscoveryResultSchema: z.ZodObject<{
74
74
  file: string;
75
75
  name: string;
76
76
  description?: string | undefined;
77
- steps?: string[] | undefined;
78
77
  outputSchema?: any;
79
78
  inputSchema?: any;
79
+ steps?: string[] | undefined;
80
80
  }[];
81
81
  mastraIndexExists: boolean;
82
82
  error?: string | undefined;
@@ -87,9 +87,9 @@ export declare const WorkflowDiscoveryResultSchema: z.ZodObject<{
87
87
  file: string;
88
88
  name: string;
89
89
  description?: string | undefined;
90
- steps?: string[] | undefined;
91
90
  outputSchema?: any;
92
91
  inputSchema?: any;
92
+ steps?: string[] | undefined;
93
93
  }[];
94
94
  mastraIndexExists: boolean;
95
95
  error?: string | undefined;
@@ -509,16 +509,16 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
509
509
  file: string;
510
510
  name: string;
511
511
  description?: string | undefined;
512
- steps?: string[] | undefined;
513
512
  outputSchema?: any;
514
513
  inputSchema?: any;
514
+ steps?: string[] | undefined;
515
515
  }, {
516
516
  file: string;
517
517
  name: string;
518
518
  description?: string | undefined;
519
- steps?: string[] | undefined;
520
519
  outputSchema?: any;
521
520
  inputSchema?: any;
521
+ steps?: string[] | undefined;
522
522
  }>, "many">;
523
523
  mastraIndexExists: z.ZodBoolean;
524
524
  message: z.ZodString;
@@ -530,9 +530,9 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
530
530
  file: string;
531
531
  name: string;
532
532
  description?: string | undefined;
533
- steps?: string[] | undefined;
534
533
  outputSchema?: any;
535
534
  inputSchema?: any;
535
+ steps?: string[] | undefined;
536
536
  }[];
537
537
  mastraIndexExists: boolean;
538
538
  error?: string | undefined;
@@ -543,9 +543,9 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
543
543
  file: string;
544
544
  name: string;
545
545
  description?: string | undefined;
546
- steps?: string[] | undefined;
547
546
  outputSchema?: any;
548
547
  inputSchema?: any;
548
+ steps?: string[] | undefined;
549
549
  }[];
550
550
  mastraIndexExists: boolean;
551
551
  error?: string | undefined;
@@ -725,6 +725,7 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
725
725
  }, "strip", z.ZodTypeAny, {
726
726
  message: string;
727
727
  success: boolean;
728
+ reasoning: string;
728
729
  tasks: {
729
730
  status: "pending" | "in_progress" | "completed" | "blocked";
730
731
  id: string;
@@ -733,7 +734,6 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
733
734
  notes: string;
734
735
  dependencies?: string[] | undefined;
735
736
  }[];
736
- reasoning: string;
737
737
  questions: {
738
738
  type: "boolean" | "text" | "choice";
739
739
  id: string;
@@ -748,6 +748,7 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
748
748
  }, {
749
749
  message: string;
750
750
  success: boolean;
751
+ reasoning: string;
751
752
  tasks: {
752
753
  id: string;
753
754
  content: string;
@@ -756,7 +757,6 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
756
757
  status?: "pending" | "in_progress" | "completed" | "blocked" | undefined;
757
758
  dependencies?: string[] | undefined;
758
759
  }[];
759
- reasoning: string;
760
760
  questions: {
761
761
  type: "boolean" | "text" | "choice";
762
762
  id: string;
@@ -938,9 +938,9 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
938
938
  file: string;
939
939
  name: string;
940
940
  description?: string | undefined;
941
- steps?: string[] | undefined;
942
941
  outputSchema?: any;
943
942
  inputSchema?: any;
943
+ steps?: string[] | undefined;
944
944
  }[];
945
945
  mastraIndexExists: boolean;
946
946
  error?: string | undefined;
@@ -948,6 +948,7 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
948
948
  planning?: {
949
949
  message: string;
950
950
  success: boolean;
951
+ reasoning: string;
951
952
  tasks: {
952
953
  status: "pending" | "in_progress" | "completed" | "blocked";
953
954
  id: string;
@@ -956,7 +957,6 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
956
957
  notes: string;
957
958
  dependencies?: string[] | undefined;
958
959
  }[];
959
- reasoning: string;
960
960
  questions: {
961
961
  type: "boolean" | "text" | "choice";
962
962
  id: string;
@@ -1048,9 +1048,9 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
1048
1048
  file: string;
1049
1049
  name: string;
1050
1050
  description?: string | undefined;
1051
- steps?: string[] | undefined;
1052
1051
  outputSchema?: any;
1053
1052
  inputSchema?: any;
1053
+ steps?: string[] | undefined;
1054
1054
  }[];
1055
1055
  mastraIndexExists: boolean;
1056
1056
  error?: string | undefined;
@@ -1058,6 +1058,7 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
1058
1058
  planning?: {
1059
1059
  message: string;
1060
1060
  success: boolean;
1061
+ reasoning: string;
1061
1062
  tasks: {
1062
1063
  id: string;
1063
1064
  content: string;
@@ -1066,7 +1067,6 @@ export declare const WorkflowBuilderResultSchema: z.ZodObject<{
1066
1067
  status?: "pending" | "in_progress" | "completed" | "blocked" | undefined;
1067
1068
  dependencies?: string[] | undefined;
1068
1069
  }[];
1069
- reasoning: string;
1070
1070
  questions: {
1071
1071
  type: "boolean" | "text" | "choice";
1072
1072
  id: string;