@mantajs/core 0.1.7 → 0.2.0-beta.0

package/dist/user/models/user.d.ts

@@ -0,0 +1,15 @@
+export declare const User: import("../..").DmlEntity<{
+    first_name: import("../../dml/properties/base").NullableApi<string>;
+    last_name: import("../../dml/properties/base").NullableApi<string>;
+    email: import("../../dml/properties/base").TextApi;
+    avatar_url: import("../../dml/properties/base").NullableApi<string>;
+    metadata: import("../../dml/properties/base").NullableApi<any>;
+}>;
+export declare const Invite: import("../..").DmlEntity<{
+    email: import("../../dml/properties/base").TextApi;
+    accepted: import("../../dml/properties/base").BooleanApi;
+    token: import("../../dml/properties/base").TextApi;
+    expires_at: import("../../dml/properties/base").DateTimeApi;
+    metadata: import("../../dml/properties/base").NullableApi<any>;
+}>;
+//# sourceMappingURL=user.d.ts.map

package/dist/user/models/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/user/models/user.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI;;;;;;EAMf,CAAA;AAEF,eAAO,MAAM,MAAM;;;;;;EAMjB,CAAA"}

package/dist/user/models/user.js

@@ -0,0 +1,16 @@
+import { field, model } from '../../dml/model';
+export const User = model.define('User', {
+    first_name: field.text().nullable(),
+    last_name: field.text().nullable(),
+    email: field.text().unique(),
+    avatar_url: field.text().nullable(),
+    metadata: field.json().nullable(),
+});
+export const Invite = model.define('Invite', {
+    email: field.text().index(),
+    accepted: field.boolean().default(false),
+    token: field.text(),
+    expires_at: field.dateTime(),
+    metadata: field.json().nullable(),
+});
+//# sourceMappingURL=user.js.map

package/dist/user/models/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../../src/user/models/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;IACvC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE;IAC5B,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACnC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;IAC3C,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE;IAC3B,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACxC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;IACnB,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAA"}

package/dist/user/user-module-service.d.ts

@@ -0,0 +1,55 @@
+import type { AuthModuleService } from '../auth/auth-module-service';
+import type { IRepository } from '../ports/repository';
+export interface UserModuleServiceDeps {
+    baseRepository: IRepository;
+    userRepository: IRepository;
+    inviteRepository: IRepository;
+    authModuleService?: AuthModuleService;
+    jwtSecret?: string;
+}
+interface UserDTO {
+    id: string;
+    first_name: string | null;
+    last_name: string | null;
+    email: string;
+    avatar_url: string | null;
+    metadata: Record<string, unknown> | null;
+}
+interface InviteDTO {
+    id: string;
+    email: string;
+    accepted: boolean;
+    token: string;
+    expires_at: Date;
+    metadata: Record<string, unknown> | null;
+}
+export declare class UserModuleService {
+    private userRepo;
+    private inviteRepo;
+    private authModuleService?;
+    private jwtSecret;
+    constructor(deps: UserModuleServiceDeps);
+    createUsers(data: Array<{
+        email: string;
+        first_name?: string;
+        last_name?: string;
+        metadata?: Record<string, unknown>;
+    }>): Promise<UserDTO[]>;
+    retrieveUser(id: string): Promise<UserDTO>;
+    listUsers(filters?: Record<string, unknown>): Promise<UserDTO[]>;
+    updateUsers(data: Array<{
+        id: string;
+    } & Partial<UserDTO>>): Promise<UserDTO[]>;
+    deleteUsers(ids: string[]): Promise<void>;
+    createInvites(data: Array<{
+        email: string;
+        metadata?: Record<string, unknown>;
+    }>): Promise<InviteDTO[]>;
+    validateInviteToken(token: string): Promise<InviteDTO>;
+    acceptInvite(inviteId: string): Promise<InviteDTO>;
+    listInvites(filters?: Record<string, unknown>): Promise<InviteDTO[]>;
+    deleteInvites(ids: string[]): Promise<void>;
+    refreshInviteTokens(inviteIds: string[]): Promise<InviteDTO[]>;
+}
+export {};
+//# sourceMappingURL=user-module-service.d.ts.map

