@desplega.ai/agent-swarm 1.76.2 → 1.77.0

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.76.2",
+    "version": "1.77.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": [
@@ -7368,6 +7368,12 @@
                         },
                         "hide_cloud_promo": {
                           "type": "boolean"
+                        },
+                        "org_id": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
                         }
                       },
                       "required": [
@@ -7376,7 +7382,8 @@
                         "brand_color",
                         "is_cloud",
                         "marketing_url",
-                        "hide_cloud_promo"
+                        "hide_cloud_promo",
+                        "org_id"
                       ]
                     },
                     "setup": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.76.2",
+  "version": "1.77.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/be/memory/raters/llm.ts

@@ -57,6 +57,30 @@ export const SummaryWithRatingsSchema = z.object({
 export type LlmRating = z.infer<typeof RatingSchema>;
 export type SummaryWithRatings = z.infer<typeof SummaryWithRatingsSchema>;
 
+/**
+ * Base prompt for session summarization. Extracted from `src/hooks/hook.ts`
+ * so both the claude Stop hook and the worker-side `summarizeSession` helper
+ * in `src/utils/internal-ai/summarize-session.ts` share one source of truth.
+ *
+ * Callers append a `Task: <prompt>` line (optional) and `Transcript:\n<text>`
+ * block, then wrap with `buildSummaryWithRatingsPrompt(basePrompt, retrievals)`.
+ */
+export const BASE_SUMMARIZE_PROMPT = `You are summarizing an AI agent's work session. Extract ONLY high-value learnings.
+
+DO NOT include:
+- Generic descriptions of what was done ("worked on task X")
+- Tool calls or file reads
+- Routine progress updates
+
+DO include (if present):
+- **Mistakes made and corrections** — what went wrong and what fixed it
+- **Discovered patterns** — reusable approaches, APIs, or codebase conventions
+- **Codebase knowledge** — important file paths, architecture decisions, gotchas
+- **Environment knowledge** — service URLs, config details, tool quirks
+- **Failed approaches** — what was tried and didn't work (and why)
+
+Format as a bulleted list of concrete, reusable facts. If the session was routine with no significant learnings, respond with exactly: "No significant learnings."`;
+
 /** Context augmentations LlmRater consumes when called directly (per-memory path). */
 export type LlmRatingContext = RatingContext & {
   /** What the agent asked the memory system. */
@@ -293,6 +317,7 @@ export function dedupeRetrievalsForRater<T extends { scheduleId?: string | null
   return out;
 }
 
+// Worker-safe: uses fetch() only, no bun:sqlite import.
 /**
  * GET `/api/memory/retrievals?taskId=` — best-effort. Returns `[]` on any
  * failure so a transient API outage never blocks the summary-indexing path.
@@ -327,6 +352,7 @@ export async function fetchRetrievalsForTask(opts: {
   }
 }
 
+// Worker-safe: uses fetch() only, no bun:sqlite import.
 /**
  * POST `/api/memory/rate` — best-effort. Logs on 4xx/5xx, never throws. The
  * worker hook wraps the whole rating block in its own try/catch as a final

package/src/cli.tsx

@@ -34,7 +34,6 @@ interface ParsedArgs {
   systemPrompt: string;
   systemPromptFile: string;
   additionalArgs: string[];
-  aiLoop: boolean;
   preset: string;
   open: boolean;
   showHelp: boolean;
@@ -54,7 +53,6 @@ function parseArgs(args: string[]): ParsedArgs {
   let systemPrompt = "";
   let systemPromptFile = "";
   let additionalArgs: string[] = [];
-  let aiLoop = false;
   let preset = "";
   let open = false;
   let showHelp = false;
@@ -92,8 +90,6 @@ function parseArgs(args: string[]): ParsedArgs {
     } else if (arg === "--system-prompt-file") {
       systemPromptFile = mainArgs[i + 1] || systemPromptFile;
       i++;
-    } else if (arg === "--ai-loop") {
-      aiLoop = true;
     } else if (arg === "--preset") {
       preset = mainArgs[i + 1] || preset;
       i++;
@@ -122,7 +118,6 @@ function parseArgs(args: string[]): ParsedArgs {
     systemPrompt,
     systemPromptFile,
     additionalArgs,
-    aiLoop,
     preset,
     open,
     showHelp,
@@ -207,7 +202,6 @@ const COMMAND_HELP: Record<
       "  --yolo                      Continue on errors instead of stopping",
       "  --system-prompt <text>      Custom system prompt (appended to Claude)",
       "  --system-prompt-file <path> Read system prompt from file",
-      "  --ai-loop                   Use AI-based polling (legacy mode)",
       "  -- <args...>                Additional arguments to pass to Claude CLI",
       "  -h, --help                  Show this help",
     ].join("\n"),
@@ -226,7 +220,6 @@ const COMMAND_HELP: Record<
       "  --yolo                      Continue on errors instead of stopping",
       "  --system-prompt <text>      Custom system prompt",
       "  --system-prompt-file <path> Read system prompt from file",
-      "  --ai-loop                   Use AI-based polling (legacy mode)",
       "  -- <args...>                Additional arguments to pass to Claude CLI",
       "  -h, --help                  Show this help",
     ].join("\n"),
@@ -406,7 +399,6 @@ interface RunnerProps {
   systemPrompt: string;
   systemPromptFile: string;
   additionalArgs: string[];
-  aiLoop: boolean;
 }
 
 function WorkerRunner({
@@ -415,7 +407,6 @@ function WorkerRunner({
   systemPrompt,
   systemPromptFile,
   additionalArgs,
-  aiLoop,
 }: RunnerProps) {
   const { exit } = useApp();
 
@@ -427,25 +418,17 @@ function WorkerRunner({
       systemPromptFile: systemPromptFile || undefined,
       additionalArgs,
       logsDir: "./logs",
-      aiLoop,
     }).catch((err) => {
       console.error("[error] Worker encountered an error:", err);
       exit(err);
     });
     // Note: runWorker runs indefinitely, so we don't call exit() on success
-  }, [prompt, yolo, systemPrompt, systemPromptFile, additionalArgs, aiLoop, exit]);
+  }, [prompt, yolo, systemPrompt, systemPromptFile, additionalArgs, exit]);
 
   return null;
 }
 
-function LeadRunner({
-  prompt,
-  yolo,
-  systemPrompt,
-  systemPromptFile,
-  additionalArgs,
-  aiLoop,
-}: RunnerProps) {
+function LeadRunner({ prompt, yolo, systemPrompt, systemPromptFile, additionalArgs }: RunnerProps) {
   const { exit } = useApp();
 
   useEffect(() => {
@@ -456,13 +439,12 @@ function LeadRunner({
       systemPromptFile: systemPromptFile || undefined,
       additionalArgs,
       logsDir: "./logs",
-      aiLoop,
     }).catch((err) => {
       console.error("[error] Lead encountered an error:", err);
       exit(err);
     });
     // Note: runLead runs indefinitely, so we don't call exit() on success
-  }, [prompt, yolo, systemPrompt, systemPromptFile, additionalArgs, aiLoop, exit]);
+  }, [prompt, yolo, systemPrompt, systemPromptFile, additionalArgs, exit]);
 
   return null;
 }
@@ -495,7 +477,6 @@ function App({ args }: { args: ParsedArgs }) {
     systemPrompt,
     systemPromptFile,
     additionalArgs,
-    aiLoop,
     preset,
   } = args;
 
@@ -516,7 +497,6 @@ function App({ args }: { args: ParsedArgs }) {
           systemPrompt={systemPrompt}
           systemPromptFile={systemPromptFile}
           additionalArgs={additionalArgs}
-          aiLoop={aiLoop}
         />
       );
     case "lead":
@@ -527,7 +507,6 @@ function App({ args }: { args: ParsedArgs }) {
           systemPrompt={systemPrompt}
           systemPromptFile={systemPromptFile}
           additionalArgs={additionalArgs}
-          aiLoop={aiLoop}
         />
       );
     // version, help, docs handled before render()

package/src/commands/credential-wait.ts

@@ -46,8 +46,17 @@ export class BootMaxWaitExceededError extends Error {
 }
 
 export interface AwaitCredentialsOptions {
-  /** Harness provider name — picks the predicate to run. */
+  /** Initial harness provider name — picks the predicate to run. */
   provider: string;
+  /**
+   * Optional getter that re-reads the harness provider on each tick. Lets the
+   * caller swap the harness mid-wait when an operator flips `HARNESS_PROVIDER`
+   * in `swarm_config` to escape a missing-credentials wedge. When unset, the
+   * static `provider` is used for the whole wait. The caller is responsible
+   * for any side effects of the swap (adapter, prompt rebuild, etc.) inside
+   * `refreshEnv` or out-of-band.
+   */
+  getProvider?: () => string;
   /** Pull latest swarm_config values into env. Resolves to the merged env. */
   refreshEnv: () => Promise<Record<string, string | undefined>>;
   /** Callback invoked on every tick — Phase 3 wires this to the status-report API. */
@@ -118,10 +127,17 @@ export async function awaitCredentials(opts: AwaitCredentialsOptions): Promise<C
   const initialEnv = opts.initialEnv ?? process.env;
   const backoff = resolveBackoff(opts.backoff, initialEnv);
 
+  // Re-read on every iteration so an operator flipping HARNESS_PROVIDER in
+  // swarm_config during the wait actually flips the predicate.
+  const readProvider = () => opts.getProvider?.() ?? opts.provider;
+
   // Fast path: already satisfied at boot.
-  let status = checkProviderCredentials(opts.provider, initialEnv, opts.credCheckOptions);
+  let currentProvider = readProvider();
+  let status = checkProviderCredentials(currentProvider, initialEnv, opts.credCheckOptions);
   if (status.ready) {
-    log(`[boot] credentials ready (provider=${opts.provider}, satisfiedBy=${status.satisfiedBy})`);
+    log(
+      `[boot] credentials ready (provider=${currentProvider}, satisfiedBy=${status.satisfiedBy})`,
+    );
     return status;
   }
 
@@ -143,7 +159,7 @@ export async function awaitCredentials(opts: AwaitCredentialsOptions): Promise<C
 
     log(
       `[boot] waiting for ${status.missing.join(", ") || "credentials"} ` +
-        `(attempt ${attempt}, retry in ${delayMs}ms)${status.hint ? ` — ${status.hint}` : ""}`,
+        `(attempt ${attempt}, retry in ${delayMs}ms, provider=${currentProvider})${status.hint ? ` — ${status.hint}` : ""}`,
     );
 
     await sleep(delayMs);
@@ -158,7 +174,16 @@ export async function awaitCredentials(opts: AwaitCredentialsOptions): Promise<C
       log(`[boot] env refresh failed (non-fatal): ${err}`);
     }
 
-    status = checkProviderCredentials(opts.provider, process.env, opts.credCheckOptions);
+    // Re-read provider in case the operator flipped HARNESS_PROVIDER during
+    // the wait. The caller is expected to have already swapped adapter/prompt
+    // (typically inside `refreshEnv`); we just pivot the predicate here.
+    const nextProvider = readProvider();
+    if (nextProvider !== currentProvider) {
+      log(`[boot] provider changed mid-wait: ${currentProvider} → ${nextProvider}`);
+      currentProvider = nextProvider;
+    }
+
+    status = checkProviderCredentials(currentProvider, process.env, opts.credCheckOptions);
 
     if (!status.ready) {
       // Exponential backoff with cap.
@@ -174,7 +199,7 @@ export async function awaitCredentials(opts: AwaitCredentialsOptions): Promise<C
   }
 
   log(
-    `[boot] credentials ready (provider=${opts.provider}, satisfiedBy=${status.satisfiedBy}, attempts=${attempt})`,
+    `[boot] credentials ready (provider=${currentProvider}, satisfiedBy=${status.satisfiedBy}, attempts=${attempt})`,
   );
   // Final tick so callers can clear the waiting state.
   try {