@mastra/code-sdk 1.2.0-alpha.9 → 1.2.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 (132) hide show
  1. package/CHANGELOG.md +227 -0
  2. package/README.md +22 -0
  3. package/dist/agents/model.d.ts.map +1 -1
  4. package/dist/agents/model.js +5 -2
  5. package/dist/agents/model.js.map +1 -1
  6. package/dist/agents/modes/build.d.ts.map +1 -1
  7. package/dist/agents/modes/build.js +6 -1
  8. package/dist/agents/modes/build.js.map +1 -1
  9. package/dist/agents/modes/explore.d.ts.map +1 -1
  10. package/dist/agents/modes/explore.js +4 -1
  11. package/dist/agents/modes/explore.js.map +1 -1
  12. package/dist/agents/modes/plan.d.ts.map +1 -1
  13. package/dist/agents/modes/plan.js +8 -3
  14. package/dist/agents/modes/plan.js.map +1 -1
  15. package/dist/agents/prompts/index.d.ts.map +1 -1
  16. package/dist/agents/prompts/index.js +4 -1
  17. package/dist/agents/prompts/index.js.map +1 -1
  18. package/dist/agents/prompts/plan.d.ts +1 -1
  19. package/dist/agents/prompts/plan.d.ts.map +1 -1
  20. package/dist/agents/prompts/plan.js +2 -2
  21. package/dist/agents/prompts/plan.js.map +1 -1
  22. package/dist/agents/prompts/tool-guidance.d.ts +2 -0
  23. package/dist/agents/prompts/tool-guidance.d.ts.map +1 -1
  24. package/dist/agents/prompts/tool-guidance.js +3 -2
  25. package/dist/agents/prompts/tool-guidance.js.map +1 -1
  26. package/dist/agents/tool-availability.d.ts.map +1 -1
  27. package/dist/agents/tool-availability.js +15 -6
  28. package/dist/agents/tool-availability.js.map +1 -1
  29. package/dist/agents/tools.d.ts +16 -0
  30. package/dist/agents/tools.d.ts.map +1 -1
  31. package/dist/agents/tools.js +16 -3
  32. package/dist/agents/tools.js.map +1 -1
  33. package/dist/agents/workflow-builder-agent.d.ts +2 -0
  34. package/dist/agents/workflow-builder-agent.d.ts.map +1 -0
  35. package/dist/agents/workflow-builder-agent.js +80 -0
  36. package/dist/agents/workflow-builder-agent.js.map +1 -0
  37. package/dist/headless/cli.d.ts.map +1 -1
  38. package/dist/headless/cli.js +3 -0
  39. package/dist/headless/cli.js.map +1 -1
  40. package/dist/hooks/manager.d.ts +9 -2
  41. package/dist/hooks/manager.d.ts.map +1 -1
  42. package/dist/hooks/manager.js +19 -3
  43. package/dist/hooks/manager.js.map +1 -1
  44. package/dist/hooks/types.d.ts +20 -0
  45. package/dist/hooks/types.d.ts.map +1 -1
  46. package/dist/hooks/types.js.map +1 -1
  47. package/dist/index.d.ts +73 -0
  48. package/dist/index.d.ts.map +1 -1
  49. package/dist/index.js +204 -69
  50. package/dist/index.js.map +1 -1
  51. package/dist/permissions.d.ts.map +1 -1
  52. package/dist/permissions.js +6 -1
  53. package/dist/permissions.js.map +1 -1
  54. package/dist/plugin.d.ts +64 -1
  55. package/dist/plugin.d.ts.map +1 -1
  56. package/dist/plugin.js +3 -1
  57. package/dist/plugin.js.map +1 -1
  58. package/dist/plugins/loader.d.ts +7 -3
  59. package/dist/plugins/loader.d.ts.map +1 -1
  60. package/dist/plugins/loader.js +53 -1
  61. package/dist/plugins/loader.js.map +1 -1
  62. package/dist/plugins/manager.d.ts +36 -2
  63. package/dist/plugins/manager.d.ts.map +1 -1
  64. package/dist/plugins/manager.js +74 -2
  65. package/dist/plugins/manager.js.map +1 -1
  66. package/dist/plugins/signal-lane.d.ts +58 -0
  67. package/dist/plugins/signal-lane.d.ts.map +1 -0
  68. package/dist/plugins/signal-lane.js +166 -0
  69. package/dist/plugins/signal-lane.js.map +1 -0
  70. package/dist/plugins/types.d.ts +36 -0
  71. package/dist/plugins/types.d.ts.map +1 -1
  72. package/dist/tools/workflows/create-workflow.d.ts +7 -0
  73. package/dist/tools/workflows/create-workflow.d.ts.map +1 -0
  74. package/dist/tools/workflows/create-workflow.js +81 -0
  75. package/dist/tools/workflows/create-workflow.js.map +1 -0
  76. package/dist/tools/workflows/delete-workflow.d.ts +7 -0
  77. package/dist/tools/workflows/delete-workflow.d.ts.map +1 -0
  78. package/dist/tools/workflows/delete-workflow.js +21 -0
  79. package/dist/tools/workflows/delete-workflow.js.map +1 -0
  80. package/dist/tools/workflows/ephemeral-memory.d.ts +7 -0
  81. package/dist/tools/workflows/ephemeral-memory.d.ts.map +1 -0
  82. package/dist/tools/workflows/ephemeral-memory.js +45 -0
  83. package/dist/tools/workflows/ephemeral-memory.js.map +1 -0
  84. package/dist/tools/workflows/extract-json-schema.d.ts +12 -0
  85. package/dist/tools/workflows/extract-json-schema.d.ts.map +1 -0
  86. package/dist/tools/workflows/extract-json-schema.js +22 -0
  87. package/dist/tools/workflows/extract-json-schema.js.map +1 -0
  88. package/dist/tools/workflows/get-workflow.d.ts +11 -0
  89. package/dist/tools/workflows/get-workflow.d.ts.map +1 -0
  90. package/dist/tools/workflows/get-workflow.js +34 -0
  91. package/dist/tools/workflows/get-workflow.js.map +1 -0
  92. package/dist/tools/workflows/list-available-agents.d.ts +8 -0
  93. package/dist/tools/workflows/list-available-agents.d.ts.map +1 -0
  94. package/dist/tools/workflows/list-available-agents.js +32 -0
  95. package/dist/tools/workflows/list-available-agents.js.map +1 -0
  96. package/dist/tools/workflows/list-available-tools.d.ts +9 -0
  97. package/dist/tools/workflows/list-available-tools.d.ts.map +1 -0
  98. package/dist/tools/workflows/list-available-tools.js +40 -0
  99. package/dist/tools/workflows/list-available-tools.js.map +1 -0
  100. package/dist/tools/workflows/list-available-workflows.d.ts +9 -0
  101. package/dist/tools/workflows/list-available-workflows.d.ts.map +1 -0
  102. package/dist/tools/workflows/list-available-workflows.js +32 -0
  103. package/dist/tools/workflows/list-available-workflows.js.map +1 -0
  104. package/dist/tools/workflows/list-workflows.d.ts +9 -0
  105. package/dist/tools/workflows/list-workflows.d.ts.map +1 -0
  106. package/dist/tools/workflows/list-workflows.js +33 -0
  107. package/dist/tools/workflows/list-workflows.js.map +1 -0
  108. package/dist/tools/workflows/run-workflow.d.ts +9 -0
  109. package/dist/tools/workflows/run-workflow.d.ts.map +1 -0
  110. package/dist/tools/workflows/run-workflow.js +52 -0
  111. package/dist/tools/workflows/run-workflow.js.map +1 -0
  112. package/dist/tools/workflows/save-workflow.d.ts +369 -0
  113. package/dist/tools/workflows/save-workflow.d.ts.map +1 -0
  114. package/dist/tools/workflows/save-workflow.js +28 -0
  115. package/dist/tools/workflows/save-workflow.js.map +1 -0
  116. package/dist/tools/workflows/tool-ids.d.ts +15 -0
  117. package/dist/tools/workflows/tool-ids.d.ts.map +1 -0
  118. package/dist/tools/workflows/tool-ids.js +19 -0
  119. package/dist/tools/workflows/tool-ids.js.map +1 -0
  120. package/dist/utils/plans.d.ts +9 -6
  121. package/dist/utils/plans.d.ts.map +1 -1
  122. package/dist/utils/plans.js +11 -11
  123. package/dist/utils/plans.js.map +1 -1
  124. package/dist/workflows/register-primitives.d.ts +52 -0
  125. package/dist/workflows/register-primitives.d.ts.map +1 -0
  126. package/dist/workflows/register-primitives.js +39 -0
  127. package/dist/workflows/register-primitives.js.map +1 -0
  128. package/dist/workflows/service.d.ts +64 -0
  129. package/dist/workflows/service.d.ts.map +1 -0
  130. package/dist/workflows/service.js +53 -0
  131. package/dist/workflows/service.js.map +1 -0
  132. package/package.json +16 -16