package/dist/user/user-module-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-module-service.d.ts","sourceRoot":"","sources":["../../src/user/user-module-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,WAAW,CAAA;IAC3B,cAAc,EAAE,WAAW,CAAA;IAC3B,gBAAgB,EAAE,WAAW,CAAA;IAC7B,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACzC;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,IAAI,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACzC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAmB;IAC7C,OAAO,CAAC,SAAS,CAAQ;gBAEb,IAAI,EAAE,qBAAqB;IASjC,WAAW,CACf,IAAI,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GAC1G,OAAO,CAAC,OAAO,EAAE,CAAC;IAIf,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM1C,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIhE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAS/E,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAuBvG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAWtD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAKlD,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIpE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CA0BrE"}

package/dist/user/user-module-service.js

@@ -0,0 +1,100 @@
+// UserModuleService — manages User and Invite entities.
+// ISO Medusa V2's UserModuleService interface.
+import { MantaError } from '../errors/manta-error';
+export class UserModuleService {
+    userRepo;
+    inviteRepo;
+    authModuleService;
+    jwtSecret;
+    constructor(deps) {
+        this.userRepo = deps.userRepository;
+        this.inviteRepo = deps.inviteRepository;
+        this.authModuleService = deps.authModuleService;
+        this.jwtSecret = deps.jwtSecret ?? process.env.JWT_SECRET ?? 'manta-dev-secret';
+    }
+    // --- User CRUD ---
+    async createUsers(data) {
+        return (await this.userRepo.create(data));
+    }
+    async retrieveUser(id) {
+        const results = (await this.userRepo.find({ where: { id } }));
+        if (results.length === 0)
+            throw new MantaError('NOT_FOUND', `User "${id}" not found`);
+        return results[0];
+    }
+    async listUsers(filters) {
+        return (await this.userRepo.find({ where: filters }));
+    }
+    async updateUsers(data) {
+        const results = [];
+        for (const item of data) {
+            const updated = (await this.userRepo.update(item));
+            results.push(updated);
+        }
+        return results;
+    }
+    async deleteUsers(ids) {
+        await this.userRepo.delete(ids);
+    }
+    // --- Invite management ---
+    async createInvites(data) {
+        const invites = [];
+        for (const item of data) {
+            const expiresAt = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000); // 7 days
+            const token = this.authModuleService
+                ? await this.authModuleService.generateToken({ id: item.email, type: 'invite', auth_identity_id: '' }, this.jwtSecret, '7d')
+                : `invite_${crypto.randomUUID()}`;
+            invites.push({
+                email: item.email,
+                accepted: false,
+                token,
+                expires_at: expiresAt,
+                metadata: item.metadata ?? {},
+            });
+        }
+        return (await this.inviteRepo.create(invites));
+    }
+    async validateInviteToken(token) {
+        const results = (await this.inviteRepo.find({ where: { token } }));
+        if (results.length === 0)
+            throw new MantaError('NOT_FOUND', 'Invalid invite token');
+        const invite = results[0];
+        if (invite.accepted)
+            throw new MantaError('INVALID_DATA', 'Invite already accepted');
+        if (new Date(invite.expires_at) < new Date())
+            throw new MantaError('UNAUTHORIZED', 'Invite token expired');
+        return invite;
+    }
+    async acceptInvite(inviteId) {
+        const [updated] = (await this.inviteRepo.update([{ id: inviteId, accepted: true }]));
+        return updated;
+    }
+    async listInvites(filters) {
+        return (await this.inviteRepo.find({ where: filters }));
+    }
+    async deleteInvites(ids) {
+        await this.inviteRepo.delete(ids);
+    }
+    async refreshInviteTokens(inviteIds) {
+        const results = [];
+        for (const id of inviteIds) {
+            const invite = (await this.inviteRepo.find({ where: { id } }));
+            if (invite.length === 0)
+                continue;
+            const nonce = crypto.randomUUID();
+            const newToken = this.authModuleService
+                ? await this.authModuleService.generateToken({ id: invite[0].email, type: 'invite', auth_identity_id: nonce }, this.jwtSecret, '7d')
+                : `invite_${nonce}`;
+            const [updated] = (await this.inviteRepo.update([
+                {
+                    id,
+                    token: newToken,
+                    expires_at: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000),
+                },
+            ]));
+            results.push(updated);
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=user-module-service.js.map

package/dist/user/user-module-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-module-service.js","sourceRoot":"","sources":["../../src/user/user-module-service.ts"],"names":[],"mappings":"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"}

package/dist/workflows/ai-step.d.ts

@@ -0,0 +1,2 @@
+export declare function executeAgent(agentDef: any, _parsedInput: unknown, promptText: string): Promise<unknown>;
+//# sourceMappingURL=ai-step.d.ts.map

package/dist/workflows/ai-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-step.d.ts","sourceRoot":"","sources":["../../src/workflows/ai-step.ts"],"names":[],"mappings":"AA2CA,wBAAsB,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa7G"}

package/dist/workflows/ai-step.js

@@ -0,0 +1,54 @@
+// AI step implementation — isolated to avoid requiring ai SDK at compile time.
+// This file is loaded dynamically via require() only when step.agent is called.
+import { MantaError } from '../errors/manta-error';
+// biome-ignore lint/suspicious/noExplicitAny: AI SDK model type varies
+async function resolveAiModel(modelName) {
+    const provider = process.env.MANTA_AI_PROVIDER ?? 'anthropic';
+    switch (provider) {
+        case 'anthropic': {
+            const key = process.env.ANTHROPIC_API_KEY;
+            if (!key)
+                throw new MantaError('INVALID_DATA', 'step.agent requires ANTHROPIC_API_KEY environment variable');
+            const mod = await import(/* @vite-ignore */ '@ai-sdk/anthropic');
+            return mod.createAnthropic({ apiKey: key })(modelName ?? 'claude-sonnet-4-20250514');
+        }
+        case 'openai': {
+            const key = process.env.OPENAI_API_KEY;
+            if (!key)
+                throw new MantaError('INVALID_DATA', 'step.agent requires OPENAI_API_KEY environment variable');
+            const mod = await import(/* @vite-ignore */ '@ai-sdk/openai');
+            return mod.createOpenAI({ apiKey: key })(modelName ?? 'gpt-4o');
+        }
+        case 'google': {
+            const key = process.env.GOOGLE_AI_API_KEY;
+            if (!key)
+                throw new MantaError('INVALID_DATA', 'step.agent requires GOOGLE_AI_API_KEY environment variable');
+            const mod = await import(/* @vite-ignore */ '@ai-sdk/google');
+            return mod.createGoogleGenerativeAI({ apiKey: key })(modelName ?? 'gemini-2.0-flash');
+        }
+        case 'mistral': {
+            const key = process.env.MISTRAL_API_KEY;
+            if (!key)
+                throw new MantaError('INVALID_DATA', 'step.agent requires MISTRAL_API_KEY environment variable');
+            const mod = await import(/* @vite-ignore */ '@ai-sdk/mistral');
+            return mod.createMistral({ apiKey: key })(modelName ?? 'mistral-large-latest');
+        }
+        default:
+            throw new MantaError('INVALID_DATA', `Unknown AI provider "${provider}". Set MANTA_AI_PROVIDER to anthropic, openai, google, or mistral.`);
+    }
+}
+// biome-ignore lint/suspicious/noExplicitAny: AgentDefinition generic
+export async function executeAgent(agentDef, _parsedInput, promptText) {
+    const mod = await import(/* @vite-ignore */ 'ai');
+    const model = await resolveAiModel(agentDef.model);
+    const result = await mod.generateObject({
+        model,
+        prompt: promptText,
+        schema: agentDef.output,
+        temperature: agentDef.temperature ?? 0,
+        maxTokens: agentDef.maxTokens,
+        system: agentDef.system,
+    });
+    return result.object;
+}
+//# sourceMappingURL=ai-step.js.map

package/dist/workflows/ai-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-step.js","sourceRoot":"","sources":["../../src/workflows/ai-step.ts"],"names":[],"mappings":"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"}

package/dist/workflows/create-step.d.ts

@@ -0,0 +1,16 @@
+import type { StepContext, StepFn } from './types';
+/**
+ * Create a workflow step.
+ *
+ * @example
+ * const createProduct = createStep('create-product',
+ *   async (input, { app }) => {
+ *     return await app.modules.product.create(input)
+ *   },
+ *   async (product, { app }) => {
+ *     await app.modules.product.delete(product.id)
+ *   }
+ * )
+ */
+export declare function createStep<TInput = unknown, TOutput = unknown>(name: string, handler: (input: TInput, ctx: StepContext) => Promise<TOutput>, compensate?: (output: TOutput, ctx: StepContext) => Promise<void>): StepFn<TInput, TOutput>;
+//# sourceMappingURL=create-step.d.ts.map

package/dist/workflows/create-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-step.d.ts","sourceRoot":"","sources":["../../src/workflows/create-step.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAmB,MAAM,SAAS,CAAA;AAGnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC5D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,EAC9D,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAChE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6IzB"}

package/dist/workflows/create-step.js

@@ -0,0 +1,194 @@
+// createStep() — imperative, self-checkpointing step factory.
+// Uses AsyncLocalStorage to access workflow context.
+import { createForEach } from './for-each';
+import { workflowContextStorage } from './manager';
+import { CancelledError, createProgress } from './progress-helper';
+import { isWorkflowYield, WorkflowYield } from './yield';
+/**
+ * Create a workflow step.
+ *
+ * @example
+ * const createProduct = createStep('create-product',
+ *   async (input, { app }) => {
+ *     return await app.modules.product.create(input)
+ *   },
+ *   async (product, { app }) => {
+ *     await app.modules.product.delete(product.id)
+ *   }
+ * )
+ */
+export function createStep(name, handler, compensate) {
+    const stepFn = async (input, ctx) => {
+        // Get workflow context — try ALS first, then explicit context (bundler compatibility)
+        const wfCtx = workflowContextStorage.getStore() ?? ctx.__wfCtx ?? null;
+        if (!wfCtx) {
+            // Standalone mode — just run the handler directly
+            return handler(input, ctx);
+        }
+        // Generate unique step key (handles loops: step-name, step-name-2, step-name-3...)
+        const count = (wfCtx.stepCounter.get(name) ?? 0) + 1;
+        wfCtx.stepCounter.set(name, count);
+        const stepKey = count === 1 ? name : `${name}-${count}`;
+        // Check for existing checkpoint (crash recovery / resume)
+        if (wfCtx.checkpoints.has(stepKey)) {
+            const cached = wfCtx.checkpoints.get(stepKey);
+            if (compensate) {
+                wfCtx.completedSteps.push({
+                    name: stepKey,
+                    output: cached,
+                    compensate: async (output, stepCtx) => compensate(output, stepCtx),
+                });
+            }
+            else {
+                wfCtx.completedSteps.push({ name: stepKey, output: cached });
+            }
+            return cached;
+        }
+        // Cancel check BEFORE invoking. Cheap when no store is wired.
+        await preStepCancelCheck(wfCtx, stepKey);
+        // Tag the current step on wfCtx so ctx.progress / ctx.forEach know which
+        // step is reporting, and so the store's updateStep targets the right row.
+        const previousStepName = wfCtx.stepName;
+        wfCtx.stepName = stepKey;
+        // Durable store — mark step as running (best effort).
+        if (wfCtx.store) {
+            try {
+                await wfCtx.store.updateStep(wfCtx.runId, stepKey, {
+                    status: 'running',
+                    started_at: new Date(),
+                });
+            }
+            catch {
+                // Store failures MUST NOT fail the workflow — swallow. The engine's
+                // logger wrappers in manager.ts handle the visible cases.
+            }
+        }
+        // Augment the StepContext with progress / signal / forEach / yield bound
+        // to this run. `resumeState` is populated only if this step yielded on a
+        // previous invocation and the manager loaded its state for resume.
+        const yieldFn = ((state) => {
+            throw new WorkflowYield(state);
+        });
+        const augmentedCtx = {
+            ...ctx,
+            __wfCtx: wfCtx,
+            signal: wfCtx.signal ?? ctx.signal,
+            progress: createProgress(wfCtx),
+            forEach: createForEach(wfCtx),
+            yield: yieldFn,
+            resumeState: wfCtx.resumeStates?.get(stepKey),
+            budgetMs: wfCtx.budgetMs,
+        };
+        // Execute the handler
+        let output;
+        try {
+            output = await handler(input, augmentedCtx);
+        }
+        catch (err) {
+            // Yield is NOT a failure — mark the step as paused with its resumeState
+            // and re-throw so the manager can pause the whole run + enqueue a
+            // continuation. Compensation MUST NOT run (no failure occurred).
+            if (isWorkflowYield(err)) {
+                if (wfCtx.store) {
+                    try {
+                        await wfCtx.store.updateStep(wfCtx.runId, stepKey, {
+                            status: 'paused',
+                            resume_state: err.resumeState,
+                        });
+                    }
+                    catch {
+                        /* store errors are non-fatal; manager will retry on resume */
+                    }
+                }
+                wfCtx.stepName = previousStepName;
+                throw err;
+            }
+            const cancelled = isCancel(err);
+            if (wfCtx.store) {
+                try {
+                    await wfCtx.store.updateStep(wfCtx.runId, stepKey, {
+                        status: cancelled ? 'cancelled' : 'failed',
+                        completed_at: new Date(),
+                        error: cancelled ? undefined : { message: err?.message ?? String(err) },
+                    });
+                }
+                catch {
+                    /* store errors are non-fatal */
+                }
+            }
+            wfCtx.stepName = previousStepName;
+            throw err;
+        }
+        // Register for compensation (only if explicit compensate provided)
+        if (compensate) {
+            wfCtx.completedSteps.push({
+                name: stepKey,
+                output,
+                compensate: async (out, stepCtx) => compensate(out, stepCtx),
+            });
+        }
+        else {
+            wfCtx.completedSteps.push({ name: stepKey, output });
+        }
+        // Save checkpoint (in-memory + persist to storage for crash recovery)
+        wfCtx.checkpoints.set(stepKey, output);
+        if (wfCtx.saveCheckpoint)
+            await wfCtx.saveCheckpoint(stepKey, output);
+        // Durable store — mark step as succeeded (best effort).
+        if (wfCtx.store) {
+            try {
+                await wfCtx.store.updateStep(wfCtx.runId, stepKey, {
+                    status: 'succeeded',
+                    completed_at: new Date(),
+                });
+            }
+            catch {
+                /* store errors are non-fatal */
+            }
+        }
+        wfCtx.stepName = previousStepName;
+        return output;
+    };
+    Object.defineProperty(stepFn, '__stepName', { value: name });
+    Object.defineProperty(stepFn, '__isStep', { value: true });
+    return stepFn;
+}
+function isCancel(err) {
+    if (err instanceof CancelledError)
+        return true;
+    if (err && typeof err === 'object') {
+        const e = err;
+        if (e.code === 'WORKFLOW_CANCELLED' || e.name === 'CancelledError')
+            return true;
+    }
+    return false;
+}
+/**
+ * Before a step runs, if the store is wired AND we have a runId, check whether
+ * cancellation has been requested. If so, abort the controller and throw.
+ *
+ * Rationale: at PR-3 we don't yet have eventbus-based cancel propagation (that's
+ * PR-4). Step-boundary checks are the best we can do; long single steps must
+ * cooperate via `ctx.signal` + `ctx.forEach`.
+ *
+ * Note: `store.get` MAY throw — if it does we let it bubble so an actionable
+ * failure is visible, per the plan's resilience invariant.
+ */
+async function preStepCancelCheck(wfCtx, stepKey) {
+    // Already aborted? Throw immediately.
+    if (wfCtx.signal?.aborted)
+        throw new CancelledError(`Workflow ${wfCtx.runId} cancelled before step "${stepKey}"`);
+    if (!wfCtx.store)
+        return;
+    const run = await wfCtx.store.get(wfCtx.runId);
+    if (run?.cancel_requested_at) {
+        // Abort the per-run controller so any in-flight I/O that listens to
+        // `ctx.signal` notices immediately, then throw — the engine catches and
+        // transitions the run to `cancelled`.
+        const abort = wfCtx.__abort;
+        if (typeof abort === 'function')
+            abort('cancel_requested_at set on run');
+        throw new CancelledError(`Workflow ${wfCtx.runId} cancelled`);
+    }
+}
+//# sourceMappingURL=create-step.js.map

package/dist/workflows/create-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-step.js","sourceRoot":"","sources":["../../src/workflows/create-step.ts"],"names":[],"mappings":"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"}

package/dist/workflows/create-workflow.d.ts

@@ -0,0 +1,16 @@
+import type { StepContext, WorkflowDefinition } from './types';
+/**
+ * Create a workflow.
+ *
+ * @param name — unique workflow name
+ * @param fn — async function that orchestrates steps
+ *
+ * @example
+ * export default createWorkflow('create-product', async (input, { app }) => {
+ *   await validateStep(input, { app })
+ *   const product = await createProductStep(input, { app })
+ *   return await activateStep(product, { app })
+ * })
+ */
+export declare function createWorkflow<TInput = unknown, TOutput = unknown>(name: string, fn: (input: TInput, ctx: StepContext) => Promise<TOutput>): WorkflowDefinition<TInput, TOutput>;
+//# sourceMappingURL=create-workflow.d.ts.map

package/dist/workflows/create-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workflow.d.ts","sourceRoot":"","sources":["../../src/workflows/create-workflow.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAE9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAChE,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,GACxD,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC"}

package/dist/workflows/create-workflow.js

@@ -0,0 +1,21 @@
+// createWorkflow() — imperative async workflow factory
+//
+// Returns a WorkflowDefinition that the WorkflowManager can register and run.
+// The workflow function is a plain async function — if/else, for loops, everything works.
+/**
+ * Create a workflow.
+ *
+ * @param name — unique workflow name
+ * @param fn — async function that orchestrates steps
+ *
+ * @example
+ * export default createWorkflow('create-product', async (input, { app }) => {
+ *   await validateStep(input, { app })
+ *   const product = await createProductStep(input, { app })
+ *   return await activateStep(product, { app })
+ * })
+ */
+export function createWorkflow(name, fn) {
+    return { name, fn };
+}
+//# sourceMappingURL=create-workflow.js.map

package/dist/workflows/create-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workflow.js","sourceRoot":"","sources":["../../src/workflows/create-workflow.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,8EAA8E;AAC9E,0FAA0F;AAI1F;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,EAAyD;IAEzD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;AACrB,CAAC"}

package/dist/workflows/define-workflow.d.ts

@@ -0,0 +1,55 @@
+import type { z } from 'zod';
+import type { ILoggerPort } from '../ports/logger';
+/**
+ * Workflow handler context — only step proxy (scoped to module) + logger.
+ * NO auth, NO headers — workflows are pure business logic.
+ */
+export interface WorkflowHandlerContext {
+    step: unknown;
+    log: ILoggerPort;
+}
+/**
+ * Workflow definition — returned by defineWorkflow().
+ */
+export interface ModuleWorkflowDefinition<TInput = unknown, TOutput = unknown> {
+    __type: 'workflow';
+    name: string;
+    description: string;
+    input: z.ZodType<TInput>;
+    handler: (input: TInput, context: WorkflowHandlerContext) => Promise<TOutput>;
+    /** Set by bootstrap — restricts step.service to this module's entities */
+    __moduleScope?: string;
+}
+/**
+ * Define an intra-module workflow — orchestrates multiple entity services within a module.
+ *
+ * Workflows have compensation (via step proxy) but NO auth context.
+ * They are called from commands via `step.workflow.MODULE.NAME(input)`.
+ *
+ * @example
+ * ```typescript
+ * // src/modules/customer/workflows/merge-customers.ts
+ * export default defineWorkflow({
+ *   name: 'merge-customers',
+ *   description: 'Merge two customer records into one',
+ *   input: z.object({ sourceId: z.string(), targetId: z.string() }),
+ *   handler: async (input, { step }) => {
+ *     // Move addresses from source to target
+ *     const addresses = await step.service.customerAddress.find({ customer_id: input.sourceId })
+ *     for (const addr of addresses) {
+ *       await step.service.customerAddress.update(addr.id, { customer_id: input.targetId })
+ *     }
+ *     // Delete source customer
+ *     await step.service.customer.delete(input.sourceId)
+ *     return { mergedInto: input.targetId }
+ *   },
+ * })
+ * ```
+ */
+export declare function defineWorkflow<TInput, TOutput>(config: {
+    name: string;
+    description: string;
+    input: z.ZodType<TInput>;
+    handler: (input: TInput, context: WorkflowHandlerContext) => Promise<TOutput>;
+}): ModuleWorkflowDefinition<TInput, TOutput>;
+//# sourceMappingURL=define-workflow.d.ts.map

package/dist/workflows/define-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../src/workflows/define-workflow.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,WAAW,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC3E,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7E,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9E,GAAG,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAc5C"}