@primero.ai/temporal-graph-tools 1.2.0 → 1.3.0

package/dist/src/bundler.js

@@ -1,9 +1,10 @@
-import { isAbsolute, resolve, join } from 'node:path';
-import { createHash } from 'node:crypto';
-import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { createHash, createHmac, timingSafeEqual } from 'node:crypto';
 import { existsSync } from 'node:fs';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
 import { createRequire } from 'node:module';
 import { tmpdir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+import { compileMastraWorkflow, } from './mastra/workflow-compiler.js';
 import { buildWorkflowBundleCode } from './workflow-bundler.js';
 import { collectWorkflowBuildResults } from './workflow/collection.js';
 let cachedEsbuild;
@@ -27,11 +28,12 @@ async function loadEsbuild() {
         throw createLoadError(error);
     }
 }
-export async function loadActivitiesFromBundle(bundle) {
+export async function loadActivitiesFromBundle(bundle, options = {}) {
     if (!bundle || typeof bundle.code !== 'string' || bundle.code.trim().length === 0) {
         throw new Error('Activity bundle code must be a non-empty string.');
     }
     verifyActivityBundleIntegrity(bundle);
+    verifyActivityBundleSignature(bundle, options);
     const source = ensureActivityInlineSourceMap(bundle.code, bundle.map);
     const tempPrefix = process.platform === 'win32'
         ? join(process.cwd(), '.temporal-graph-tools-')
@@ -73,9 +75,10 @@ export async function bundleWorkflows(plans, options) {
     if (plans.length === 0) {
         throw new Error('bundleWorkflows requires at least one workflow plan.');
     }
+    const normalizedPlans = plans.map((plan, index) => normalizeWorkflowPlan(plan, index));
     const seenWorkflowNames = new Set();
-    for (let index = 0; index < plans.length; index += 1) {
-        const plan = plans[index];
+    for (let index = 0; index < normalizedPlans.length; index += 1) {
+        const plan = normalizedPlans[index];
         const workflowName = typeof plan.workflowName === 'string' ? plan.workflowName.trim() : '';
         if (workflowName.length === 0) {
             throw new Error(`Workflow plan at index ${index} is missing a valid workflowName. Provide workflowName when building workflows.`);
@@ -85,7 +88,7 @@ export async function bundleWorkflows(plans, options) {
         }
         seenWorkflowNames.add(workflowName);
     }
-    const collection = collectWorkflowBuildResults(plans);
+    const collection = collectWorkflowBuildResults(normalizedPlans);
     const activityBundle = await bundleActivitiesWithEsbuild(collection.activities, options === null || options === void 0 ? void 0 : options.activityBundle);
     const filename = (_a = options === null || options === void 0 ? void 0 : options.filename) !== null && _a !== void 0 ? _a : createBundleFilename(collection.workflows);
     const code = await buildWorkflowBundleCode(collection.workflows, filename);
@@ -94,6 +97,42 @@ export async function bundleWorkflows(plans, options) {
         workflowBundle: { code },
     };
 }
+function normalizeWorkflowPlan(plan, index) {
+    if (isWorkflowBuildResult(plan)) {
+        return plan;
+    }
+    if (isMastraWorkflowCompilationInput(plan)) {
+        return compileMastraWorkflow(plan.workflow, plan.options);
+    }
+    if (isMastraWorkflowLike(plan)) {
+        return compileMastraWorkflow(plan);
+    }
+    throw new Error(`Unsupported workflow plan at index ${index}.`);
+}
+function isWorkflowBuildResult(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.workflowName === 'string' &&
+        typeof candidate.workflowSource === 'string' &&
+        typeof candidate.activities === 'object' &&
+        candidate.activities !== null);
+}
+function isMastraWorkflowCompilationInput(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return typeof candidate.workflow === 'object' && candidate.workflow !== null;
+}
+function isMastraWorkflowLike(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return Array.isArray(candidate.stepGraph);
+}
 function createBundleFilename(workflows) {
     const baseName = workflows
         .map((workflow) => workflow.workflowName)
@@ -154,11 +193,14 @@ async function bundleActivitiesWithEsbuild(bundles, options = {}) {
     if (!jsFile) {
         throw new Error('Failed to generate activities bundle.');
     }
+    const signingKey = normalizeSigningKey(options.signingKey);
+    const integrity = createIntegrityHash(jsFile.text);
     return {
         filename,
         code: jsFile.text,
         ...(mapFile ? { map: mapFile.text } : {}),
-        integrity: createIntegrityHash(jsFile.text),
+        integrity,
+        ...(signingKey ? { signature: createBundleSignature(jsFile.text, signingKey) } : {}),
     };
 }
 function normalizeActivityEntrypoints(cwd, entrypoints) {
@@ -279,6 +321,17 @@ function createIntegrityHash(code) {
     const digest = createHash('sha256').update(code, 'utf8').digest('base64');
     return `sha256-${digest}`;
 }
+function normalizeSigningKey(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function createBundleSignature(code, signingKey) {
+    const digest = createHmac('sha256', signingKey).update(code, 'utf8').digest('base64');
+    return `hmac-sha256-${digest}`;
+}
 function verifyActivityBundleIntegrity(bundle) {
     if (bundle.integrity) {
         const expected = bundle.integrity.trim();
@@ -290,3 +343,26 @@ function verifyActivityBundleIntegrity(bundle) {
     }
     throw new Error('Activity bundle is missing integrity metadata. Regenerate with bundleWorkflows().');
 }
+function verifyActivityBundleSignature(bundle, options) {
+    const signature = typeof bundle.signature === 'string' ? bundle.signature.trim() : '';
+    if (signature.length === 0) {
+        throw new Error('Unsigned activity bundle rejected. Use bundleWorkflows({ activityBundle: { signingKey } }) and pass verificationKey to loadActivitiesFromBundle().');
+    }
+    const verificationKey = normalizeSigningKey(options.verificationKey);
+    if (!verificationKey) {
+        throw new Error('Activity bundle is signed but verificationKey was not provided to loadActivitiesFromBundle().');
+    }
+    if (!isValidSignatureFormat(signature)) {
+        throw new Error('Activity bundle signature has an invalid format.');
+    }
+    const expected = createBundleSignature(bundle.code, verificationKey);
+    const expectedBuffer = Buffer.from(expected, 'utf8');
+    const receivedBuffer = Buffer.from(signature, 'utf8');
+    if (expectedBuffer.length !== receivedBuffer.length ||
+        !timingSafeEqual(expectedBuffer, receivedBuffer)) {
+        throw new Error('Activity bundle signature mismatch. Refusing to execute untrusted bundle code.');
+    }
+}
+function isValidSignatureFormat(signature) {
+    return /^hmac-sha256-[A-Za-z0-9+/=]+$/.test(signature);
+}

package/dist/src/index.d.ts

@@ -5,4 +5,6 @@ export { collectWorkflowBuildResults } from './workflow/collection.js';
 export * from './bundler.js';
 export * from './mastra/agent-wrapper.js';
 export * from './mastra/create-activity-with-mastra.js';
+export * from './mastra/with-mastra-agent.js';
+export * from './mastra/workflow-compiler.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC9E,cAAc,uBAAuB,CAAA;AACrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA;AACtE,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,cAAc,yCAAyC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC9E,cAAc,uBAAuB,CAAA;AACrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA;AACtE,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,cAAc,yCAAyC,CAAA;AACvD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA"}

package/dist/src/index.js

@@ -5,3 +5,5 @@ export { collectWorkflowBuildResults } from './workflow/collection.js';
 export * from './bundler.js';
 export * from './mastra/agent-wrapper.js';
 export * from './mastra/create-activity-with-mastra.js';
+export * from './mastra/with-mastra-agent.js';
+export * from './mastra/workflow-compiler.js';

package/dist/src/mastra/agent-wrapper.d.ts

@@ -5,12 +5,12 @@ export type AgentConstructorInput = ConstructorParameters<typeof MastraAgent>[0]
 export type AgentRuntimeContext = {
     initializedAgent?: AnyAgent;
 };
-export type RunStructuredAgentOptions<Schema extends z.ZodTypeAny> = {
+export type InvokeStructuredAgentOptions<Schema extends z.ZodTypeAny> = {
     agentInput: AgentConstructorInput;
     context: AgentRuntimeContext;
     prompt: string;
     schema: Schema;
 };
-export declare function runStructuredAgent<Schema extends z.ZodTypeAny>(options: RunStructuredAgentOptions<Schema>): Promise<z.infer<Schema>>;
+export declare function invokeStructuredAgent<Schema extends z.ZodTypeAny>(options: InvokeStructuredAgentOptions<Schema>): Promise<z.infer<Schema>>;
 export {};
 //# sourceMappingURL=agent-wrapper.d.ts.map

package/dist/src/mastra/agent-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-wrapper.d.ts","sourceRoot":"","sources":["../../../src/mastra/agent-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,KAAK,QAAQ,GAAG,YAAY,CAAC,OAAO,WAAW,CAAC,CAAA;AAEhD,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;AAEhF,MAAM,MAAM,mBAAmB,GAAG;IAChC,gBAAgB,CAAC,EAAE,QAAQ,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,yBAAyB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,IAAI;IACnE,UAAU,EAAE,qBAAqB,CAAA;IACjC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAsB,kBAAkB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAClE,OAAO,EAAE,yBAAyB,CAAC,MAAM,CAAC,GACzC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAY1B"}
+{"version":3,"file":"agent-wrapper.d.ts","sourceRoot":"","sources":["../../../src/mastra/agent-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,KAAK,QAAQ,GAAG,YAAY,CAAC,OAAO,WAAW,CAAC,CAAA;AAEhD,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;AAEhF,MAAM,MAAM,mBAAmB,GAAG;IAChC,gBAAgB,CAAC,EAAE,QAAQ,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,4BAA4B,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,IAAI;IACtE,UAAU,EAAE,qBAAqB,CAAA;IACjC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAsB,qBAAqB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EACrE,OAAO,EAAE,4BAA4B,CAAC,MAAM,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAY1B"}

package/dist/src/mastra/agent-wrapper.js

@@ -1,5 +1,5 @@
 import { Agent as MastraAgent } from '@mastra/core/agent';
-export async function runStructuredAgent(options) {
+export async function invokeStructuredAgent(options) {
     var _a;
     const { agentInput, context, prompt, schema } = options;
     const agent = (_a = context.initializedAgent) !== null && _a !== void 0 ? _a : new MastraAgent(agentInput);

package/dist/src/mastra/create-activity-with-mastra.d.ts

@@ -9,6 +9,7 @@ type MastraActivityExecutionContext<TInput> = {
     input: TInput;
     mastraContext?: MastraContext;
     agent: <Schema extends z.ZodTypeAny>(options: {
+        agentInput?: AgentConstructorInput;
         prompt: string;
         schema: Schema;
     }) => Promise<z.infer<Schema>>;

package/dist/src/mastra/create-activity-with-mastra.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-activity-with-mastra.d.ts","sourceRoot":"","sources":["../../../src/mastra/create-activity-with-mastra.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAA;AACpB,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAA;AAE3B,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,qBAAqB,CAAA;IACjC,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC,CAAA;AAED,KAAK,8BAA8B,CAAC,MAAM,IAAI;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,KAAK,EAAE,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE;QAC5C,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;KACf,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;CAC/B,CAAA;AAED,KAAK,mCAAmC,CAAC,EAAE,SAAS,MAAM,IAAI;IAC5D,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9E,eAAe,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;CACjD,CAAA;AAED,MAAM,MAAM,wCAAwC,GAAG,mCAAmC,CAAC,MAAM,CAAC,GAAG;IACnG,EAAE,CAAC,EAAE,SAAS,CAAA;CACf,CAAA;AAED,MAAM,MAAM,qCAAqC,CAAC,EAAE,SAAS,MAAM,IACjE,mCAAmC,CAAC,EAAE,CAAC,GAAG;IACxC,EAAE,EAAE,EAAE,CAAA;CACP,CAAA;AAEH,KAAK,qBAAqB,CAAC,MAAM,EAAE,OAAO,IAAI,CAC5C,OAAO,EAAE,8BAA8B,CAAC,MAAM,CAAC,KAC5C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE/B,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EACtD,OAAO,EAAE,wCAAwC,EACjD,OAAO,EAAE,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9C,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAClC,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,SAAS,MAAM,EACzE,OAAO,EAAE,qCAAqC,CAAC,EAAE,CAAC,EAClD,OAAO,EAAE,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9C,2BAA2B,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA"}
+{"version":3,"file":"create-activity-with-mastra.d.ts","sourceRoot":"","sources":["../../../src/mastra/create-activity-with-mastra.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,aAAa,CAAA;AACpB,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAA;AAE3B,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,qBAAqB,CAAA;IACjC,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC,CAAA;AAED,KAAK,8BAA8B,CAAC,MAAM,IAAI;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,KAAK,EAAE,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE;QAC5C,UAAU,CAAC,EAAE,qBAAqB,CAAA;QAClC,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;KACf,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;CAC/B,CAAA;AAED,KAAK,mCAAmC,CAAC,EAAE,SAAS,MAAM,IAAI;IAC5D,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9E,eAAe,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;CACjD,CAAA;AAED,MAAM,MAAM,wCAAwC,GAClD,mCAAmC,CAAC,MAAM,CAAC,GAAG;IAC5C,EAAE,CAAC,EAAE,SAAS,CAAA;CACf,CAAA;AAEH,MAAM,MAAM,qCAAqC,CAAC,EAAE,SAAS,MAAM,IACjE,mCAAmC,CAAC,EAAE,CAAC,GAAG;IACxC,EAAE,EAAE,EAAE,CAAA;CACP,CAAA;AAEH,KAAK,qBAAqB,CAAC,MAAM,EAAE,OAAO,IAAI,CAC5C,OAAO,EAAE,8BAA8B,CAAC,MAAM,CAAC,KAC5C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE/B,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EACtD,OAAO,EAAE,wCAAwC,EACjD,OAAO,EAAE,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9C,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAClC,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,SAAS,MAAM,EACzE,OAAO,EAAE,qCAAqC,CAAC,EAAE,CAAC,EAClD,OAAO,EAAE,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9C,2BAA2B,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA"}

package/dist/src/mastra/create-activity-with-mastra.js

@@ -1,5 +1,5 @@
 import { createActivity, wrapActivityWithMastraContext, } from '../types.js';
-import { runStructuredAgent, } from './agent-wrapper.js';
+import { invokeStructuredAgent, } from './agent-wrapper.js';
 export function createActivityWithMastra(options, handler) {
     var _a, _b;
     const sharedRuntimeContext = (_a = options.mastraInput) === null || _a === void 0 ? void 0 : _a.agentContext;
@@ -8,12 +8,14 @@ export function createActivityWithMastra(options, handler) {
         return handler({
             input,
             mastraContext,
-            agent: async ({ prompt, schema }) => {
-                if (!options.mastraInput) {
-                    throw new Error('createActivityWithMastra: mastraInput is required when using context.agent(...).');
+            agent: async ({ agentInput, prompt, schema }) => {
+                var _a;
+                const resolvedAgentInput = agentInput !== null && agentInput !== void 0 ? agentInput : (_a = options.mastraInput) === null || _a === void 0 ? void 0 : _a.agentInput;
+                if (!resolvedAgentInput) {
+                    throw new Error('createActivityWithMastra: provide agentInput in options.mastraInput or context.agent({ agentInput, ... }).');
                 }
-                return runStructuredAgent({
-                    agentInput: options.mastraInput.agentInput,
+                return invokeStructuredAgent({
+                    agentInput: resolvedAgentInput,
                     context: runtimeContext,
                     prompt,
                     schema,
@@ -32,7 +34,9 @@ export function createActivityWithMastra(options, handler) {
         return createActivity(wrappedActivity);
     }
     const config = {
-        ...(hasInlineConfig ? Object.fromEntries(inlineConfigEntries) : {}),
+        ...(hasInlineConfig
+            ? Object.fromEntries(inlineConfigEntries)
+            : {}),
         ...(options.id !== undefined ? { id: options.id } : {}),
     };
     return createActivity(wrappedActivity, config);

package/dist/src/mastra/with-mastra-agent.d.ts

@@ -0,0 +1,12 @@
+import type { z } from 'zod';
+import type { CreateActivity } from '../types.js';
+import { type AgentConstructorInput } from './agent-wrapper.js';
+export declare function wrapActivityWithMastraAgent<TInput, TOutput>(handler: (context: {
+    input: TInput;
+    agent: <Schema extends z.ZodTypeAny>(options: {
+        agentInput: AgentConstructorInput;
+        prompt: string;
+        schema: Schema;
+    }) => Promise<z.infer<Schema>>;
+}) => TOutput | Promise<TOutput>): CreateActivity<TInput, TOutput>;
+//# sourceMappingURL=with-mastra-agent.d.ts.map

package/dist/src/mastra/with-mastra-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-mastra-agent.d.ts","sourceRoot":"","sources":["../../../src/mastra/with-mastra-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAG/D,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,OAAO,EACzD,OAAO,EAAE,CAAC,OAAO,EAAE;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE;QAC5C,UAAU,EAAE,qBAAqB,CAAA;QACjC,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;KACf,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;CAC/B,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC/B,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjC"}

package/dist/src/mastra/with-mastra-agent.js

@@ -0,0 +1,4 @@
+import { createActivityWithMastra } from './create-activity-with-mastra.js';
+export function wrapActivityWithMastraAgent(handler) {
+    return createActivityWithMastra({}, handler);
+}

package/dist/src/mastra/workflow-compiler.d.ts

@@ -0,0 +1,23 @@
+import { type TemporalWorkflowBuildOptions, type WorkflowBuildResult } from '../types.js';
+export type MastraWorkflowLike = {
+    id?: string;
+    engineType?: string;
+    stepGraph: Array<Record<string, unknown>>;
+};
+export type CompileMastraWorkflowOptions = Omit<TemporalWorkflowBuildOptions, 'workflowName'> & {
+    workflowName?: string;
+    stepActivities?: Record<string, unknown>;
+    /**
+     * @warning Unsafe fallback mode.
+     * When true, missing step activities are executed through a synthetic wrapper that calls `step.execute()`
+     * with a partial context object. This may be incompatible with complex Mastra steps.
+     * Prefer providing explicit `stepActivities` for every step.
+     */
+    allowUnsafeStepExecuteFallback?: boolean;
+};
+export type MastraWorkflowCompilationInput = {
+    workflow: MastraWorkflowLike;
+    options?: CompileMastraWorkflowOptions;
+};
+export declare function compileMastraWorkflow(workflow: MastraWorkflowLike, options?: CompileMastraWorkflowOptions): WorkflowBuildResult;
+//# sourceMappingURL=workflow-compiler.d.ts.map

package/dist/src/mastra/workflow-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-compiler.d.ts","sourceRoot":"","sources":["../../../src/mastra/workflow-compiler.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAA;AAQpB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC,4BAA4B,EAAE,cAAc,CAAC,GAAG;IAC9F,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC;;;;;OAKG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,OAAO,CAAC,EAAE,4BAA4B,CAAA;CACvC,CAAA;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,4BAAiC,GACzC,mBAAmB,CA+DrB"}

package/dist/src/mastra/workflow-compiler.js

@@ -0,0 +1,132 @@
+import { WritableStream } from 'node:stream/web';
+import { RequestContext } from '@mastra/core/request-context';
+import { createActivity, } from '../types.js';
+import { createWorkflowBuilder } from '../workflow/builder.js';
+export function compileMastraWorkflow(workflow, options = {}) {
+    if (!workflow || !Array.isArray(workflow.stepGraph)) {
+        throw new Error('compileMastraWorkflow requires a valid Mastra workflow with stepGraph.');
+    }
+    const workflowName = resolveWorkflowName(workflow, options.workflowName);
+    let builder = createWorkflowBuilder({
+        workflowName,
+        ...(options.activitiesImportPath ? { activitiesImportPath: options.activitiesImportPath } : {}),
+        ...(options.proxyOptions ? { proxyOptions: options.proxyOptions } : {}),
+    });
+    workflow.stepGraph.forEach((entry, stageIndex) => {
+        if (entry.type === 'step' && isMastraStepLike(entry.step)) {
+            const reference = resolveStepReference(workflow, entry.step, options.stepActivities, options.allowUnsafeStepExecuteFallback === true);
+            builder = builder.then(reference);
+            return;
+        }
+        if (entry.type === 'parallel' && Array.isArray(entry.steps)) {
+            const references = entry.steps.map((child, branchIndex) => {
+                if (typeof child !== 'object' ||
+                    child === null ||
+                    child.type !== 'step' ||
+                    !isMastraStepLike(child.step)) {
+                    const childType = typeof child === 'object' && child !== null
+                        ? String(child.type)
+                        : typeof child;
+                    throw new Error(`Unsupported Mastra parallel child type '${childType}' at stage ${stageIndex}, branch ${branchIndex}.`);
+                }
+                return resolveStepReference(workflow, child.step, options.stepActivities, options.allowUnsafeStepExecuteFallback === true);
+            });
+            builder = builder.parallel(references);
+            return;
+        }
+        throw new Error(`Unsupported Mastra step graph entry type '${String(entry.type)}' at stage ${stageIndex}.`);
+    });
+    return builder.commit();
+}
+function isMastraStepLike(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const step = value;
+    return typeof step.id === 'string' && typeof step.execute === 'function';
+}
+function resolveWorkflowName(workflow, explicitName) {
+    const explicit = typeof explicitName === 'string' ? explicitName.trim() : '';
+    if (explicit.length > 0) {
+        return explicit;
+    }
+    const workflowId = typeof workflow.id === 'string' ? workflow.id.trim() : '';
+    if (workflowId.length > 0) {
+        return sanitizeWorkflowName(workflowId);
+    }
+    return 'mastraTemporalWorkflow';
+}
+function sanitizeWorkflowName(candidate) {
+    const cleaned = candidate.replace(/[^A-Za-z0-9_$]/g, '_');
+    const startsValid = /^[A-Za-z_$]/.test(cleaned);
+    const base = startsValid ? cleaned : `workflow_${cleaned}`;
+    if (base.length > 0 && !/^_+$/.test(base)) {
+        return base;
+    }
+    return 'mastraTemporalWorkflow';
+}
+function resolveStepReference(workflow, step, stepActivities, allowUnsafeStepExecuteFallback) {
+    var _a;
+    const configured = stepActivities === null || stepActivities === void 0 ? void 0 : stepActivities[step.id];
+    if (typeof configured === 'function') {
+        return createActivity(configured, { id: step.id });
+    }
+    if (isConfiguredActivityReference(configured)) {
+        return createActivity(configured.activity, {
+            ...((_a = configured.config) !== null && _a !== void 0 ? _a : {}),
+            id: step.id,
+        });
+    }
+    if (!allowUnsafeStepExecuteFallback) {
+        throw new Error(`compileMastraWorkflow requires stepActivities['${step.id}'] to be provided. ` +
+            `Automatic fallback execution is disabled by default for safety. ` +
+            `If you must use it, set allowUnsafeStepExecuteFallback: true.`);
+    }
+    const fallbackActivity = createMastraStepActivity(workflow, step);
+    return createActivity(fallbackActivity, { id: step.id });
+}
+function isConfiguredActivityReference(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return typeof candidate.activity === 'function';
+}
+function createMastraStepActivity(workflow, step) {
+    const workflowId = typeof workflow.id === 'string' && workflow.id.trim().length > 0
+        ? workflow.id
+        : 'mastra-workflow';
+    return async (input) => {
+        var _a;
+        const requestContext = new RequestContext();
+        const abortController = new AbortController();
+        const runId = `temporal-${step.id}-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+        const writer = new WritableStream();
+        const executeArgs = {
+            runId,
+            workflowId,
+            inputData: input,
+            requestContext,
+            mastra: undefined,
+            state: {},
+            setState: async () => { },
+            retryCount: 0,
+            tracingContext: {},
+            getInitData: () => input,
+            getStepResult: () => undefined,
+            suspend: () => {
+                throw new Error(`Mastra step '${step.id}' requested suspend(), which is not supported in Temporal activity compilation.`);
+            },
+            bail: (result) => result,
+            abort: () => {
+                throw new Error(`Mastra step '${step.id}' requested abort(), which is not supported in Temporal activity compilation.`);
+            },
+            engine: (_a = workflow.engineType) !== null && _a !== void 0 ? _a : 'default',
+            abortSignal: abortController.signal,
+            writer,
+            outputWriter: undefined,
+            validateSchemas: true,
+        };
+        return step.execute(executeArgs);
+    };
+}

package/dist/src/workflow/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../../src/workflow/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,6BAA6B,EAE9B,MAAM,aAAa,CAAA;AAGpB,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GACtC,6BAA6B,CAqE/B"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../../src/workflow/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,6BAA6B,EAE9B,MAAM,aAAa,CAAA;AAGpB,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GACtC,6BAA6B,CAgE/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primero.ai/temporal-graph-tools",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Utilities for working with DAG workflows.",
   "keywords": [],
   "homepage": "https://github.com/primero-ai/temporal-graph-tools#readme",
@@ -70,39 +70,38 @@
     "worker": "bun with-env tsx examples/worker.ts",
     "deps:update": "bun x npm-check-updates -ui -ws",
     "trigger-mastra-workflow": "bun with-env bun examples/trigger-mastra-workflow.ts",
-    "trigger-normal-workflow": "bun with-env bun examples/trigger-normal-workflow.ts",
     "clean": "rm -rf node_modules dist"
   },
   "dependencies": {
     "@ai-sdk/openai": "^3.0.30",
     "@mastra/core": "^1.4.0",
-    "@temporalio/activity": "^1.14.1",
-    "@temporalio/client": "1.14.1",
-    "@temporalio/worker": "1.14.1",
-    "@temporalio/workflow": "1.14.1",
-    "lodash": "^4.17.21",
-    "zod": "4.1.12"
+    "@temporalio/activity": "^1.15.0",
+    "@temporalio/client": "1.15.0",
+    "@temporalio/worker": "1.15.0",
+    "@temporalio/workflow": "1.15.0",
+    "lodash": "^4.17.23",
+    "zod": "4.3.6"
   },
   "devDependencies": {
     "@types/lodash": "^4.17.23",
-    "tsx": "^4.19.2",
-    "@eslint/js": "^9.39.2",
-    "dotenv": "^17.2.3",
+    "tsx": "^4.21.0",
+    "@eslint/js": "^10.0.1",
+    "dotenv": "^17.3.1",
     "dotenv-cli": "^11.0.0",
-    "@ianvs/prettier-plugin-sort-imports": "^4.7.0",
-    "@types/node": "^25.0.9",
-    "esbuild": "^0.27.2",
-    "eslint": "^9.39.2",
+    "@ianvs/prettier-plugin-sort-imports": "^4.7.1",
+    "@types/node": "^25.2.3",
+    "esbuild": "^0.27.3",
+    "eslint": "^10.0.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "prettier-plugin-tailwindcss": "^0.7.2",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.1"
+    "typescript-eslint": "^8.56.0"
   },
   "engines": {
     "node": ">=18"
   },
   "module": "dist/src/index.js",
-  "packageManager": "bun@1.3.6"
+  "packageManager": "bun@1.3.9"
 }

package/dist/examples/mastra-ai-workflow/workflows.d.ts

@@ -1,2 +0,0 @@
-export declare const builderMastraAiSupportWorkflow: import("@primero.ai/temporal-graph-tools").WorkflowBuildResult;
-//# sourceMappingURL=workflows.d.ts.map

package/dist/examples/mastra-ai-workflow/workflows.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../examples/mastra-ai-workflow/workflows.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,8BAA8B,gEAQhC,CAAA"}

package/dist/examples/mastra-ai-workflow/workflows.js

@@ -1,11 +0,0 @@
-import { createWorkflowBuilder } from '@primero.ai/temporal-graph-tools';
-import { classifyOutageWithAi, draftResponseWithAi, enrichOutageDescription, submitResponse, takeTicket, } from './activities';
-export const builderMastraAiSupportWorkflow = createWorkflowBuilder({
-    workflowName: 'mastraAiSupportWorkflow',
-    proxyOptions: { startToCloseTimeout: '2 minutes' },
-})
-    .then(takeTicket)
-    .parallel([classifyOutageWithAi, enrichOutageDescription])
-    .then(draftResponseWithAi)
-    .then(submitResponse)
-    .commit();

package/dist/examples/mastra-example.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=mastra-example.d.ts.map

package/dist/examples/mastra-example.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mastra-example.d.ts","sourceRoot":"","sources":["../../examples/mastra-example.ts"],"names":[],"mappings":""}

package/dist/examples/mastra-example.js

@@ -1,103 +0,0 @@
-import { createActivity, createWorkflowBuilder, wrapActivityWithMastraContext, } from '@primero.ai/temporal-graph-tools';
-function withMastraLogging(id, activity) {
-    return createActivity(wrapActivityWithMastraContext(activity, async ({ context, execute }) => {
-        var _a, _b;
-        if (context) {
-            console.log(`[mastra] workflow=${context.workflow.name} node=${context.node.key} type=${context.node.stageType} stage=${context.node.stageIndex} previous=${(_b = (_a = context.previousNode) === null || _a === void 0 ? void 0 : _a.key) !== null && _b !== void 0 ? _b : 'none'}`);
-        }
-        return execute();
-    }), { id });
-}
-const normalizeLead = withMastraLogging('normalizeLead', async (input) => {
-    const normalizedEmail = input.email.trim().toLowerCase();
-    return {
-        id: normalizedEmail.split('@')[0],
-        name: input.name.trim(),
-        email: normalizedEmail,
-    };
-});
-const scoreLead = withMastraLogging('scoreLead', async (lead) => {
-    const score = lead.email.endsWith('.edu') ? 82 : 64;
-    return { lead, score };
-});
-const createCrmTask = withMastraLogging('createCrmTask', async ({ lead, score }) => {
-    return { taskId: `crm-${lead.id}-${score}`, queued: true };
-});
-const notifySales = withMastraLogging('notifySales', async ({ lead, score }) => {
-    console.log(`[sales] lead=${lead.email} score=${score}`);
-    return { channel: 'slack', sent: true };
-});
-const finalizeLead = withMastraLogging('finalizeLead', async (result) => {
-    console.log(`[finalize] task=${result.createCrmTask.taskId} notify=${result.notifySales.sent}`);
-    return { completed: true };
-});
-const builderMastra = createWorkflowBuilder({
-    workflowName: 'mastraLeadWorkflow',
-    proxyOptions: { startToCloseTimeout: '2 minutes' },
-})
-    .then(normalizeLead)
-    .then(scoreLead)
-    .parallel([createCrmTask, notifySales])
-    .then(finalizeLead)
-    .commit();
-function makeContext(workflowName, totalStages, node, previousNode) {
-    return {
-        workflow: { name: workflowName },
-        graph: { totalStages },
-        node,
-        previousNode,
-    };
-}
-async function runLocalDryRun() {
-    console.log(`Workflow: ${builderMastra.workflowName}`);
-    console.log('\nGenerated workflow source:\n');
-    console.log(builderMastra.workflowSource);
-    const totalStages = 4;
-    const workflowName = builderMastra.workflowName;
-    const input = { name: '  Ada Lovelace ', email: 'Ada@Example.com ' };
-    const step0Node = {
-        key: 'normalizeLead',
-        stageIndex: 0,
-        stageType: 'step',
-    };
-    const normalized = await normalizeLead.activity(input, makeContext(workflowName, totalStages, step0Node, null));
-    const step1Node = {
-        key: 'scoreLead',
-        stageIndex: 1,
-        stageType: 'step',
-    };
-    const scored = await scoreLead.activity(normalized, makeContext(workflowName, totalStages, step1Node, step0Node));
-    const parallelNodeA = {
-        key: 'createCrmTask',
-        stageIndex: 2,
-        stageType: 'parallel',
-        branchIndex: 0,
-    };
-    const parallelNodeB = {
-        key: 'notifySales',
-        stageIndex: 2,
-        stageType: 'parallel',
-        branchIndex: 1,
-    };
-    const [crmTask, salesMessage] = await Promise.all([
-        createCrmTask.activity(scored, makeContext(workflowName, totalStages, parallelNodeA, step1Node)),
-        notifySales.activity(scored, makeContext(workflowName, totalStages, parallelNodeB, step1Node)),
-    ]);
-    const step3Node = {
-        key: 'finalizeLead',
-        stageIndex: 3,
-        stageType: 'step',
-    };
-    const parallelAggregateNode = {
-        key: 'parallel_2',
-        stageIndex: 2,
-        stageType: 'parallel',
-    };
-    const finalResult = await finalizeLead.activity({ createCrmTask: crmTask, notifySales: salesMessage }, makeContext(workflowName, totalStages, step3Node, parallelAggregateNode));
-    console.log('\nDry run result:');
-    console.log(finalResult);
-}
-runLocalDryRun().catch((error) => {
-    console.error('Mastra example failed:', error);
-    process.exitCode = 1;
-});