@loopstack/core 0.24.0 → 0.25.0

package/dist/workflow-processor/services/tool-execution.service.js

@@ -0,0 +1,82 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var ToolExecutionService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutionService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const common_2 = require("@loopstack/common");
+const utils_1 = require("../utils");
+let ToolExecutionService = ToolExecutionService_1 = class ToolExecutionService {
+    executionScope;
+    discoveryService;
+    logger = new common_1.Logger(ToolExecutionService_1.name);
+    proxiedTools = new WeakSet();
+    interceptors = [];
+    constructor(executionScope, discoveryService) {
+        this.executionScope = executionScope;
+        this.discoveryService = discoveryService;
+    }
+    onModuleInit() {
+        const providers = this.discoveryService.getProviders();
+        const discovered = [];
+        for (const wrapper of providers) {
+            if (!wrapper.metatype || !wrapper.instance)
+                continue;
+            const meta = Reflect.getMetadata(common_2.TOOL_INTERCEPTOR_METADATA_KEY, wrapper.metatype);
+            if (meta) {
+                discovered.push({ instance: wrapper.instance, priority: meta.priority });
+            }
+        }
+        discovered.sort((a, b) => a.priority - b.priority);
+        this.interceptors = discovered.map((d) => d.instance);
+        this.logger.log(`Discovered ${this.interceptors.length} tool interceptor(s): ${this.interceptors.map((i) => i.constructor.name).join(', ')}`);
+    }
+    async executeCall(rawTool, originalCallFn, args, proxy, options) {
+        const baseTool = rawTool;
+        const ctx = this.executionScope.get();
+        const schema = (0, common_2.getBlockArgsSchema)(baseTool);
+        const validArgs = schema ? schema.parse(args) : args;
+        const execContext = {
+            tool: baseTool,
+            args: validArgs,
+            runContext: ctx.getContext(),
+            metadata: {},
+        };
+        const toolCall = () => originalCallFn.call(proxy, validArgs, options);
+        const chain = this.interceptors.reduceRight((next, interceptor) => () => interceptor.intercept(execContext, next), toolCall);
+        const result = await chain();
+        return result;
+    }
+    wireAndProxyTool(tool, toolName) {
+        if (this.proxiedTools.has(tool)) {
+            return tool;
+        }
+        const proxy = (0, utils_1.wrapToolProxy)(tool, toolName, this.executionScope, this.executeCall.bind(this));
+        this.proxiedTools.add(proxy);
+        const nestedToolNames = (0, common_2.getBlockTools)(tool);
+        for (const nestedName of nestedToolNames) {
+            const nestedTool = tool[nestedName];
+            if (nestedTool && !this.proxiedTools.has(nestedTool)) {
+                const nestedProxy = this.wireAndProxyTool(nestedTool, nestedName);
+                tool[nestedName] = nestedProxy;
+            }
+        }
+        return proxy;
+    }
+};
+exports.ToolExecutionService = ToolExecutionService;
+exports.ToolExecutionService = ToolExecutionService = ToolExecutionService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [utils_1.ExecutionScope,
+        core_1.DiscoveryService])
+], ToolExecutionService);
+//# sourceMappingURL=tool-execution.service.js.map

package/dist/workflow-processor/services/tool-execution.service.js.map

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

package/dist/workflow-processor/services/tool-logging.interceptor.d.ts

@@ -0,0 +1,6 @@
+import { ToolExecutionContext, ToolInterceptor, ToolResult } from '@loopstack/common';
+export declare class ToolLoggingInterceptor implements ToolInterceptor {
+    private readonly logger;
+    intercept(context: ToolExecutionContext, next: () => Promise<ToolResult>): Promise<ToolResult>;
+}
+//# sourceMappingURL=tool-logging.interceptor.d.ts.map

