@voltagent/core 1.1.0 → 1.1.1

package/dist/index.d.mts

@@ -6943,6 +6943,12 @@ declare class VoltAgent {
      * Shutdown telemetry (delegates to VoltAgentObservability)
      */
     shutdownTelemetry(): Promise<void>;
+    /**
+     * Gracefully shutdown all VoltAgent resources
+     * This includes stopping the server, suspending workflows, and shutting down telemetry
+     * Useful for programmatic cleanup or when integrating with other frameworks
+     */
+    shutdown(): Promise<void>;
 }
 
 /**

package/dist/index.d.ts

@@ -6943,6 +6943,12 @@ declare class VoltAgent {
      * Shutdown telemetry (delegates to VoltAgentObservability)
      */
     shutdownTelemetry(): Promise<void>;
+    /**
+     * Gracefully shutdown all VoltAgent resources
+     * This includes stopping the server, suspending workflows, and shutting down telemetry
+     * Useful for programmatic cleanup or when integrating with other frameworks
+     */
+    shutdown(): Promise<void>;
 }
 
 /**

package/dist/index.js

@@ -12879,11 +12879,10 @@ var VoltAgent = class {
    * Setup graceful shutdown handlers
    */
   setupShutdownHandlers() {
-    const shutdown = /* @__PURE__ */ __name(async (signal) => {
-      this.logger.info(`[VoltAgent] Received ${signal}, starting graceful shutdown...`);
+    const handleSignal = /* @__PURE__ */ __name(async (signal) => {
+      this.logger.info(`[VoltAgent] Received ${signal}...`);
       try {
-        await this.workflowRegistry.suspendAllActiveWorkflows();
-        this.logger.info("[VoltAgent] All workflows suspended, exiting...");
+        await this.shutdown();
         if (this.isSoleSignalHandler(signal)) {
           process.exit(0);
         }
@@ -12893,9 +12892,9 @@ var VoltAgent = class {
           process.exit(1);
         }
       }
-    }, "shutdown");
-    process.on("SIGTERM", () => shutdown("SIGTERM"));
-    process.on("SIGINT", () => shutdown("SIGINT"));
+    }, "handleSignal");
+    process.once("SIGTERM", () => handleSignal("SIGTERM"));
+    process.once("SIGINT", () => handleSignal("SIGINT"));
     process.on("unhandledRejection", (reason) => {
       this.logger.error("[VoltAgent] Unhandled Promise Rejection:", {
         reason: reason instanceof Error ? reason.message : reason,
@@ -13052,6 +13051,30 @@ var VoltAgent = class {
       await this.observability.shutdown();
     }
   }
+  /**
+   * Gracefully shutdown all VoltAgent resources
+   * This includes stopping the server, suspending workflows, and shutting down telemetry
+   * Useful for programmatic cleanup or when integrating with other frameworks
+   */
+  async shutdown() {
+    this.logger.info("[VoltAgent] Starting graceful shutdown...");
+    try {
+      if (this.serverInstance?.isRunning()) {
+        this.logger.info("[VoltAgent] Stopping server...");
+        await this.stopServer();
+      }
+      this.logger.info("[VoltAgent] Suspending active workflows...");
+      await this.workflowRegistry.suspendAllActiveWorkflows();
+      if (this.observability) {
+        this.logger.info("[VoltAgent] Shutting down telemetry...");
+        await this.shutdownTelemetry();
+      }
+      this.logger.info("[VoltAgent] Graceful shutdown complete");
+    } catch (error) {
+      this.logger.error("[VoltAgent] Error during shutdown:", { error });
+      throw error;
+    }
+  }
 };
 
 // src/index.ts