@massa-ai/tools-api 1.45.0 → 1.46.0

package/dist/index.js

@@ -762,6 +762,22 @@ function restartNeededSections(config) {
     return false;
   });
 }
+function deepEqual(a, b) {
+  if (a === b)
+    return true;
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null)
+    return false;
+  if (Array.isArray(a) !== Array.isArray(b))
+    return false;
+  const ka = Object.keys(a);
+  const kb = Object.keys(b);
+  if (ka.length !== kb.length)
+    return false;
+  return ka.every((k) => deepEqual(a[k], b[k]));
+}
+function changedRestartSections(before, after) {
+  return RESTART_SECTIONS.filter((s) => !deepEqual(before[s], after[s]));
+}
 function applyMaskedSentinel(partial, current) {
   const result = JSON.parse(JSON.stringify(partial));
   if (result.security?.apiKey === MASK_SENTINEL) {
@@ -1044,7 +1060,8 @@ function savePartialConfig(partial) {
   return {
     success: true,
     config: merged,
-    restartNeededSections: restartNeededSections(merged)
+    restartNeededSections: restartNeededSections(merged),
+    changedRestartSections: changedRestartSections(current, merged)
   };
 }
 var MASK_SENTINEL = "***", RESTART_SECTIONS, VALID_EMBEDDING_PROVIDERS, VALID_LOG_LEVELS, BACKUP_RETENTION_LIMIT = 10;
@@ -182131,7 +182148,11 @@ var configRoutes = new Elysia({ prefix: "/api/v1/config" }).get("/", ({ set: set
   set3.status = 200;
   return {
     success: true,
-    data: { config: masked, restartNeededSections: result.restartNeededSections }
+    data: {
+      config: masked,
+      restartNeededSections: result.restartNeededSections,
+      changedRestartSections: result.changedRestartSections
+    }
   };
 }, {
   body: t.Object({}, { additionalProperties: true }),
@@ -182321,6 +182342,104 @@ var modelRegistryStreamRoutes = new Elysia({ prefix: "/api/v1/model-registry" })
   }
 });
 
+// src/lifecycle.ts
+import { existsSync as existsSync5 } from "fs";
+var serverStopper = () => {};
+var jobsStopper = () => {};
+function setServerStopper(fn) {
+  serverStopper = fn;
+}
+function setJobsStopper(fn) {
+  jobsStopper = fn;
+}
+function defaultSeams() {
+  return {
+    stopServer: () => serverStopper(),
+    stopJobs: () => jobsStopper(),
+    disconnect: async () => {
+      const { disconnectPrisma: disconnectPrisma2 } = await Promise.resolve().then(() => (init_services(), exports_services));
+      await disconnectPrisma2();
+    },
+    spawn: (argv, opts) => {
+      Bun.spawn({
+        cmd: argv,
+        cwd: opts.cwd,
+        env: opts.env,
+        stdio: ["ignore", "inherit", "inherit"]
+      }).unref();
+    },
+    exit: (code) => process.exit(code)
+  };
+}
+var testSeams = null;
+var testMode = null;
+function detectRestartMode(env6 = process.env, dockerProbe = () => existsSync5("/.dockerenv")) {
+  if (testMode)
+    return testMode;
+  if (env6.MASSA_AI_DEV_WATCH === "1")
+    return "dev-watch";
+  if (env6.MASSA_AI_SUPERVISED === "1" || dockerProbe())
+    return "supervised";
+  return "respawn";
+}
+var armedMode = null;
+function armRestart(mode) {
+  armedMode = mode;
+}
+function consumeArmedRestart() {
+  const mode = armedMode;
+  armedMode = null;
+  return mode;
+}
+async function shutdownAndRestart(mode, seams = testSeams ?? defaultSeams()) {
+  await seams.stopServer();
+  seams.stopJobs();
+  try {
+    await seams.disconnect();
+  } catch {}
+  if (mode === "respawn") {
+    seams.spawn([process.execPath, ...process.argv.slice(1)], {
+      cwd: process.cwd(),
+      env: process.env
+    });
+  }
+  seams.exit(0);
+}
+async function gracefulShutdown(seams = testSeams ?? defaultSeams()) {
+  await seams.stopServer();
+  seams.stopJobs();
+  try {
+    await seams.disconnect();
+  } catch {}
+  seams.exit(0);
+}
+
+// src/routes/restart.ts
+var restartRoutes = new Elysia({ prefix: "/api/v1/system" }).onAfterResponse(() => {
+  const mode = consumeArmedRestart();
+  if (mode)
+    shutdownAndRestart(mode);
+}).post("/restart", ({ set: set3 }) => {
+  const mode = detectRestartMode();
+  if (mode === "dev-watch") {
+    set3.status = 409;
+    return {
+      success: false,
+      error: "restart refused",
+      reason: "dev watcher active (bun --watch owns this process's lifecycle) \u2014 save a file to restart, or run without the dev script"
+    };
+  }
+  armRestart(mode);
+  set3.status = 200;
+  return { success: true, restarting: true, mode };
+}, {
+  detail: {
+    tags: ["system"],
+    summary: "Gracefully restart the API server",
+    description: "Responds first, then drains (listener, job reaper, scheduler, Prisma) and exits. " + "Mode 'supervised' (MASSA_AI_SUPERVISED=1 or /.dockerenv): exit 0 and let the supervisor respawn. " + "Mode 'respawn' (no supervisor): a detached replacement with the same argv is spawned after the listener stops. " + "409 when the dev watcher owns the process (MASSA_AI_DEV_WATCH=1). " + "Poll GET /health to observe recovery."
+  }
+});
+
 // src/middleware/error.ts
 init_dist();
 var errorHandler = new Elysia({ name: "error-handler" }).onError(({ code, error: error51, set: set3, path: path41, request }) => {
@@ -182443,13 +182562,15 @@ var app = new Elysia({ adapter: node() }).use(cors(buildCorsOptions(config.get("
     },
     security: [{ ApiKeyAuth: [] }]
   }
-})).use(errorHandler).use(authMiddleware).use(searchRoutes).use(memoryRoutes).use(checkpointRoutes).use(projectRoutes).use(contextRoutes).use(analyticsRoutes).use(systemRoutes).use(eventsRoutes).use(workspaceRoutes).use(fileRoutes).use(synapseRoutes).use(hookRoutes).use(bootstrapRoutes).use(handoffRoutes).use(proposalRoutes).use(executorRoutes).use(webRoutes).use(webUiRoutes).use(architectureRoutes).use(dashboardRoutes).use(profileRoutes).use(configRoutes).use(modelRegistryRoutes).use(modelRegistryStreamRoutes).get("/health", () => buildHealthResponse(getParserReadiness()));
+})).use(errorHandler).use(authMiddleware).use(searchRoutes).use(memoryRoutes).use(checkpointRoutes).use(projectRoutes).use(contextRoutes).use(analyticsRoutes).use(systemRoutes).use(eventsRoutes).use(workspaceRoutes).use(fileRoutes).use(synapseRoutes).use(hookRoutes).use(bootstrapRoutes).use(handoffRoutes).use(proposalRoutes).use(executorRoutes).use(webRoutes).use(webUiRoutes).use(architectureRoutes).use(dashboardRoutes).use(profileRoutes).use(configRoutes).use(modelRegistryRoutes).use(modelRegistryStreamRoutes).use(restartRoutes).get("/health", () => buildHealthResponse(getParserReadiness()));
 initAuthOrExit();
 warnIfTrustOverrideEnabled();
 await listenAfterParserValidation({
   validate: validateAllGrammars,
   listen: () => {
-    app.listen(PORT);
+    app.listen(PORT, (server) => {
+      setServerStopper(() => void server.stop());
+    });
   },
   onValidationFailure: (error51) => {
     console.error("Structural parser readiness failed; indexing is unavailable:", error51 instanceof Error ? error51.message : error51);
@@ -182490,18 +182611,16 @@ try {
 } catch (err) {
   console.error(`[scheduler] init error:`, err instanceof Error ? err.message : err);
 }
+setJobsStopper(() => {
+  clearInterval(jobReaperTimer);
+  try {
+    scheduler.stop();
+  } catch {}
+});
 for (const signal of ["SIGTERM", "SIGINT"]) {
-  process.on(signal, async () => {
+  process.on(signal, () => {
     console.log(`${signal} received, shutting down gracefully...`);
-    clearInterval(jobReaperTimer);
-    try {
-      scheduler.stop();
-    } catch {}
-    try {
-      const { disconnectPrisma: disconnectPrisma2 } = await Promise.resolve().then(() => (init_services(), exports_services));
-      await disconnectPrisma2();
-    } catch {}
-    process.exit(0);
+    gracefulShutdown();
   });
 }
 (async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massa-ai/tools-api",
-  "version": "1.45.0",
+  "version": "1.46.0",
   "author": "luizgmassa",
   "description": "massa-ai REST API server - Semantic code search, memory, and context compression",
   "type": "module",
@@ -12,7 +12,7 @@
     "dist"
   ],
   "scripts": {
-    "dev": "bun --watch src/index.ts",
+    "dev": "MASSA_AI_DEV_WATCH=1 bun --watch src/index.ts",
     "dev:insecure": "NODE_TLS_REJECT_UNAUTHORIZED=0 bun --watch src/index.ts",
     "start": "bun src/index.ts",
     "start:insecure": "NODE_TLS_REJECT_UNAUTHORIZED=0 bun src/index.ts",
@@ -21,8 +21,8 @@
     "test": "bun scripts/run-tests-isolated.ts"
   },
   "dependencies": {
-    "@massa-ai/core": "^1.45.0",
-    "@massa-ai/shared": "^1.45.0",
+    "@massa-ai/core": "^1.46.0",
+    "@massa-ai/shared": "^1.46.0",
     "elysia": "^1.2.25",
     "@elysiajs/swagger": "^1.2.0",
     "@elysiajs/cors": "^1.2.0",