package/dist/workflow-processor/services/tool-logging.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-logging.interceptor.d.ts","sourceRoot":"","sources":["../../../src/workflow-processor/services/tool-logging.interceptor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,UAAU,EAAsB,MAAM,mBAAmB,CAAC;AAM1G,qBACa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IAEhD,SAAS,CAAC,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CA2BrG"}

package/dist/workflow-processor/services/tool-logging.interceptor.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolLoggingInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@loopstack/common");
+let ToolLoggingInterceptor = class ToolLoggingInterceptor {
+    logger = new common_1.Logger('ToolExecution');
+    async intercept(context, next) {
+        const toolName = context.tool.constructor.name;
+        const startTime = performance.now();
+        this.logger.debug(`${toolName} — executing`);
+        try {
+            const result = await next();
+            const durationMs = Math.round(performance.now() - startTime);
+            context.metadata.durationMs = durationMs;
+            this.logger.debug(`${toolName} — completed in ${durationMs}ms`);
+            return result;
+        }
+        catch (error) {
+            const durationMs = Math.round(performance.now() - startTime);
+            context.metadata.durationMs = durationMs;
+            this.logger.warn(`${toolName} — failed after ${durationMs}ms: ${error instanceof Error ? error.message : String(error)}`);
+            throw error;
+        }
+    }
+};
+exports.ToolLoggingInterceptor = ToolLoggingInterceptor;
+exports.ToolLoggingInterceptor = ToolLoggingInterceptor = __decorate([
+    (0, common_2.UseToolInterceptor)({ priority: 0 })
+], ToolLoggingInterceptor);
+//# sourceMappingURL=tool-logging.interceptor.js.map

package/dist/workflow-processor/services/tool-logging.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-logging.interceptor.js","sourceRoot":"","sources":["../../../src/workflow-processor/services/tool-logging.interceptor.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,8CAA0G;AAOnG,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAChB,MAAM,GAAG,IAAI,eAAM,CAAC,eAAe,CAAC,CAAC;IAEtD,KAAK,CAAC,SAAS,CAAC,OAA6B,EAAE,IAA+B;QAC5E,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAC/C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,cAAc,CAAC,CAAC;QAE7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;YAE7D,OAAO,CAAC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;YAEzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,mBAAmB,UAAU,IAAI,CAAC,CAAC;YAEhE,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;YAE7D,OAAO,CAAC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;YAEzC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,GAAG,QAAQ,mBAAmB,UAAU,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxG,CAAC;YAEF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAA;AA9BY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,2BAAkB,EAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;GACvB,sBAAsB,CA8BlC"}

package/dist/workflow-processor/services/transition-resolver.service.d.ts

@@ -0,0 +1,8 @@
+import { GuardMetadata, TransitionMetadata, WorkflowInterface } from '@loopstack/common';
+export declare class TransitionResolverService {
+    private readonly logger;
+    validate(target: object): void;
+    getAvailableTransitions(target: object, currentPlace: string): TransitionMetadata[];
+    resolveNextTransition(proxy: WorkflowInterface, transitions: TransitionMetadata[], guards: Map<string, GuardMetadata>): TransitionMetadata | undefined;
+}
+//# sourceMappingURL=transition-resolver.service.d.ts.map

package/dist/workflow-processor/services/transition-resolver.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-resolver.service.d.ts","sourceRoot":"","sources":["../../../src/workflow-processor/services/transition-resolver.service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EAIlB,MAAM,mBAAmB,CAAC;AAU3B,qBACa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IAMrE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAoD9B,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAiBnF,qBAAqB,CACnB,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,kBAAkB,EAAE,EACjC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACjC,kBAAkB,GAAG,SAAS;CAmBlC"}

package/dist/workflow-processor/services/transition-resolver.service.js