@@ -0,0 +1,39 @@
1
+ import { createWebExtractTool, createWebSearchTool, hasTavilyKey } from "../tools/web-search.js";
2
+ import { MC_TOOLS } from "../tool-names.js";
3
+ import { MASTRACODE_WORKSPACE_TOOLS } from "../agents/tool-availability.js";
4
+ import { LazyNotificationsStorage } from "../agents/tools.js";
5
+ import { workflowBuilderAgent } from "../agents/workflow-builder-agent.js";
6
+ import { createNotificationInboxTool } from "@mastra/core/notifications";
7
+ import { LocalFilesystem, LocalSandbox, Workspace, createWorkspaceTools } from "@mastra/core/workspace";
8
+ //#region src/workflows/register-primitives.ts
9
+ async function registerWorkflowBuilderPrimitives(mastra, options) {
10
+ const { projectPath, allowedPaths = [], codeAgent, mcpManager } = options;
11
+ mastra.addAgent(workflowBuilderAgent, "workflow-builder");
12
+ mastra.addAgent(codeAgent, "code-agent");
13
+ const workspace = new Workspace({
14
+ id: "workflow-builder-workspace",
15
+ name: "Mastra Code Workspace (workflows)",
16
+ filesystem: new LocalFilesystem({
17
+ basePath: projectPath,
18
+ allowedPaths: [projectPath, ...allowedPaths]
19
+ }),
20
+ sandbox: new LocalSandbox({ workingDirectory: projectPath }),
21
+ tools: MASTRACODE_WORKSPACE_TOOLS
22
+ });
23
+ const workspaceTools = await createWorkspaceTools(workspace, { workspace });
24
+ for (const [toolId, tool] of Object.entries(workspaceTools)) mastra.addTool(tool, toolId);
25
+ if (hasTavilyKey()) {
26
+ mastra.addTool(createWebSearchTool(), "web-search");
27
+ mastra.addTool(createWebExtractTool(), "web-extract");
28
+ }
29
+ const storage = mastra.getStorage();
30
+ if (storage) {
31
+ const notificationInbox = createNotificationInboxTool({ storage: new LazyNotificationsStorage(storage) });
32
+ mastra.addTool(notificationInbox, MC_TOOLS.NOTIFICATION_INBOX);
33
+ }
34
+ if (mcpManager) for (const [toolId, tool] of Object.entries(mcpManager.getTools())) mastra.addTool(tool, toolId);
35
+ }
36
+ //#endregion
37
+ export { registerWorkflowBuilderPrimitives };
38
+
39
+ //# sourceMappingURL=register-primitives.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"register-primitives.js","names":[],"sources":["../../src/workflows/register-primitives.ts"],"sourcesContent":["/**\n * Statically register workflow-related primitives on the mastracode Mastra\n * instance so `mastra.listTools()` + `mastra.listAgents()` — and, therefore,\n * the workflow-builder's discovery + the workflow rehydrator — see everything\n * a workflow might want to compose:\n *\n * - workflow-builder sub-agent (so `create-workflow` can delegate)\n * - code-agent (as a plain agent, callable via agent steps)\n * - workspace tools (view/write/edit/find_files/execute_command/etc.)\n * - web tools (Tavily-gated) so workflows can compose search/extract steps\n * - notification_inbox\n * - snapshot of MCP tools from mcpManager\n *\n * Called after `controller.init()` but before `startWorkers()` in both boot\n * paths, so `loadStoredWorkflows()` (inside startWorkers) sees the full\n * registry when rehydrating previously-saved workflows.\n *\n * Tradeoffs:\n * - MCP tools are snapshotted. Servers added after boot are invisible to\n * the workflow-builder until restart.\n * - Web tool flavor is Tavily-only. Provider-native (Anthropic/OpenAI) web\n * tools are skipped because they'd freeze workflows to one model provider.\n * - Workflow tool steps get the closed-over workspace + auth (Tavily key,\n * MCP server credentials), not per-request permissions — deliberate; if\n * the user built + saved the workflow they meant to run it.\n */\nimport type { Agent } from '@mastra/core/agent';\nimport type { Mastra } from '@mastra/core/mastra';\nimport { createNotificationInboxTool } from '@mastra/core/notifications';\nimport { LocalFilesystem, LocalSandbox, Workspace, createWorkspaceTools } from '@mastra/core/workspace';\nimport { MASTRACODE_WORKSPACE_TOOLS } from '../agents/tool-availability.js';\nimport { LazyNotificationsStorage } from '../agents/tools.js';\nimport { workflowBuilderAgent } from '../agents/workflow-builder-agent.js';\nimport type { McpManager } from '../mcp';\nimport { MC_TOOLS } from '../tool-names.js';\nimport { createWebExtractTool, createWebSearchTool, hasTavilyKey } from '../tools/web-search.js';\n\nexport interface RegisterWorkflowBuilderPrimitivesOptions {\n projectPath: string;\n /**\n * Extra allowed paths the workspace can read/write. Mastracode normally\n * collects skill paths + sandboxAllowedPaths per-request; for the workflow\n * workspace we accept anything the caller wants up-front and trust the\n * worker process to honour the user's intent.\n */\n allowedPaths?: string[];\n /**\n * The code-agent Agent instance. Registered as `code-agent` so workflows\n * can compose it in agent steps. It already has full dynamic tool access\n * (workspace/MCP/web/etc.) via its own `tools: createDynamicTools(...)`.\n */\n codeAgent: Agent;\n /**\n * McpManager for snapshotting MCP tools at boot. Omit or pass undefined\n * if MCP is disabled — workflow-builder will just see fewer tools.\n */\n mcpManager?: McpManager;\n}\n\nexport async function registerWorkflowBuilderPrimitives(\n mastra: Mastra,\n options: RegisterWorkflowBuilderPrimitivesOptions,\n): Promise<void> {\n const { projectPath, allowedPaths = [], codeAgent, mcpManager } = options;\n\n // 1. Agents workflows can compose.\n mastra.addAgent(workflowBuilderAgent, 'workflow-builder');\n mastra.addAgent(codeAgent, 'code-agent');\n\n // 2. Workspace tools — bound to a project-rooted local workspace.\n const workspace = new Workspace({\n id: 'workflow-builder-workspace',\n name: 'Mastra Code Workspace (workflows)',\n filesystem: new LocalFilesystem({\n basePath: projectPath,\n allowedPaths: [projectPath, ...allowedPaths],\n }),\n sandbox: new LocalSandbox({ workingDirectory: projectPath }),\n tools: MASTRACODE_WORKSPACE_TOOLS,\n });\n const workspaceTools = await createWorkspaceTools(workspace, { workspace });\n for (const [toolId, tool] of Object.entries(workspaceTools)) {\n mastra.addTool(tool, toolId);\n }\n\n // 3. Web tools — Tavily only. Provider-native web tools (Anthropic/OpenAI)\n // are model-locked and would freeze workflows to one provider.\n if (hasTavilyKey()) {\n mastra.addTool(createWebSearchTool(), 'web-search');\n mastra.addTool(createWebExtractTool(), 'web-extract');\n }\n\n // 4. notification_inbox — LazyNotificationsStorage resolves the notifications\n // domain per-call rather than at boot, so it works even when the domain\n // isn't fully initialised yet.\n const storage = mastra.getStorage();\n if (storage) {\n const notificationInbox = createNotificationInboxTool({\n storage: new LazyNotificationsStorage(storage as never),\n });\n mastra.addTool(notificationInbox, MC_TOOLS.NOTIFICATION_INBOX);\n }\n\n // 5. MCP tools — snapshot the current set. Ids are already server-namespaced\n // (`${serverName}_${toolName}`), so the workflow rehydrator's\n // `mastra.getTool(id)` resolves them at run time.\n if (mcpManager) {\n for (const [toolId, tool] of Object.entries(mcpManager.getTools())) {\n mastra.addTool(tool, toolId);\n }\n }\n}\n"],"mappings":";;;;;;;;AA2DA,eAAsB,kCACpB,QACA,SACe;CACf,MAAM,EAAE,aAAa,eAAe,CAAC,GAAG,WAAW,eAAe;CAGlE,OAAO,SAAS,sBAAsB,kBAAkB;CACxD,OAAO,SAAS,WAAW,YAAY;CAGvC,MAAM,YAAY,IAAI,UAAU;EAC9B,IAAI;EACJ,MAAM;EACN,YAAY,IAAI,gBAAgB;GAC9B,UAAU;GACV,cAAc,CAAC,aAAa,GAAG,YAAY;EAC7C,CAAC;EACD,SAAS,IAAI,aAAa,EAAE,kBAAkB,YAAY,CAAC;EAC3D,OAAO;CACT,CAAC;CACD,MAAM,iBAAiB,MAAM,qBAAqB,WAAW,EAAE,UAAU,CAAC;CAC1E,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,cAAc,GACxD,OAAO,QAAQ,MAAM,MAAM;CAK7B,IAAI,aAAa,GAAG;EAClB,OAAO,QAAQ,oBAAoB,GAAG,YAAY;EAClD,OAAO,QAAQ,qBAAqB,GAAG,aAAa;CACtD;CAKA,MAAM,UAAU,OAAO,WAAW;CAClC,IAAI,SAAS;EACX,MAAM,oBAAoB,4BAA4B,EACpD,SAAS,IAAI,yBAAyB,OAAgB,EACxD,CAAC;EACD,OAAO,QAAQ,mBAAmB,SAAS,kBAAkB;CAC/D;CAKA,IAAI,YACF,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,WAAW,SAAS,CAAC,GAC/D,OAAO,QAAQ,MAAM,MAAM;AAGjC"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * Thin wrapper around `mastra.getStorage().getStore('workflowDefinitions')` and
3
+ * `mastra.getWorkflow(id).createRun().stream(...)` so both the parent-mode
4
+ * tools and the `/workflows` slash command go through one implementation.
5
+ */
6
+ import type { Mastra } from '@mastra/core/mastra';
7
+ export interface StoredWorkflowRow {
8
+ id: string;
9
+ description?: string;
10
+ status: 'active' | 'archived';
11
+ inputSchema?: unknown;
12
+ outputSchema?: unknown;
13
+ graph?: unknown[];
14
+ createdAt?: Date;
15
+ updatedAt?: Date;
16
+ }
17
+ export interface RunResult {
18
+ status: string;
19
+ result?: unknown;
20
+ error?: unknown;
21
+ steps?: Record<string, unknown>;
22
+ tripwire?: {
23
+ reason?: string;
24
+ retry?: unknown;
25
+ metadata?: unknown;
26
+ processorId?: string;
27
+ };
28
+ }
29
+ export interface WorkflowRunEvent {
30
+ type: string;
31
+ payload?: Record<string, unknown> & {
32
+ id?: string;
33
+ };
34
+ [key: string]: unknown;
35
+ }
36
+ export type WorkflowRunEventCallback = (event: WorkflowRunEvent) => void;
37
+ export declare function listWorkflows(mastra: Mastra): Promise<{
38
+ workflows: StoredWorkflowRow[];
39
+ total: number;
40
+ }>;
41
+ export declare function getWorkflow(mastra: Mastra, id: string): Promise<StoredWorkflowRow | null>;
42
+ export declare function deleteWorkflow(mastra: Mastra, id: string): Promise<{
43
+ ok: true;
44
+ id: string;
45
+ }>;
46
+ export declare function runWorkflow(mastra: Mastra, workflowId: string, inputData: unknown,
47
+ /**
48
+ * Optional. When provided, passed through to `run.stream(...)` so agent steps
49
+ * (like `code-agent`) that depend on session state — `getDynamicModel` reads
50
+ * `controller.session.modelId` off it — can resolve correctly.
51
+ *
52
+ * Chat-driven `run-workflow` inherits its context from the parent code-agent
53
+ * turn, so this is unused there. The `/workflows run` slash handler builds a
54
+ * synthetic context from the current TUI session and passes it here.
55
+ */
56
+ requestContext?: unknown,
57
+ /**
58
+ * Optional. When provided, invoked for every `WorkflowStreamEvent` the run
59
+ * emits — used by the `/workflows run` slash handler to render live per-step
60
+ * progress in the TUI. Non-fatal: errors in the callback are swallowed so a
61
+ * misbehaving consumer can't take the workflow down.
62
+ */
63
+ onEvent?: WorkflowRunEventCallback): Promise<RunResult>;
64
+ //# sourceMappingURL=service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/workflows/service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AA0BzE,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAI9G;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAG/F;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAQlG;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO;AAClB;;;;;;;;GAQG;AACH,cAAc,CAAC,EAAE,OAAO;AACxB;;;;;GAKG;AACH,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,SAAS,CAAC,CAoCpB"}
@@ -0,0 +1,53 @@
1
+ //#region src/workflows/service.ts
2
+ async function workflowDefinitionsStore(mastra) {
3
+ const storage = mastra.getStorage();
4
+ if (!storage) throw new Error("Storage is not configured on the Mastra instance.");
5
+ const store = await storage.getStore("workflowDefinitions");
6
+ if (!store) throw new Error("workflowDefinitions storage domain is not available.");
7
+ return store;
8
+ }
9
+ async function listWorkflows(mastra) {
10
+ const result = await (await workflowDefinitionsStore(mastra)).list({ status: "active" });
11
+ return {
12
+ workflows: result.definitions,
13
+ total: result.total
14
+ };
15
+ }
16
+ async function getWorkflow(mastra, id) {
17
+ return (await workflowDefinitionsStore(mastra)).get(id);
18
+ }
19
+ async function deleteWorkflow(mastra, id) {
20
+ await (await workflowDefinitionsStore(mastra)).delete(id);
21
+ mastra.removeWorkflow(id);
22
+ return {
23
+ ok: true,
24
+ id
25
+ };
26
+ }
27
+ async function runWorkflow(mastra, workflowId, inputData, requestContext, onEvent) {
28
+ let wf;
29
+ let lookupError;
30
+ try {
31
+ wf = mastra.getWorkflow(workflowId);
32
+ } catch (error) {
33
+ lookupError = error;
34
+ }
35
+ if (!wf) throw new Error(`No workflow registered with id "${workflowId}". Was it built and saved?`, { cause: lookupError });
36
+ const run = await wf.createRun();
37
+ if (!onEvent) return await run.start({
38
+ inputData,
39
+ requestContext
40
+ });
41
+ const output = run.stream({
42
+ inputData,
43
+ requestContext
44
+ });
45
+ for await (const event of output.fullStream) try {
46
+ onEvent(event);
47
+ } catch {}
48
+ return await output.result;
49
+ }
50
+ //#endregion
51
+ export { deleteWorkflow, getWorkflow, listWorkflows, runWorkflow };
52
+
53
+ //# sourceMappingURL=service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.js","names":[],"sources":["../../src/workflows/service.ts"],"sourcesContent":["/**\n * Thin wrapper around `mastra.getStorage().getStore('workflowDefinitions')` and\n * `mastra.getWorkflow(id).createRun().stream(...)` so both the parent-mode\n * tools and the `/workflows` slash command go through one implementation.\n */\nimport type { Mastra } from '@mastra/core/mastra';\n\nexport interface StoredWorkflowRow {\n id: string;\n description?: string;\n status: 'active' | 'archived';\n inputSchema?: unknown;\n outputSchema?: unknown;\n graph?: unknown[];\n createdAt?: Date;\n updatedAt?: Date;\n}\n\nexport interface RunResult {\n status: string;\n result?: unknown;\n error?: unknown;\n steps?: Record<string, unknown>;\n tripwire?: { reason?: string; retry?: unknown; metadata?: unknown; processorId?: string };\n}\n\nexport interface WorkflowRunEvent {\n type: string;\n payload?: Record<string, unknown> & { id?: string };\n [key: string]: unknown;\n}\n\nexport type WorkflowRunEventCallback = (event: WorkflowRunEvent) => void;\n\ninterface WorkflowRunOutputLike {\n fullStream: ReadableStream<WorkflowRunEvent>;\n result: Promise<unknown>;\n}\n\ninterface WorkflowDefinitionsStore {\n list: (args?: { status?: 'active' | 'archived' }) => Promise<{ definitions: StoredWorkflowRow[]; total: number }>;\n get: (id: string) => Promise<StoredWorkflowRow | null>;\n delete: (id: string) => Promise<void>;\n}\n\nasync function workflowDefinitionsStore(mastra: Mastra): Promise<WorkflowDefinitionsStore> {\n const storage = mastra.getStorage();\n if (!storage) throw new Error('Storage is not configured on the Mastra instance.');\n // `getStore` is a generic domain accessor; workflowDefinitions is registered\n // by mastracode. The domain shape is validated at boot; cast the resolved\n // store to the interface we exercise.\n const store = (await (storage as unknown as { getStore: (name: string) => Promise<unknown> }).getStore(\n 'workflowDefinitions',\n )) as WorkflowDefinitionsStore | undefined;\n if (!store) throw new Error('workflowDefinitions storage domain is not available.');\n return store;\n}\n\nexport async function listWorkflows(mastra: Mastra): Promise<{ workflows: StoredWorkflowRow[]; total: number }> {\n const store = await workflowDefinitionsStore(mastra);\n const result = await store.list({ status: 'active' });\n return { workflows: result.definitions, total: result.total };\n}\n\nexport async function getWorkflow(mastra: Mastra, id: string): Promise<StoredWorkflowRow | null> {\n const store = await workflowDefinitionsStore(mastra);\n return store.get(id);\n}\n\nexport async function deleteWorkflow(mastra: Mastra, id: string): Promise<{ ok: true; id: string }> {\n const store = await workflowDefinitionsStore(mastra);\n await store.delete(id);\n // Also unregister the live in-process Workflow instance so a subsequent\n // save-workflow with the same id re-registers cleanly instead of getting\n // no-op'd by addWorkflow's first-write-wins guard.\n mastra.removeWorkflow(id);\n return { ok: true, id };\n}\n\nexport async function runWorkflow(\n mastra: Mastra,\n workflowId: string,\n inputData: unknown,\n /**\n * Optional. When provided, passed through to `run.stream(...)` so agent steps\n * (like `code-agent`) that depend on session state — `getDynamicModel` reads\n * `controller.session.modelId` off it — can resolve correctly.\n *\n * Chat-driven `run-workflow` inherits its context from the parent code-agent\n * turn, so this is unused there. The `/workflows run` slash handler builds a\n * synthetic context from the current TUI session and passes it here.\n */\n requestContext?: unknown,\n /**\n * Optional. When provided, invoked for every `WorkflowStreamEvent` the run\n * emits — used by the `/workflows run` slash handler to render live per-step\n * progress in the TUI. Non-fatal: errors in the callback are swallowed so a\n * misbehaving consumer can't take the workflow down.\n */\n onEvent?: WorkflowRunEventCallback,\n): Promise<RunResult> {\n // `getWorkflow` is generic over the statically-registered workflow map, but\n // stored workflows are registered dynamically at load time — the id is a\n // runtime value, not a compile-time key. `as never` widens the arg past the\n // generic constraint; the runtime lookup already validates.\n let wf: ReturnType<Mastra['getWorkflow']> | undefined;\n let lookupError: unknown;\n try {\n wf = mastra.getWorkflow(workflowId as never);\n } catch (error) {\n lookupError = error;\n }\n if (!wf) {\n throw new Error(`No workflow registered with id \"${workflowId}\". Was it built and saved?`, { cause: lookupError });\n }\n\n const run = await wf.createRun();\n if (!onEvent) {\n return (await run.start({\n inputData,\n requestContext: requestContext as Parameters<typeof run.start>[0]['requestContext'],\n })) as RunResult;\n }\n\n const output = run.stream({\n inputData,\n requestContext: requestContext as Parameters<typeof run.stream>[0]['requestContext'],\n }) as unknown as WorkflowRunOutputLike;\n for await (const event of output.fullStream) {\n try {\n onEvent(event);\n } catch {\n // Never let a bad consumer break the run.\n }\n }\n return (await output.result) as RunResult;\n}\n"],"mappings":";AA6CA,eAAe,yBAAyB,QAAmD;CACzF,MAAM,UAAU,OAAO,WAAW;CAClC,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,mDAAmD;CAIjF,MAAM,QAAS,MAAO,QAAwE,SAC5F,qBACF;CACA,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,sDAAsD;CAClF,OAAO;AACT;AAEA,eAAsB,cAAc,QAA4E;CAE9G,MAAM,SAAS,OAAM,MADD,yBAAyB,MAAM,EAAA,CACxB,KAAK,EAAE,QAAQ,SAAS,CAAC;CACpD,OAAO;EAAE,WAAW,OAAO;EAAa,OAAO,OAAO;CAAM;AAC9D;AAEA,eAAsB,YAAY,QAAgB,IAA+C;CAE/F,QAAO,MADa,yBAAyB,MAAM,EAAA,CACtC,IAAI,EAAE;AACrB;AAEA,eAAsB,eAAe,QAAgB,IAA+C;CAElG,OAAM,MADc,yBAAyB,MAAM,EAAA,CACvC,OAAO,EAAE;CAIrB,OAAO,eAAe,EAAE;CACxB,OAAO;EAAE,IAAI;EAAM;CAAG;AACxB;AAEA,eAAsB,YACpB,QACA,YACA,WAUA,gBAOA,SACoB;CAKpB,IAAI;CACJ,IAAI;CACJ,IAAI;EACF,KAAK,OAAO,YAAY,UAAmB;CAC7C,SAAS,OAAO;EACd,cAAc;CAChB;CACA,IAAI,CAAC,IACH,MAAM,IAAI,MAAM,mCAAmC,WAAW,6BAA6B,EAAE,OAAO,YAAY,CAAC;CAGnH,MAAM,MAAM,MAAM,GAAG,UAAU;CAC/B,IAAI,CAAC,SACH,OAAQ,MAAM,IAAI,MAAM;EACtB;EACgB;CAClB,CAAC;CAGH,MAAM,SAAS,IAAI,OAAO;EACxB;EACgB;CAClB,CAAC;CACD,WAAW,MAAM,SAAS,OAAO,YAC/B,IAAI;EACF,QAAQ,KAAK;CACf,QAAQ,CAER;CAEF,OAAQ,MAAM,OAAO;AACvB"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/code-sdk",
3
- "version": "1.2.0-alpha.9",
3
+ "version": "1.2.0",
4
4
  "description": "Mastra Code SDK: the agent core behind Mastra Code (everything except the TUI) — build your own UIs and surfaces on top of it",
