@desplega.ai/agent-swarm 1.147.0 → 1.148.0

package/src/tools/accept-steer.ts

@@ -16,7 +16,6 @@ export const acceptSteerInputSchema = z.object({
   steeringMessageId: z.uuid().describe("The steering message ID to acknowledge."),
   note: z
     .string()
-    .max(500)
     .optional()
     .describe("Optional short note describing how the steering was incorporated."),
 });

package/src/tools/memory-get.ts

@@ -80,12 +80,14 @@ export const registerMemoryGetTool = (server: McpServer) => {
       annotations: { readOnlyHint: true },
 
       inputSchema: z.object({
-        memoryId: z.uuid().describe("The ID of the memory to retrieve."),
+        memoryId: z.uuid().optional().describe("The ID of the memory to retrieve (or use id)."),
+        id: z.uuid().optional().describe("Alias for memoryId, matching memory-search results."),
         intent: z
           .string()
           .min(1)
+          .optional()
           .describe(
-            "Why you are retrieving this memory. Required. E.g. 'need full details of the auth fix pattern'.",
+            "Optional reason for retrieving this memory. E.g. 'need full details of the auth fix pattern'.",
           ),
       }),
       outputSchema: swarmToolOutputSchema({
@@ -102,7 +104,12 @@ export const registerMemoryGetTool = (server: McpServer) => {
         rateHint: z.string().optional(),
       }),
     },
-    async ({ memoryId, intent }, requestInfo, _meta) => {
+    async ({ memoryId: requestedMemoryId, id, intent }, requestInfo, _meta) => {
+      if (requestedMemoryId && id && requestedMemoryId !== id) {
+        return toolErr("memoryId and id must identify the same memory; supply only one.");
+      }
+      const memoryId = requestedMemoryId ?? id;
+      if (!memoryId) return toolErr("Supply memoryId (or its alias id) from memory-search.");
       const store = getMemoryStore();
       const memoryForAuth = await store.peek(memoryId);
 

package/src/tools/memory-rate.ts

@@ -42,15 +42,21 @@ export const registerMemoryRateTool = (server: McpServer) => {
         "the swarm learns to surface better memories next time.",
       annotations: { destructiveHint: false },
       inputSchema: z.object({
-        id: z.string().describe("Memory ID returned by memory_search."),
+        id: z
+          .string()
+          .min(1)
+          .optional()
+          .describe("Memory ID returned by memory-search (or use memoryId)."),
+        memoryId: z.string().min(1).optional().describe("Alias for id, matching memory-get."),
         useful: z
           .boolean()
           .describe("true = this memory helped solve the task; false = misled or wasted time."),
         note: z
           .string()
-          .max(280)
           .optional()
-          .describe("Short reason. Captured for telemetry; not surfaced to other agents."),
+          .describe(
+            "Reason, stored up to 500 characters for telemetry; not surfaced to other agents.",
+          ),
         referencesSource: z
           .string()
           .min(1)
@@ -60,7 +66,13 @@ export const registerMemoryRateTool = (server: McpServer) => {
       }),
       outputSchema: swarmToolOutputSchema(),
     },
-    async ({ id, useful, note, referencesSource }, requestInfo, _meta) => {
+    async ({ id, memoryId, useful, note, referencesSource }, requestInfo, _meta) => {
+      if (id && memoryId && id !== memoryId) {
+        return toolErr("id and memoryId must identify the same memory; supply only one.");
+      }
+      const resolvedMemoryId = id ?? memoryId;
+      if (!resolvedMemoryId)
+        return toolErr("Supply id (or its alias memoryId) from memory-search.");
       if (!requestInfo.agentId) {
         return toolErr("Agent ID required. Are you registered in the swarm?");
       }
@@ -85,11 +97,11 @@ export const registerMemoryRateTool = (server: McpServer) => {
       const apiKey = getApiKey();
 
       const event = {
-        memoryId: id,
+        memoryId: resolvedMemoryId,
         signal: useful ? 1 : -1,
         weight: 1.0,
         source: "explicit-self" as const,
-        reasoning: note ?? "",
+        reasoning: (note ?? "").slice(0, 500),
         taskId: requestInfo.sourceTaskId,
         ...(cleanedReferencesSource !== undefined
           ? { referencesSource: cleanedReferencesSource }
@@ -129,7 +141,7 @@ export const registerMemoryRateTool = (server: McpServer) => {
           return toolErr(`Memory rating failed (HTTP ${response.status}).`);
         }
 
-        return toolOk(`Memory ${id} rated as ${useful ? "useful" : "not useful"}.`);
+        return toolOk(`Memory ${resolvedMemoryId} rated as ${useful ? "useful" : "not useful"}.`);
       } catch (err) {
         return toolErr(`Memory rating failed: ${(err as Error).message}`);
       }

package/src/tools/memory-search.ts

@@ -84,8 +84,9 @@ export const registerMemorySearchTool = (server: McpServer) => {
         intent: z
           .string()
           .min(1)
+          .optional()
           .describe(
-            "Why you are searching for this memory. Required. E.g. 'looking for auth pattern to fix login bug'.",
+            "Optional reason for searching for this memory. E.g. 'looking for auth pattern to fix login bug'.",
           ),
         scope: z
           .enum(["all", "agent", "swarm"])

package/src/tools/memory-store.ts

@@ -24,14 +24,19 @@ export const registerMemoryStoreTool = (server: McpServer) => {
           .string()
           .min(1)
           .max(200)
-          .describe("Short title, one line, used in search results and the UI."),
+          .optional()
+          .describe(
+            "Short title used in search results and the UI. Defaults to the first non-empty content line (up to 200 characters).",
+          ),
         scope: AgentMemoryScopeSchema.default("agent").describe(
           "'agent' (default): only you can recall it. 'swarm': every agent can recall it.",
         ),
         tags: z
-          .array(z.string())
+          .union([z.array(z.string()), z.string()])
           .optional()
-          .describe("Free-form tags, for example a repo name or a topic."),
+          .describe(
+            "Free-form tags as an array or a comma-separated string, for example a repo name or a topic.",
+          ),
         taskId: z
           .uuid()
           .optional()
@@ -49,7 +54,22 @@ export const registerMemoryStoreTool = (server: McpServer) => {
         queued: z.boolean().optional(),
       }),
     },
-    async ({ content, name, scope, tags, taskId, intent }, requestInfo, _meta) => {
+    async ({ content, name: requestedName, scope, tags, taskId, intent }, requestInfo, _meta) => {
+      const name =
+        requestedName ??
+        content
+          .split(/\r?\n/)
+          .find((line) => line.trim())
+          ?.trim()
+          .slice(0, 200) ??
+        "Untitled memory";
+      const normalizedTags =
+        typeof tags === "string"
+          ? tags
+              .split(",")
+              .map((tag) => tag.trim())
+              .filter(Boolean)
+          : tags;
       if (!requestInfo.agentId) {
         return toolErr("Agent ID required. Are you registered in the swarm?");
       }
@@ -64,7 +84,7 @@ export const registerMemoryStoreTool = (server: McpServer) => {
           scope,
           source: "manual",
           sourceTaskId: taskId ?? null,
-          tags,
+          tags: normalizedTags,
           intent,
         });
 

package/src/tools/send-task.ts

@@ -11,6 +11,7 @@ import {
   getAgentById,
   getDbClient,
   getTaskById,
+  getUserById,
   hasCapacity,
 } from "@/be/db";
 import { repointTrackerSyncBySwarmId } from "@/be/db-queries/tracker";
@@ -148,10 +149,10 @@ export const sendTaskInputSchema = z
       ),
     requestedByUserId: z
       .string()
-      .uuid()
+      .regex(/^[a-f0-9]{32}$/, "Expected a registry user ID (32 lowercase hexadecimal characters).")
       .optional()
       .describe(
-        "ID of the human user who originally requested this task chain. When omitted, inherited from the caller's current task so the attribution flows through multi-hop delegation automatically.",
+        "Registered requester ID (32 lowercase hexadecimal characters). When omitted, inherited from the caller's current task so the attribution flows through multi-hop delegation automatically.",
       ),
     followUpConfig: FollowUpConfigSchema.optional().describe(
       "Control the lead follow-up created when this task finishes. When to use `followUpConfig`: set `disabled: true` when you'll wait for this task to complete inline and no follow-up is needed; set `onCompleted` / `onFailed` with specific instructions when you need to follow up effectively on a particular outcome of a long-running flow; for normal one-shot tasks, leave it unset because defaults are fine. It is most valuable for long-running / complex flows.",
@@ -257,6 +258,12 @@ export async function sendTaskHandler(
   const requestedByUserId =
     ctx.kind === "user" ? ctx.userId : (inputRequestedByUserId ?? undefined);
 
+  if (ctx.kind === "owner" && requestedByUserId && !(await getUserById(requestedByUserId))) {
+    return toolErr("requestedByUserId must identify an existing registered user.", {
+      data: { yourAgentId: creatorAgentId },
+    });
+  }
+
   if (ctx.kind === "owner" && agentId === ctx.agentId) {
     return toolErr("Cannot send a task to yourself, are you drunk?", {
       data: { yourAgentId: ctx.agentId },

package/src/tools/store-progress.ts

@@ -68,12 +68,19 @@ export const registerStoreProgressTool = (server: McpServer) => {
       annotations: { idempotentHint: true },
 
       inputSchema: z.object({
-        taskId: z.uuid().describe("The ID of the task to update progress for."),
+        taskId: z
+          .uuid()
+          .optional()
+          .describe(
+            "Full task UUID. Defaults to the caller-owned task in X-Source-Task-Id; required outside task context.",
+          ),
         progress: z.string().optional().describe("The progress update to store."),
         status: z
-          .enum(["completed", "failed"])
+          .enum(["completed", "failed", "in_progress", "pending"])
           .optional()
-          .describe("Set to 'completed' or 'failed' to finish the task."),
+          .describe(
+            "Set to 'completed' or 'failed' to finish the task. 'in_progress' and 'pending' store progress only and do not change task status.",
+          ),
         output: z
           .string()
           .optional()
@@ -111,7 +118,16 @@ export const registerStoreProgressTool = (server: McpServer) => {
       outputSchema: storeProgressOutputSchema,
     },
     async (
-      { taskId, progress, status, output, failureReason, attachments, persistMemory, force },
+      {
+        taskId: requestedTaskId,
+        progress,
+        status: requestedStatus,
+        output,
+        failureReason,
+        attachments,
+        persistMemory,
+        force,
+      },
       requestInfo,
       _meta,
     ) => {
@@ -119,6 +135,21 @@ export const registerStoreProgressTool = (server: McpServer) => {
         return toolErr('Agent ID not found. The MCP client should define the "X-Agent-ID" header.');
       }
 
+      const taskId = requestedTaskId ?? requestInfo.sourceTaskId;
+      if (!taskId || !z.uuid().safeParse(taskId).success) {
+        return toolErr("Supply taskId as the full task UUID; no valid task context is available.");
+      }
+      if (!requestedTaskId) {
+        const contextTask = await getTaskById(taskId);
+        if (!contextTask || contextTask.agentId !== requestInfo.agentId) {
+          return toolErr("Omitted taskId requires a source task assigned to the calling agent.");
+        }
+      }
+      const status =
+        requestedStatus === "completed" || requestedStatus === "failed"
+          ? requestedStatus
+          : undefined;
+
       // Verify agent-fs pointers before opening the write transaction. The
       // registering agent's resolved config selects both credentials and the
       // exact org/drive; never let the provider fall back to a personal drive.