@@ -0,0 +1,85 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var TransitionResolverService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransitionResolverService = void 0;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@loopstack/common");
+let TransitionResolverService = TransitionResolverService_1 = class TransitionResolverService {
+    logger = new common_1.Logger(TransitionResolverService_1.name);
+    validate(target) {
+        const transitions = (0, common_2.getTransitionMetadata)(target);
+        const guards = (0, common_2.getGuardMetadata)(target);
+        const initialTransitions = transitions.filter((t) => t.from === 'start');
+        if (initialTransitions.length === 0) {
+            throw new Error(`Workflow ${target.constructor.name} has no @Initial transition.`);
+        }
+        if (initialTransitions.length > 1) {
+            throw new Error(`Workflow ${target.constructor.name} has ${initialTransitions.length} @Initial transitions — exactly one is required.`);
+        }
+        const proto = Object.getPrototypeOf(target);
+        for (const guard of guards) {
+            if (typeof proto[guard.guardMethodName] !== 'function') {
+                throw new Error(`@Guard('${guard.guardMethodName}') on transition '${guard.transitionMethodName}' ` +
+                    `references a method that does not exist on ${target.constructor.name}.`);
+            }
+        }
+        const guardMap = (0, common_2.getGuardMetadataMap)(target);
+        const byFrom = new Map();
+        for (const t of transitions) {
+            if (t.wait)
+                continue;
+            const list = byFrom.get(t.from) ?? [];
+            list.push(t);
+            byFrom.set(t.from, list);
+        }
+        for (const [from, group] of byFrom) {
+            const unguarded = group.filter((t) => !guardMap.has(t.methodName));
+            if (unguarded.length > 1) {
+                const names = unguarded.map((t) => t.methodName).join(', ');
+                throw new Error(`Workflow ${target.constructor.name} has ${unguarded.length} unguarded transitions ` +
+                    `from state '${from}': [${names}]. At most one unguarded transition per state is allowed.`);
+            }
+        }
+    }
+    getAvailableTransitions(target, currentPlace) {
+        const allTransitions = (0, common_2.getTransitionMetadata)(target);
+        return allTransitions
+            .filter((t) => t.from === currentPlace)
+            .sort((a, b) => {
+            if (a.priority != null && b.priority != null)
+                return b.priority - a.priority;
+            if (a.priority != null)
+                return -1;
+            if (b.priority != null)
+                return 1;
+            return 0;
+        });
+    }
+    resolveNextTransition(proxy, transitions, guards) {
+        const autoTransitions = transitions.filter((t) => !t.wait);
+        for (const transition of autoTransitions) {
+            const guard = guards.get(transition.methodName);
+            if (guard) {
+                const method = proxy[guard.guardMethodName];
+                if (typeof method !== 'function')
+                    continue;
+                const passes = method.call(proxy);
+                if (!passes)
+                    continue;
+            }
+            return transition;
+        }
+        return undefined;
+    }
+};
+exports.TransitionResolverService = TransitionResolverService;
+exports.TransitionResolverService = TransitionResolverService = TransitionResolverService_1 = __decorate([
+    (0, common_1.Injectable)()
+], TransitionResolverService);
+//# sourceMappingURL=transition-resolver.service.js.map

package/dist/workflow-processor/services/transition-resolver.service.js.map

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

package/dist/workflow-processor/services/workflow-memory-monitor.service.d.ts

@@ -0,0 +1,25 @@
+import { WorkflowEntity } from '@loopstack/common';
+import { WorkflowExecutionContextManager } from '../utils/execution-context-manager';
+export interface MemorySnapshot {
+    heapUsedMB: number;
+    heapTotalMB: number;
+    rssMB: number;
+    externalMB: number;
+}
+export interface WorkflowMemoryMetrics {
+    memory: MemorySnapshot;
+    documentCount: number;
+    invalidatedDocumentCount: number;
+    version: number;
+}
+export declare class WorkflowMemoryMonitorService {
+    private readonly logger;
+    getMemorySnapshot(): MemorySnapshot;
+    collectMetrics(ctx: WorkflowExecutionContextManager): WorkflowMemoryMetrics;
+    logTransition(workflowName: string, transitionId: string, ctx: WorkflowExecutionContextManager): void;
+    logHeap(label: string): void;
+    logWorkflowEntityLoaded(label: string, entity: WorkflowEntity): void;
+    logWorkflowStart(workflowName: string): void;
+    logWorkflowEnd(workflowName: string, ctx: WorkflowExecutionContextManager): void;
+}
+//# sourceMappingURL=workflow-memory-monitor.service.d.ts.map

