@desplega.ai/agent-swarm 1.173.0 → 2.1.0

package/src/scripts-runtime/types/stdlib.d.ts

@@ -329,6 +329,8 @@ declare module "swarm-sdk" {
       key?: string;
       includeSecrets?: boolean;
     }): Promise<unknown>;
+    // --- model profiles ---
+    modelProfile_list(args?: { harness?: string }): Promise<unknown>;
     // --- slack ---
     slack_read(args?: {
       inboxMessageId?: string;
@@ -342,6 +344,8 @@ declare module "swarm-sdk" {
       types?: Array<"public" | "private" | "dm" | "mpim">;
       limit?: number;
     }): Promise<unknown>;
+    // --- chat sdk ---
+    chat_readThread(args: { threadId: string; limit?: number }): Promise<unknown>;
     // --- messaging ---
     message_read(args?: {
       channel?: string;
@@ -351,13 +355,6 @@ declare module "swarm-sdk" {
       mentionsOnly?: boolean;
       markAsRead?: boolean;
     }): Promise<unknown>;
-    // --- services ---
-    service_list(args?: {
-      agentId?: string;
-      name?: string;
-      status?: "starting" | "healthy" | "unhealthy" | "stopped";
-      includeOwn?: boolean;
-    }): Promise<unknown>;
     // --- context / profiles ---
     context_history(args?: {
       agentId?: string;
@@ -452,6 +449,7 @@ declare module "swarm-sdk" {
       scope?: "global" | "agent" | "repo";
       scopeId?: string;
       isSecret?: boolean;
+      exportToEnv?: boolean;
     }): Promise<unknown>;
     config_delete(args: { id: string }): Promise<unknown>;
 
@@ -492,20 +490,36 @@ declare module "swarm-sdk" {
     slack_delete(args: { channelId: string; messageTs: string }): Promise<unknown>;
     slack_update(args: { channelId: string; messageTs: string; message: string }): Promise<unknown>;
 
+    // --- write: chat sdk ---
+    chat_reply(args: { text: string }): Promise<unknown>;
+    chat_post(args: {
+      adapter: "telegram" | "slack" | "discord" | "teams";
+      threadId?: string;
+      channelId?: string;
+      text: string;
+    }): Promise<unknown>;
+    chat_openDm(args: {
+      adapter: "telegram" | "slack" | "discord" | "teams";
+      userId: string;
+    }): Promise<unknown>;
+    chat_registerChannel(args: {
+      adapter: "telegram" | "slack" | "discord" | "teams";
+      channelId: string;
+      agentId?: string;
+      workflowId?: string;
+      name?: string;
+    }): Promise<unknown>;
+    chat_unregisterChannel(args: {
+      adapter: "telegram" | "slack" | "discord" | "teams";
+      channelId: string;
+    }): Promise<unknown>;
+
     // --- write: messaging (internal) ---
     message_post(args: { channel?: string; content: string; to?: string }): Promise<unknown>;
 
     // --- write: profiles ---
     profile_update(args: Record<string, unknown>): Promise<unknown>;
 
-    // --- write: services ---
-    service_register(args: Record<string, unknown>): Promise<unknown>;
-    service_unregister(args: { name: string }): Promise<unknown>;
-    service_updateStatus(args: {
-      name: string;
-      status: "starting" | "healthy" | "unhealthy" | "stopped";
-    }): Promise<unknown>;
-
     // --- write: schedules ---
     schedule_create(args: Record<string, unknown>): Promise<unknown>;
     schedule_update(args: Record<string, unknown>): Promise<unknown>;
@@ -666,6 +680,16 @@ declare module "swarm-sdk" {
     // --- human input ---
     request_humanInput(args: Record<string, unknown>): Promise<unknown>;
     approval_cancel(args: { requestId: string; reason?: string }): Promise<unknown>;
+
+    // --- decisions ---
+    systemOne_decide(args: {
+      provider?: "typesafe" | "openrouter" | "laya" | "openai" | "cloudflare";
+      model?: string;
+      state: string | string[] | Record<string, unknown>;
+      questions: Record<string, Record<string, unknown>>;
+      timeoutMs?: number;
+      maxRetries?: number;
+    }): Promise<unknown>;
   }
 
   export interface ScriptStdlib {

package/src/scripts-runtime/types/swarm-extension.d.ts

@@ -19,6 +19,7 @@ declare module "swarm-extension" {
       | "linear"
       | "jira"
       | "comb"
+      | "chat"
       | undefined;
     routingReason?:
       | "skill"
@@ -59,6 +60,7 @@ declare module "swarm-extension" {
     model?: string | undefined;
     modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;
     effort?: "off" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    profile?: string | undefined;
     scheduleId?: string | undefined;
     workflowRunId?: string | undefined;
     workflowRunStepId?: string | undefined;
@@ -132,7 +134,8 @@ declare module "swarm-extension" {
       | "system"
       | "linear"
       | "jira"
-      | "comb";
+      | "comb"
+      | "chat";
     tags: string[];
     priority: number;
     dependsOn: string[];
@@ -191,6 +194,9 @@ declare module "swarm-extension" {
     resolvedModel?: string | undefined;
     modelSource?: string | undefined;
     modelAlias?: string | undefined;
+    resolvedEffort?: "off" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    profile?: string | undefined;
+    resolvedProfile?: string | undefined;
     scheduleId?: string | undefined;
     workflowRunId?: string | null | undefined;
     workflowRunStepId?: string | null | undefined;
@@ -467,6 +473,43 @@ declare module "swarm-extension" {
           kind: "broadcast";
         };
   }
+  /** A Chat SDK message after its thread buffer flushed, before routing. */
+  export interface ChatRouteEvent {
+    /** Adapter name, such as `telegram` or `slack`. */
+    adapter: string;
+    channelId: string;
+    /** The Chat SDK thread id, prefixed with the adapter name. */
+    threadId: string;
+    /** The first buffered sender. */
+    userId: string;
+    userName?: string;
+    /** The buffered messages, joined. */
+    text: string;
+    botMentioned: boolean;
+    isDirectMessage: boolean;
+    /** Set when earlier swarm tasks exist in this thread. */
+    threadContext?: {
+      adapter: string;
+      threadId: string;
+    };
+  }
+  export interface ChatRouteModify {
+    target:
+      | {
+          kind: "agent";
+          agentId: string;
+        }
+      | {
+          kind: "lead";
+        }
+      | {
+          kind: "broadcast";
+        }
+      | {
+          kind: "workflow";
+          workflowId: string;
+        };
+  }
   export type HeartbeatClassification = "no-session" | "stale-session" | "fresh-stalled";
   export type HeartbeatAction = "supersede-resume" | "fail" | "record";
   export interface HeartbeatRemediateEvent {
@@ -511,6 +554,18 @@ declare module "swarm-extension" {
     threadTs?: string;
     taskId?: string;
   }
+  /** A Chat SDK message the swarm received or sent. */
+  export interface ChatMessageEvent {
+    adapter: string;
+    channelId: string;
+    threadId: string;
+    /** The sender, for an inbound message. */
+    userId?: string;
+    text: string;
+    direction: "inbound" | "outbound";
+    taskId?: string;
+    messageId?: string;
+  }
   /**
    * A person answered an approval request. Fires for workflow and standalone
    * requests. Timeouts and cancellations do not emit it today.
@@ -619,6 +674,11 @@ declare module "swarm-extension" {
       modify: SlackRouteModify;
       result: PreResult<SlackRouteModify>;
     };
+    "pre.chat.route": {
+      event: ChatRouteEvent;
+      modify: ChatRouteModify;
+      result: PreResult<ChatRouteModify>;
+    };
     "pre.heartbeat.remediate": {
       event: HeartbeatRemediateEvent;
       modify: HeartbeatRemediateModify;
@@ -664,6 +724,11 @@ declare module "swarm-extension" {
       modify: never;
       result: void;
     };
+    "post.chat.message": {
+      event: ChatMessageEvent;
+      modify: never;
+      result: void;
+    };
     "post.approval.resolved": {
       event: ApprovalResolvedEvent;
       modify: never;

package/src/scripts-runtime/types/swarm-sdk.d.ts

@@ -311,6 +311,8 @@ declare module "swarm-sdk" {
       key?: string;
       includeSecrets?: boolean;
     }): Promise<unknown>;
+    // --- model profiles ---
+    modelProfile_list(args?: { harness?: string }): Promise<unknown>;
     // --- slack ---
     slack_read(args?: {
       inboxMessageId?: string;
@@ -324,6 +326,8 @@ declare module "swarm-sdk" {
       types?: Array<"public" | "private" | "dm" | "mpim">;
       limit?: number;
     }): Promise<unknown>;
+    // --- chat sdk ---
+    chat_readThread(args: { threadId: string; limit?: number }): Promise<unknown>;
     // --- messaging ---
     message_read(args?: {
       channel?: string;
@@ -333,13 +337,6 @@ declare module "swarm-sdk" {
       mentionsOnly?: boolean;
       markAsRead?: boolean;
     }): Promise<unknown>;
-    // --- services ---
-    service_list(args?: {
-      agentId?: string;
-      name?: string;
-      status?: "starting" | "healthy" | "unhealthy" | "stopped";
-      includeOwn?: boolean;
-    }): Promise<unknown>;
     // --- context / profiles ---
     context_history(args?: {
       agentId?: string;
@@ -434,6 +431,7 @@ declare module "swarm-sdk" {
       scope?: "global" | "agent" | "repo";
       scopeId?: string;
       isSecret?: boolean;
+      exportToEnv?: boolean;
     }): Promise<unknown>;
     config_delete(args: { id: string }): Promise<unknown>;
 
@@ -474,20 +472,36 @@ declare module "swarm-sdk" {
     slack_delete(args: { channelId: string; messageTs: string }): Promise<unknown>;
     slack_update(args: { channelId: string; messageTs: string; message: string }): Promise<unknown>;
 
+    // --- write: chat sdk ---
+    chat_reply(args: { text: string }): Promise<unknown>;
+    chat_post(args: {
+      adapter: "telegram" | "slack" | "discord" | "teams";
+      threadId?: string;
+      channelId?: string;
+      text: string;
+    }): Promise<unknown>;
+    chat_openDm(args: {
+      adapter: "telegram" | "slack" | "discord" | "teams";
+      userId: string;
+    }): Promise<unknown>;
+    chat_registerChannel(args: {
+      adapter: "telegram" | "slack" | "discord" | "teams";
+      channelId: string;
+      agentId?: string;
+      workflowId?: string;
+      name?: string;
+    }): Promise<unknown>;
+    chat_unregisterChannel(args: {
+      adapter: "telegram" | "slack" | "discord" | "teams";
+      channelId: string;
+    }): Promise<unknown>;
+
     // --- write: messaging (internal) ---
     message_post(args: { channel?: string; content: string; to?: string }): Promise<unknown>;
 
     // --- write: profiles ---
     profile_update(args: Record<string, unknown>): Promise<unknown>;
 
-    // --- write: services ---
-    service_register(args: Record<string, unknown>): Promise<unknown>;
-    service_unregister(args: { name: string }): Promise<unknown>;
-    service_updateStatus(args: {
-      name: string;
-      status: "starting" | "healthy" | "unhealthy" | "stopped";
-    }): Promise<unknown>;
-
     // --- write: schedules ---
     schedule_create(args: Record<string, unknown>): Promise<unknown>;
     schedule_update(args: Record<string, unknown>): Promise<unknown>;
@@ -648,6 +662,16 @@ declare module "swarm-sdk" {
     // --- human input ---
     request_humanInput(args: Record<string, unknown>): Promise<unknown>;
     approval_cancel(args: { requestId: string; reason?: string }): Promise<unknown>;
+
+    // --- decisions ---
+    systemOne_decide(args: {
+      provider?: "typesafe" | "openrouter" | "laya" | "openai" | "cloudflare";
+      model?: string;
+      state: string | string[] | Record<string, unknown>;
+      questions: Record<string, Record<string, unknown>>;
+      timeoutMs?: number;
+      maxRetries?: number;
+    }): Promise<unknown>;
   }
 
   export interface ScriptStdlib {

package/src/server.ts

@@ -1,11 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import pkg from "../package.json";
-import { ensurePricingSeeded, ensureRbacSeeded } from "./be/boot-seeds";
+import { ensureModelProfilesSeeded, ensurePricingSeeded, ensureRbacSeeded } from "./be/boot-seeds";
 import { initDb } from "./be/db";
 import { startPricingRefreshLoop } from "./be/pricing-refresh";
 import { isSteeringEnabled } from "./be/steering";
 import { registerGithubTaskReactions } from "./github/task-reactions";
 import { loadGlobalConfigsIntoEnv } from "./http/core";
+import { isChatSdkEnabled } from "./integrations/chat-sdk/config";
 import { resolveTemplate } from "./prompts/resolver";
 import { isRbacEnabled } from "./rbac";
 import { getSlackConfiguration } from "./slack/config";
@@ -21,6 +22,10 @@ import { registerAppSyncTool } from "./tools/app-sync";
 import { registerAppUpsertTool } from "./tools/app-upsert";
 import { registerCancelApprovalRequestTool } from "./tools/cancel-approval-request";
 import { registerCancelTaskTool } from "./tools/cancel-task";
+import { registerChatOpenDmTool } from "./tools/chat-open-dm";
+import { registerChatPostTool } from "./tools/chat-post";
+import { registerChatReadThreadTool } from "./tools/chat-read-thread";
+import { registerChatReplyTool } from "./tools/chat-reply";
 import { registerContextDiffTool } from "./tools/context-diff";
 import { registerContextHistoryTool } from "./tools/context-history";
 import { registerCreateChannelTool } from "./tools/create-channel";
@@ -54,7 +59,6 @@ import {
 } from "./tools/kv";
 // Messaging capability
 import { registerListChannelsTool } from "./tools/list-channels";
-import { registerListServicesTool } from "./tools/list-services";
 import { registerManageUserTool } from "./tools/manage-user";
 // MCP Servers capability
 import {
@@ -77,6 +81,7 @@ import {
   registerModelCatalogOverlayUpsertTool,
   registerModelCatalogRefreshTool,
 } from "./tools/model-catalog";
+import { registerListModelProfilesTool } from "./tools/model-profiles/list-model-profiles";
 import { registerMyAgentInfoTool } from "./tools/my-agent-info";
 import { registerGetOauthAccessTokenTool } from "./tools/oauth-access-token";
 import { registerPollTaskTool } from "./tools/poll-task";
@@ -91,12 +96,15 @@ import {
 } from "./tools/prompt-templates";
 import { registerReadMessagesTool } from "./tools/read-messages";
 import { registerRegisterAgentmailInboxTool } from "./tools/register-agentmail-inbox";
+import {
+  registerRegisterChatChannelTool,
+  registerUnregisterChatChannelTool,
+} from "./tools/register-chat-channel";
 import {
   registerRegisterKapsoNumberTool,
   registerUnregisterKapsoNumberTool,
 } from "./tools/register-kapso-number";
 // Services capability
-import { registerRegisterServiceTool } from "./tools/register-service";
 // Repo management tools
 import { registerGetReposTool, registerUpdateRepoTool } from "./tools/repos";
 import { registerRequestHumanInputTool } from "./tools/request-human-input";
@@ -169,6 +177,7 @@ import {
 } from "./tools/swarm-config";
 import { registerSwarmXTool } from "./tools/swarm-x";
 // Task pool capability
+import { registerSystemOneDecideTool } from "./tools/system-one-decide";
 import { registerTaskActionTool } from "./tools/task-action";
 // Tracker capability
 import {
@@ -178,10 +187,8 @@ import {
   registerTrackerSyncStatusTool,
   registerTrackerUnlinkTool,
 } from "./tools/tracker";
-import { registerUnregisterServiceTool } from "./tools/unregister-service";
 // Profiles capability
 import { registerUpdateProfileTool } from "./tools/update-profile";
-import { registerUpdateServiceStatusTool } from "./tools/update-service-status";
 import { setPreloadedTools } from "./tools/utils";
 import {
   registerReplyWhatsappMessageTool,
@@ -216,7 +223,6 @@ export const ALL_CAPABILITIES = [
   "prompt-templates",
   "mcp",
   "profiles",
-  "services",
   "scheduling",
   "memory",
   "workflows",
@@ -230,6 +236,7 @@ export const ALL_CAPABILITIES = [
   "repo",
   "agentmail",
   "kapso",
+  "chat-sdk",
   "swarm-x",
 ] as const;
 
@@ -256,12 +263,12 @@ const DEFAULT_CAPABILITIES: string = [
   //
   // Disabled by default
   //
-  // "services",
   // "prompt-templates",
   // "messaging",
   // "swarm-x",
   // "agentmail",
   // "kapso",
+  // "chat-sdk", (added by getEnabledCapabilities when CHAT_SDK_ENABLED is true)
 ].join(",");
 
 // Note: unknown names are kept (they never match hasCapability); workers
@@ -280,11 +287,22 @@ export function hasCapability(cap: CAPABILITIES_T): boolean {
   return getCapabilities().has(cap);
 }
 
+const KNOWN_CAPABILITIES: ReadonlySet<string> = new Set(ALL_CAPABILITIES);
+
 export function getEnabledCapabilities(): CAPABILITIES_T[] {
-  const capabilities = Array.from(getCapabilities());
+  // Only known flags: the register response validates against ALL_CAPABILITIES,
+  // so a retired name still listed in CAPABILITIES (e.g. `services`) would
+  // otherwise turn every agent registration into a 500.
+  const capabilities: CAPABILITIES_T[] = Array.from(getCapabilities()).filter(
+    (capability) => KNOWN_CAPABILITIES.has(capability) && capability !== "chat-sdk",
+  );
+  // The Chat SDK channel follows CHAT_SDK_ENABLED, not the CAPABILITIES list.
+  if (isChatSdkEnabled()) capabilities.push("chat-sdk");
   // Phase 1 has no HTTP receiver. Do not advertise usable Slack tools to
-  // workers when HTTP (or an invalid transport) was selected.
-  return getSlackConfiguration().mode === "socket"
+  // workers when HTTP (or an invalid transport) was selected, or when the
+  // built-in Slack app is off (SLACK_DISABLE, required by the Chat SDK Slack adapter).
+  const slack = getSlackConfiguration();
+  return slack.mode === "socket" && !slack.disabled
     ? capabilities
     : capabilities.filter((capability) => capability !== "slack");
 }
@@ -344,6 +362,13 @@ function applyToolAllowlist(server: McpServer, allowlist: readonly string[]): vo
   }
 }
 
+function removeTools(server: McpServer, names: readonly string[]): void {
+  // oxlint-disable-next-line anti-slop/no-chained-type-assertions -- the MCP SDK keeps its tool registry private.
+  const tools = (server as unknown as { _registeredTools: Record<string, { remove(): void }> })
+    ._registeredTools;
+  for (const name of names) tools[name]?.remove();
+}
+
 export async function createServer(
   opts: {
     scriptsOnly?: boolean;
@@ -351,6 +376,8 @@ export async function createServer(
     preloadedTools?: readonly string[];
     /** Raw SWARM_ENABLED_TOOLS value for this session; defaults to the env. */
     enabledTools?: string;
+    /** Tool names removed from this session after registration (task-context filters). */
+    excludedTools?: readonly string[];
   } = {},
 ) {
   // Reload env
@@ -368,8 +395,12 @@ export async function createServer(
   // fullSurface to register every tool group regardless of CAPABILITIES.
   // An allowlist also registers every group, then prunes to the listed names.
   // This shadows the module-level hasCapability for the registrations below.
+  // `chat-sdk` follows CHAT_SDK_ENABLED (as in getEnabledCapabilities), not
+  // the CAPABILITIES list.
   const hasCapability = (cap: CAPABILITIES_T): boolean =>
-    opts.fullSurface === true || toolAllowlist !== undefined || getCapabilities().has(cap);
+    opts.fullSurface === true ||
+    toolAllowlist !== undefined ||
+    (cap === "chat-sdk" ? isChatSdkEnabled() : getCapabilities().has(cap));
 
   // Initialize database with WAL mode
   // Uses DATABASE_PATH env var for Docker volume compatibility (WAL needs .sqlite, .sqlite-wal, .sqlite-shm on same filesystem)
@@ -385,6 +416,11 @@ export async function createServer(
   // manual-override constants for runtime-fee / ACU pricing.
   ensurePricingSeeded();
   startPricingRefreshLoop();
+  try {
+    await ensureModelProfilesSeeded();
+  } catch (err) {
+    console.error("[server] Failed to seed model profiles:", err);
+  }
 
   try {
     ensureRbacSeeded();
@@ -448,6 +484,7 @@ export async function createServer(
     registerGetTasksTool(server);
     registerGetMetricsTool(server);
     registerSendTaskTool(server);
+    registerListModelProfilesTool(server);
     registerGetTaskDetailsTool(server);
     registerStoreProgressTool(server);
     registerMyAgentInfoTool(server);
@@ -582,6 +619,7 @@ export async function createServer(
     registerGetWorkflowRunTool(server);
     registerRetryWorkflowRunTool(server);
     registerCancelWorkflowRunTool(server);
+    registerSystemOneDecideTool(server);
     registerRequestHumanInputTool(server);
     registerCancelApprovalRequestTool(server);
   }
@@ -677,6 +715,16 @@ export async function createServer(
     registerReplyWhatsappMessageTool(server);
   }
 
+  // Chat SDK capability - Telegram/Slack/Discord/Teams through the Chat SDK channel (reply, post, DM, read, channel routes)
+  if (hasCapability("chat-sdk")) {
+    registerChatReplyTool(server);
+    registerChatPostTool(server);
+    registerChatOpenDmTool(server);
+    registerChatReadThreadTool(server);
+    registerRegisterChatChannelTool(server);
+    registerUnregisterChatChannelTool(server);
+  }
+
   // Swarm-x capability - external command routes mirroring the `agent-swarm x ...` CLI surface
   if (hasCapability("swarm-x")) {
     registerSwarmXTool(server);
@@ -693,15 +741,10 @@ export async function createServer(
     registerDeleteChannelTool(server);
   }
 
-  // Services capability - PM2/background service registry
-  if (hasCapability("services")) {
-    registerRegisterServiceTool(server);
-    registerUnregisterServiceTool(server);
-    registerListServicesTool(server);
-    registerUpdateServiceStatusTool(server);
-  }
-
   if (toolAllowlist) applyToolAllowlist(server, toolAllowlist);
+  if (opts.fullSurface !== true && opts.excludedTools?.length) {
+    removeTools(server, opts.excludedTools);
+  }
 
   return server;
 }

package/src/slack/blocks.ts

@@ -8,6 +8,7 @@
 import type { AgentTaskStatus, TaskAttachment } from "../types";
 import { getAppUrl } from "../utils/constants";
 import { taskAttachmentDisplayUrl } from "../utils/task-attachment-links";
+import { completedStatusIcon } from "./reaction-shortcode";
 
 // Slack limits section text to 3000 chars; we use 2900 for safety.
 export const MAX_SECTION_LENGTH = 2900;
@@ -294,7 +295,7 @@ export function buildCompletedBlocks(opts: {
   trailer?: string;
 }): SlackBlock[] {
   const taskLink = getTaskLink(opts.taskId);
-  let line = `✅ *${opts.agentName}* (${taskLink})`;
+  let line = `${completedStatusIcon()} *${opts.agentName}* (${taskLink})`;
   if (opts.duration) line += ` · ${opts.duration}`;
 
   const blocks: SlackBlock[] = [sectionBlock(line)];
@@ -479,7 +480,8 @@ export function isTreeOutputTruncated(text: string): boolean {
  * Render a single node line: icon + bold name + task link + optional duration.
  */
 function renderNodeLine(node: TreeNode): string {
-  const icon = STATUS_ICON[node.status] ?? "•";
+  const icon =
+    node.status === "completed" ? completedStatusIcon() : (STATUS_ICON[node.status] ?? "•");
   const taskLink = getTaskLink(node.taskId);
   let line = `${icon} *${node.agentName}* (${taskLink})`;
   if (node.duration) line += ` · ${node.duration}`;

package/src/slack/event-dedup.ts

@@ -18,7 +18,7 @@
  * safe-but-tight bound.
  *
  * Single-pod-only. The API server (which owns the Slack socket) runs as a
- * single PM2 process; if that ever changes, swap this for a DB-backed table.
+ * single API process; if that ever changes, swap this for a DB-backed table.
  */
 
 const DEFAULT_TTL_MS = 300_000; // 5 minutes

package/src/slack/reaction-shortcode.ts

@@ -43,3 +43,17 @@ export function reactionName(event: SlackReactionEvent): string {
   const normalized = normalizeSlackReactionShortcode(raw);
   return normalized ?? SLACK_REACTION_DEFAULTS[event];
 }
+
+export const SLACK_STATUS_ICON_COMPLETED_KEY = "SLACK_STATUS_ICON_COMPLETED";
+export const SLACK_STATUS_ICON_COMPLETED_DEFAULT = "✅";
+
+/**
+ * The "done" glyph in thread text (task tree, thread header, outcome cards).
+ * Read per call so a global config write, which reloads `process.env`, takes
+ * effect without a restart. Unlike a reaction there is no `invalid_name`
+ * fallback in text: a name the workspace lacks renders as literal `:name:`.
+ */
+export function completedStatusIcon(): string {
+  const normalized = normalizeSlackReactionShortcode(process.env[SLACK_STATUS_ICON_COMPLETED_KEY]);
+  return normalized ? `:${normalized}:` : SLACK_STATUS_ICON_COMPLETED_DEFAULT;
+}

package/src/slack/render-v2.ts

@@ -51,7 +51,7 @@ import {
   splitSlackSectionText,
 } from "./blocks";
 import { buildAskClosure, type ClosureState, closureState } from "./closure";
-import { reactionName, type SlackReactionEvent } from "./reaction-shortcode";
+import { completedStatusIcon, reactionName, type SlackReactionEvent } from "./reaction-shortcode";
 import { getAgentDisplayName, getAgentEmoji } from "./responses";
 import {
   _resetSlackSessionStatusForTests,
@@ -346,7 +346,7 @@ async function taskStateGlyph(
     case "paused":
       return "⏸️";
     case "completed":
-      return "✅";
+      return completedStatusIcon();
     case "failed":
       return "❌";
     case "cancelled":
@@ -496,7 +496,9 @@ function threadHeaderText(tasks: AgentTask[], now: Date, duration: string): stri
   // A parked deferral is stored `completed`, but the ask is not answered yet.
   if (tasks.some((task) => isAwaitingWake(task, tasks))) return `🧵 ⏳ waiting — ${duration}`;
   const hasFailure = tasks.some((task) => task.status === "failed");
-  return hasFailure ? `🧵 ❌ done with failures — ${duration}` : `🧵 ✅ done — ${duration}`;
+  return hasFailure
+    ? `🧵 ❌ done with failures — ${duration}`
+    : `🧵 ${completedStatusIcon()} done — ${duration}`;
 }
 
 export async function renderThreadTree(
@@ -909,7 +911,7 @@ async function outcomeContent(task: AgentTask, slackReplySent: boolean): Promise
     const agentName = task.agentId
       ? ((await getAgentById(task.agentId))?.name ?? "Agent")
       : "Agent";
-    return `✅ ${agentName} completed`;
+    return `${completedStatusIcon()} ${agentName} completed`;
   }
   // A deferral is `completed` in the database but unfinished to a human: the
   // work resumes in a wake-up task. Rendering it ✅ told the thread the ask
@@ -917,7 +919,10 @@ async function outcomeContent(task: AgentTask, slackReplySent: boolean): Promise
   if (isDeferred) {
     return withStatusLead("⏳", outcomeText(slackTaskOutput(task), "Deferred."));
   }
-  return withStatusLead("✅", outcomeText(slackTaskOutput(task), "Task completed."));
+  return withStatusLead(
+    completedStatusIcon(),
+    outcomeText(slackTaskOutput(task), "Task completed."),
+  );
 }
 
 async function agentDisplayNameFor(task: AgentTask): Promise<string> {
@@ -947,7 +952,7 @@ export async function childOutcomeContent(
     );
   }
   if (slackReplySent && !isDeferredTask(task)) {
-    return `↳ ✅ ${agentName} completed`;
+    return `↳ ${completedStatusIcon()} ${agentName} completed`;
   }
   if (isDeferredTask(task)) {
     return withStatusLead(
@@ -956,7 +961,7 @@ export async function childOutcomeContent(
     );
   }
   return withStatusLead(
-    `↳ ✅ ${agentName} — result:`,
+    `↳ ${completedStatusIcon()} ${agentName} — result:`,
     outcomeText(slackTaskOutput(task), "Task completed."),
   );
 }