5
5
  "type": "module",
6
6
  "publishConfig": {
@@ -56,19 +56,19 @@
56
56
  "vscode-languageserver-protocol": "^3.17.5",
57
57
  "yaml": "^2.7.1",
58
58
  "zod": "^4.3.6",
59
- "@mastra/core": "1.58.0-alpha.8",
60
- "@mastra/agent-browser": "0.5.1-alpha.0",
61
- "@mastra/duckdb": "1.6.1-alpha.0",
62
- "@mastra/github-signals": "0.2.5-alpha.0",
59
+ "@mastra/agent-browser": "0.5.1",
60
+ "@mastra/core": "1.58.0",
61
+ "@mastra/duckdb": "1.6.1",
62
+ "@mastra/github-signals": "0.2.5",
63
+ "@mastra/mcp": "1.16.0",
64
+ "@mastra/libsql": "1.20.0",
65
+ "@mastra/memory": "1.26.1",
66
+ "@mastra/observability": "1.16.6",
67
+ "@mastra/pg": "1.20.0",
68
+ "@mastra/schema-compat": "1.3.6",
63
69
  "@mastra/fastembed": "1.2.0",
64
- "@mastra/libsql": "1.20.0-alpha.2",
65
- "@mastra/mcp": "1.16.0-alpha.1",
66
- "@mastra/observability": "1.16.6-alpha.2",
67
- "@mastra/memory": "1.26.1-alpha.4",
68
- "@mastra/pg": "1.20.0-alpha.3",
69
- "@mastra/tavily": "1.1.1",
70
- "@mastra/schema-compat": "1.3.6-alpha.2",
71
- "@mastra/stagehand": "0.3.2-alpha.1"
70
+ "@mastra/stagehand": "0.3.2",
71
+ "@mastra/tavily": "1.1.1"
72
72
  },
73
73
  "devDependencies": {
74
74
  "@libsql/client": "^0.17.4",
@@ -79,9 +79,9 @@
79
79
  "typescript": "^6.0.3",
80
80
  "typescript-eslint": "^8.57.0",
81
81
  "vitest": "4.1.10",
82
- "@internal/lint": "0.0.121",
83
- "@internal/types-builder": "0.0.96",
84
- "@internal/workspace-test-utils": "0.0.65"
82
+ "@internal/lint": "0.0.122",
83
+ "@internal/types-builder": "0.0.97",
84
+ "@internal/workspace-test-utils": "0.0.66"
85
85
  },
86
86
  "engines": {
87
87
  "node": ">=22.19.0"