package/dist/workflow-processor/services/workflow-memory-monitor.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-memory-monitor.service.d.ts","sourceRoot":"","sources":["../../../src/workflow-processor/services/workflow-memory-monitor.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAC;AAErF,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,qBACa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IAExE,iBAAiB,IAAI,cAAc;IAUnC,cAAc,CAAC,GAAG,EAAE,+BAA+B,GAAG,qBAAqB;IAgB3E,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,+BAA+B,GAAG,IAAI;IAwBrG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW5B,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAiBpE,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAO5C,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,+BAA+B,GAAG,IAAI;CAWjF"}

package/dist/workflow-processor/services/workflow-memory-monitor.service.js

@@ -0,0 +1,86 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var WorkflowMemoryMonitorService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowMemoryMonitorService = void 0;
+const common_1 = require("@nestjs/common");
+const HEAP_WARN_THRESHOLD_MB = 512;
+const DOCUMENT_WARN_THRESHOLD = 100;
+let WorkflowMemoryMonitorService = WorkflowMemoryMonitorService_1 = class WorkflowMemoryMonitorService {
+    logger = new common_1.Logger(WorkflowMemoryMonitorService_1.name);
+    getMemorySnapshot() {
+        const mem = process.memoryUsage();
+        return {
+            heapUsedMB: Math.round(mem.heapUsed / 1024 / 1024),
+            heapTotalMB: Math.round(mem.heapTotal / 1024 / 1024),
+            rssMB: Math.round(mem.rss / 1024 / 1024),
+            externalMB: Math.round(mem.external / 1024 / 1024),
+        };
+    }
+    collectMetrics(ctx) {
+        const memory = this.getMemorySnapshot();
+        const documents = ctx.getManager().getData('documents') ?? [];
+        const documentCount = documents.length;
+        const invalidatedDocumentCount = documents.filter((d) => d.isInvalidated).length;
+        const version = ctx.getManager().getVersion();
+        return {
+            memory,
+            documentCount,
+            invalidatedDocumentCount,
+            version,
+        };
+    }
+    logTransition(workflowName, transitionId, ctx) {
+        const metrics = this.collectMetrics(ctx);
+        const { memory, documentCount, invalidatedDocumentCount, version } = metrics;
+        this.logger.debug(`[${workflowName}] transition="${transitionId}" | ` +
+            `heap=${memory.heapUsedMB}/${memory.heapTotalMB}MB rss=${memory.rssMB}MB | ` +
+            `version=${version} | ` +
+            `docs=${documentCount} (invalidated=${invalidatedDocumentCount})`);
+        if (memory.heapUsedMB > HEAP_WARN_THRESHOLD_MB) {
+            this.logger.warn(`[${workflowName}] High heap usage: ${memory.heapUsedMB}MB (threshold: ${HEAP_WARN_THRESHOLD_MB}MB)`);
+        }
+        if (documentCount > DOCUMENT_WARN_THRESHOLD) {
+            this.logger.warn(`[${workflowName}] High document count: ${documentCount} (active=${documentCount - invalidatedDocumentCount}, invalidated=${invalidatedDocumentCount}, threshold: ${DOCUMENT_WARN_THRESHOLD})`);
+        }
+    }
+    logHeap(label) {
+        const memory = this.getMemorySnapshot();
+        this.logger.log(`[${label}] heap=${memory.heapUsedMB}/${memory.heapTotalMB}MB rss=${memory.rssMB}MB external=${memory.externalMB}MB`);
+        if (memory.heapUsedMB > HEAP_WARN_THRESHOLD_MB) {
+            this.logger.warn(`[${label}] High heap usage: ${memory.heapUsedMB}MB (threshold: ${HEAP_WARN_THRESHOLD_MB}MB)`);
+        }
+    }
+    logWorkflowEntityLoaded(label, entity) {
+        const memory = this.getMemorySnapshot();
+        const documentCount = entity.documents?.length ?? 0;
+        this.logger.log(`[${label}] entity=${entity.alias} id=${entity.id} | ` +
+            `heap=${memory.heapUsedMB}/${memory.heapTotalMB}MB | ` +
+            `docs=${documentCount}`);
+        if (documentCount > DOCUMENT_WARN_THRESHOLD) {
+            this.logger.warn(`[${label}] entity=${entity.alias} has ${documentCount} documents (threshold: ${DOCUMENT_WARN_THRESHOLD})`);
+        }
+    }
+    logWorkflowStart(workflowName) {
+        const memory = this.getMemorySnapshot();
+        this.logger.log(`[${workflowName}] START | heap=${memory.heapUsedMB}/${memory.heapTotalMB}MB rss=${memory.rssMB}MB`);
+    }
+    logWorkflowEnd(workflowName, ctx) {
+        const metrics = this.collectMetrics(ctx);
+        const { memory, documentCount, invalidatedDocumentCount, version } = metrics;
+        this.logger.log(`[${workflowName}] END | ` +
+            `heap=${memory.heapUsedMB}/${memory.heapTotalMB}MB rss=${memory.rssMB}MB | ` +
+            `version=${version} | ` +
+            `docs=${documentCount} (invalidated=${invalidatedDocumentCount})`);
+    }
+};
+exports.WorkflowMemoryMonitorService = WorkflowMemoryMonitorService;
+exports.WorkflowMemoryMonitorService = WorkflowMemoryMonitorService = WorkflowMemoryMonitorService_1 = __decorate([
+    (0, common_1.Injectable)()
+], WorkflowMemoryMonitorService);
+//# sourceMappingURL=workflow-memory-monitor.service.js.map

