@desplega.ai/agent-swarm 1.67.5 → 1.68.0

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.67.5",
+    "version": "1.68.0",
     "description": "Multi-agent orchestration API for Claude Code, Codex, and Gemini CLI. Enables task distribution, agent communication, and service discovery.\n\nMCP tools are documented separately in [MCP.md](./MCP.md)."
   },
   "servers": [
@@ -995,6 +995,69 @@
         }
       }
     },
+    "/api/config/env-presence": {
+      "get": {
+        "summary": "Check which of the given env var keys are currently set in process.env (presence only, no values)",
+        "tags": [
+          "Config"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            },
+            "required": true,
+            "name": "keys",
+            "in": "query"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Map of key -> boolean (true iff set in process.env)"
+          },
+          "400": {
+            "description": "Validation error"
+          }
+        }
+      }
+    },
+    "/api/config/reload": {
+      "post": {
+        "summary": "Reload global swarm_config into process.env (override=true) and re-init integrations (Slack, GitHub, Linear, AgentMail)",
+        "tags": [
+          "Config"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {}
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Reload result"
+          },
+          "500": {
+            "description": "Reload failed"
+          }
+        }
+      }
+    },
     "/api/config/{id}": {
       "get": {
         "summary": "Get a single config entry by ID",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.67.5",
+  "version": "1.68.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",

package/src/http/config.ts

@@ -10,9 +10,12 @@ import {
   upsertSwarmConfig,
 } from "../be/db";
 import { isReservedConfigKey, reservedKeyError } from "../be/swarm-config-guard";
+import { reloadGlobalConfigsAndIntegrations } from "./core";
 import { route } from "./route-def";
 import { json, jsonError } from "./utils";
 
+const MAX_ENV_PRESENCE_KEYS = 200;
+
 // ─── Route Definitions ───────────────────────────────────────────────────────
 
 const getResolvedConfigRoute = route({
@@ -31,6 +34,36 @@ const getResolvedConfigRoute = route({
   },
 });
 
+const envPresence = route({
+  method: "get",
+  path: "/api/config/env-presence",
+  pattern: ["api", "config", "env-presence"],
+  summary:
+    "Check which of the given env var keys are currently set in process.env (presence only, no values)",
+  tags: ["Config"],
+  query: z.object({
+    keys: z.string().min(1),
+  }),
+  responses: {
+    200: { description: "Map of key -> boolean (true iff set in process.env)" },
+    400: { description: "Validation error" },
+  },
+});
+
+const reloadConfigRoute = route({
+  method: "post",
+  path: "/api/config/reload",
+  pattern: ["api", "config", "reload"],
+  summary:
+    "Reload global swarm_config into process.env (override=true) and re-init integrations (Slack, GitHub, Linear, AgentMail)",
+  tags: ["Config"],
+  body: z.object({}).optional(),
+  responses: {
+    200: { description: "Reload result" },
+    500: { description: "Reload failed" },
+  },
+});
+
 const getConfigById = route({
   method: "get",
   path: "/api/config/{id}",
@@ -117,6 +150,40 @@ export async function handleConfig(
     return true;
   }
 
+  if (envPresence.match(req.method, pathSegments)) {
+    const parsed = await envPresence.parse(req, res, pathSegments, queryParams);
+    if (!parsed) return true;
+    const keys = parsed.query.keys
+      .split(",")
+      .map((k) => k.trim())
+      .filter(Boolean);
+    if (keys.length > MAX_ENV_PRESENCE_KEYS) {
+      jsonError(res, `Too many keys (max ${MAX_ENV_PRESENCE_KEYS})`, 400);
+      return true;
+    }
+    const presence: Record<string, boolean> = {};
+    for (const key of keys) {
+      presence[key] = process.env[key] !== undefined && process.env[key] !== "";
+    }
+    json(res, { presence });
+    return true;
+  }
+
+  if (reloadConfigRoute.match(req.method, pathSegments)) {
+    try {
+      const result = await reloadGlobalConfigsAndIntegrations();
+      console.log(
+        `[reload-config] Loaded ${result.configsLoaded} config(s), re-initialized: ${result.integrationsReinitialized.join(", ") || "none"}`,
+      );
+      json(res, { success: true, ...result });
+    } catch (e) {
+      const message = e instanceof Error ? e.message : String(e);
+      console.error("[reload-config] Failed:", message);
+      jsonError(res, `Failed to reload config: ${message}`, 500);
+    }
+    return true;
+  }
+
   if (getConfigById.match(req.method, pathSegments)) {
     const parsed = await getConfigById.parse(req, res, pathSegments, queryParams);
     if (!parsed) return true;

package/src/http/core.ts

@@ -43,6 +43,42 @@ export function loadGlobalConfigsIntoEnv(override = false): string[] {
   return updated;
 }
 
+export type ReloadConfigResult = {
+  configsLoaded: number;
+  keysUpdated: string[];
+  integrationsReinitialized: string[];
+};
+
+/**
+ * Re-read swarm_config into process.env with override=true, then reset and
+ * re-init each integration so long-lived clients (Slack socket mode, etc.)
+ * pick up the new values without requiring a process restart.
+ */
+export async function reloadGlobalConfigsAndIntegrations(): Promise<ReloadConfigResult> {
+  const updated = loadGlobalConfigsIntoEnv(true);
+
+  const integrations: string[] = [];
+
+  resetAgentMail();
+  if (initAgentMail()) integrations.push("agentmail");
+
+  resetGitHub();
+  if (initGitHub()) integrations.push("github");
+
+  resetLinear();
+  if (initLinear()) integrations.push("linear");
+
+  await stopSlackApp();
+  await startSlackApp();
+  integrations.push("slack");
+
+  return {
+    configsLoaded: updated.length,
+    keysUpdated: updated,
+    integrationsReinitialized: integrations,
+  };
+}
+
 export async function handleCore(
   req: IncomingMessage,
   res: ServerResponse,
@@ -116,38 +152,12 @@ export async function handleCore(
   // POST /internal/reload-config — re-read swarm_config into process.env and re-init integrations
   if (req.method === "POST" && req.url === "/internal/reload-config") {
     try {
-      const updated = loadGlobalConfigsIntoEnv(true);
-
-      // Re-initialize integrations so they pick up new secrets
-      const integrations: string[] = [];
-
-      resetAgentMail();
-      if (initAgentMail()) integrations.push("agentmail");
-
-      resetGitHub();
-      if (initGitHub()) integrations.push("github");
-
-      resetLinear();
-      if (initLinear()) integrations.push("linear");
-
-      // Slack: stop and restart to pick up new token
-      await stopSlackApp();
-      await startSlackApp();
-      integrations.push("slack");
-
+      const result = await reloadGlobalConfigsAndIntegrations();
       console.log(
-        `[reload-config] Loaded ${updated.length} config(s), re-initialized: ${integrations.join(", ") || "none"}`,
+        `[reload-config] Loaded ${result.configsLoaded} config(s), re-initialized: ${result.integrationsReinitialized.join(", ") || "none"}`,
       );
-
       res.writeHead(200, { "Content-Type": "application/json" });
-      res.end(
-        JSON.stringify({
-          success: true,
-          configsLoaded: updated.length,
-          keysUpdated: updated,
-          integrationsReinitialized: integrations,
-        }),
-      );
+      res.end(JSON.stringify({ success: true, ...result }));
     } catch (e) {
       const message = e instanceof Error ? e.message : String(e);
       console.error("[reload-config] Failed:", message);