package/dist/workflow-processor/services/workflow-memory-monitor.service.js.map

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

package/dist/workflow-processor/services/workflow-orchestration.service.d.ts

@@ -0,0 +1,17 @@
+import { CallbackOptions, QueueResult, RunOptions, WorkflowEntity, WorkflowOrchestrator } from '@loopstack/common';
+import { WorkflowService } from '../../persistence';
+import { TaskSchedulerService } from '../../scheduler';
+import { ExecutionScope } from '../utils';
+import { CreateWorkflowService } from './create-workflow.service';
+export declare class WorkflowOrchestrationService implements WorkflowOrchestrator {
+    private readonly executionScope;
+    private readonly createWorkflowService;
+    private readonly taskSchedulerService;
+    private readonly workflowService;
+    private readonly logger;
+    constructor(executionScope: ExecutionScope, createWorkflowService: CreateWorkflowService, taskSchedulerService: TaskSchedulerService, workflowService: WorkflowService);
+    queue(args?: Record<string, unknown>, options?: RunOptions): Promise<QueueResult>;
+    callback(workflowId: string, payload: Record<string, unknown>, options: CallbackOptions): Promise<void>;
+    complete(workflowEntity: WorkflowEntity): Promise<void>;
+}
+//# sourceMappingURL=workflow-orchestration.service.d.ts.map

package/dist/workflow-processor/services/workflow-orchestration.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-orchestration.service.d.ts","sourceRoot":"","sources":["../../../src/workflow-processor/services/workflow-orchestration.service.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,EACf,WAAW,EACX,UAAU,EACV,cAAc,EAEd,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAUlE,qBACa,4BAA6B,YAAW,oBAAoB;IAIrE,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAEtC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAPlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;gBAGrD,cAAc,EAAE,cAAc,EAC9B,qBAAqB,EAAE,qBAAqB,EAE5C,oBAAoB,EAAE,oBAAoB,EAC1C,eAAe,EAAE,eAAe;IAG7C,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAiDjF,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BvG,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CA2B9D"}

package/dist/workflow-processor/services/workflow-orchestration.service.js

@@ -0,0 +1,125 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var WorkflowOrchestrationService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowOrchestrationService = void 0;
+const common_1 = require("@nestjs/common");
+const node_crypto_1 = require("node:crypto");
+const persistence_1 = require("../../persistence");
+const scheduler_1 = require("../../scheduler");
+const utils_1 = require("../utils");
+const create_workflow_service_1 = require("./create-workflow.service");
+let WorkflowOrchestrationService = WorkflowOrchestrationService_1 = class WorkflowOrchestrationService {
+    executionScope;
+    createWorkflowService;
+    taskSchedulerService;
+    workflowService;
+    logger = new common_1.Logger(WorkflowOrchestrationService_1.name);
+    constructor(executionScope, createWorkflowService, taskSchedulerService, workflowService) {
+        this.executionScope = executionScope;
+        this.createWorkflowService = createWorkflowService;
+        this.taskSchedulerService = taskSchedulerService;
+        this.workflowService = workflowService;
+    }
+    async queue(args, options) {
+        const ctx = this.executionScope.get();
+        const context = ctx.getContext();
+        if (!options?.alias) {
+            throw new Error('RunOptions.alias is required to queue a sub-workflow.');
+        }
+        if (context.options?.stateless) {
+            throw new Error('Sub-workflow launching requires stateful workflow execution.');
+        }
+        const alias = options.alias;
+        const workflowInstance = options._workflowInstance;
+        const workflowEntity = await this.createWorkflowService.create({ id: context.workspaceId }, {
+            alias,
+            workspaceId: context.workspaceId,
+            args: { ...args },
+            callbackTransition: options?.callback?.transition ?? null,
+            callbackMetadata: options?.callback?.metadata ?? null,
+        }, context.userId, context.parentWorkflowId, workflowInstance);
+        await this.taskSchedulerService.addTask({
+            id: 'sub_workflow_execution-' + (0, node_crypto_1.randomUUID)(),
+            workspaceId: context.workspaceId,
+            task: {
+                name: 'sub_workflow_execution',
+                type: 'run_workflow',
+                user: context.userId,
+                workspaceId: context.workspaceId,
+                workflowId: workflowEntity.id,
+                alias,
+                args: { ...args },
+                payload: {},
+            },
+        });
+        return {
+            workflowId: workflowEntity.id,
+        };
+    }
+    async callback(workflowId, payload, options) {
+        const workflow = await this.workflowService.findById(workflowId);
+        if (!workflow) {
+            throw new Error(`Workflow with id ${workflowId} not found for callback.`);
+        }
+        this.logger.log(`Scheduling callback for workflow ${workflowId}, transition=${options.transition}`);
+        await this.taskSchedulerService.addTask({
+            id: 'callback_execution-' + (0, node_crypto_1.randomUUID)(),
+            workspaceId: workflow.workspaceId,
+            task: {
+                name: 'callback_execution',
+                type: 'run_workflow',
+                workflowId: workflowId,
+                payload: {
+                    transition: {
+                        id: options.transition,
+                        workflowId: workflowId,
+                        payload,
+                    },
+                },
+                user: workflow.createdBy,
+            },
+        });
+    }
+    async complete(workflowEntity) {
+        if (!workflowEntity.parentId || !workflowEntity.callbackTransition) {
+            return;
+        }
+        this.logger.log(`Workflow ${workflowEntity.id} completed — triggering parent callback: ` +
+            `parentId=${workflowEntity.parentId}, transition=${workflowEntity.callbackTransition}`);
+        try {
+            await this.callback(workflowEntity.parentId, {
+                workflowId: workflowEntity.id,
+                status: workflowEntity.status,
+                data: workflowEntity.result ?? null,
+                ...(workflowEntity.callbackMetadata ? { _subscriberMetadata: workflowEntity.callbackMetadata } : {}),
+            }, { transition: workflowEntity.callbackTransition });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to trigger parent callback for workflow ${workflowEntity.id}: ${message}`);
+            throw error;
+        }
+    }
+};
+exports.WorkflowOrchestrationService = WorkflowOrchestrationService;
+exports.WorkflowOrchestrationService = WorkflowOrchestrationService = WorkflowOrchestrationService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Inject)((0, common_1.forwardRef)(() => scheduler_1.TaskSchedulerService))),
+    __metadata("design:paramtypes", [utils_1.ExecutionScope,
+        create_workflow_service_1.CreateWorkflowService,
+        scheduler_1.TaskSchedulerService,
+        persistence_1.WorkflowService])
+], WorkflowOrchestrationService);
+//# sourceMappingURL=workflow-orchestration.service.js.map

package/dist/workflow-processor/services/workflow-orchestration.service.js.map

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

package/dist/workflow-processor/services/workflow-state.service.d.ts

@@ -1,11 +1,13 @@
-import { PersistenceState, RunContext, WorkflowEntity, WorkflowInterface } from '@loopstack/common';
-import { WorkflowService } from '../../persistence';
+import { QueryRunner } from 'typeorm';
+import { PersistenceState, WorkflowCheckpointEntity, WorkflowEntity } from '@loopstack/common';
+import { WorkflowCheckpointService, WorkflowService } from '../../persistence';
 import { WorkflowExecutionContextManager } from '../utils/execution-context-manager';
 export declare class WorkflowStateService {
     private workflowService;
-    constructor(workflowService: WorkflowService);
-    getWorkflowState(block: WorkflowInterface, context: RunContext): Promise<WorkflowEntity>;
-    saveWorkflowState(entity: WorkflowEntity, persistenceState: PersistenceState): Promise<void>;
-    saveExecutionState(workflowEntity: WorkflowEntity, ctx: WorkflowExecutionContextManager): Promise<void>;
+    private workflowCheckpointService;
+    constructor(workflowService: WorkflowService, workflowCheckpointService: WorkflowCheckpointService);
+    getLatestCheckpoint(workflowId: string): Promise<WorkflowCheckpointEntity | null>;
+    saveWorkflowState(entity: WorkflowEntity, persistenceState: PersistenceState, queryRunner?: QueryRunner): Promise<void>;
+    saveExecutionState(workflowEntity: WorkflowEntity, ctx: WorkflowExecutionContextManager, queryRunner?: QueryRunner): Promise<void>;
 }
 //# sourceMappingURL=workflow-state.service.d.ts.map

package/dist/workflow-processor/services/workflow-state.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-state.service.d.ts","sourceRoot":"","sources":["../../../src/workflow-processor/services/workflow-state.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAkB,MAAM,mBAAmB,CAAC;AAEpH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAC;AAErF,qBACa,oBAAoB;IACnB,OAAO,CAAC,eAAe;gBAAf,eAAe,EAAE,eAAe;IAE9C,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IA4BxF,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB;IAI5E,kBAAkB,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,EAAE,+BAA+B;CAiB9F"}
+{"version":3,"file":"workflow-state.service.d.ts","sourceRoot":"","sources":["../../../src/workflow-processor/services/workflow-state.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAC;AAErF,qBACa,oBAAoB;IAE7B,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,yBAAyB;gBADzB,eAAe,EAAE,eAAe,EAChC,yBAAyB,EAAE,yBAAyB;IAGxD,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAIjF,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,WAAW;IAIvG,kBAAkB,CACtB,cAAc,EAAE,cAAc,EAC9B,GAAG,EAAE,+BAA+B,EACpC,WAAW,CAAC,EAAE,WAAW;CAiC5B"}