@vellumai/assistant 0.8.5 → 0.8.7

package/src/runtime/routes/settings-routes.ts

@@ -8,6 +8,7 @@ import { basename, join } from "node:path";
 
 import { z } from "zod";
 
+import { setImage } from "../../avatar/avatar-store.js";
 import {
   getPlatformBaseUrl,
   setIngressPublicBaseUrl,
@@ -45,12 +46,13 @@ import {
   ACTIVITY_SKIP_SET,
   injectActivityField,
 } from "../../tools/schema-transforms.js";
-import { generateAndSaveAvatar } from "../../tools/system/avatar-generator.js";
+import { generateAvatarImage } from "../../tools/system/avatar-generator.js";
 import { pathExists } from "../../util/fs.js";
 import { getLogger } from "../../util/logger.js";
 import { getAvatarImagePath, getWorkspaceDir } from "../../util/platform.js";
 import { buildAssistantEvent } from "../assistant-event.js";
 import { assistantEventHub } from "../assistant-event-hub.js";
+import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
 import { publishAvatarChanged } from "../sync/resource-sync-events.js";
 import { BadRequestError, InternalError, NotFoundError } from "./errors.js";
 import type { RouteDefinition, RouteHandlerArgs } from "./types.js";
@@ -90,12 +92,16 @@ async function handleGenerateAvatar({
   log.info({ description }, "Generating avatar via HTTP request");
 
   try {
-    const result = await generateAndSaveAvatar(description);
+    const result = await generateAvatarImage(description);
 
-    if (result.isError) {
+    if (result.isError || !result.pngBuffer) {
       throw new InternalError(result.content);
     }
 
+    // Route through the store so traits sidecars are cleared and the manifest
+    // is recorded as an AI-sourced image atomically.
+    setImage(result.pngBuffer, "ai");
+
     const avatarPath = getAvatarImagePath();
 
     publishAvatarChanged(headers?.["x-vellum-client-id"]?.trim() || undefined);
@@ -638,10 +644,13 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "settings_voice_put",
     endpoint: "settings/voice",
     method: "PUT",
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Update voice activation key",
     description: "Validate and normalize a voice activation key.",
     tags: ["settings"],
-    requirePolicyEnforcement: true,
     requestBody: z.object({
       activationKey: z.string(),
     }),
@@ -651,10 +660,13 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "settings_avatar_generate_post",
     endpoint: "settings/avatar/generate",
     method: "POST",
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Generate avatar",
     description: "Generate an AI avatar image from a text description.",
     tags: ["settings"],
-    requirePolicyEnforcement: true,
     requestBody: z.object({
       description: z.string(),
     }),
@@ -664,10 +676,13 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "settings_client_put",
     endpoint: "settings/client",
     method: "PUT",
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Update client setting",
     description: "Set a single client-side setting key/value pair.",
     tags: ["settings"],
-    requirePolicyEnforcement: true,
     requestBody: z.object({
       key: z.string(),
       value: z.string(),
@@ -678,11 +693,14 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "oauth_start_post",
     endpoint: "oauth/start",
     method: "POST",
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Start OAuth flow",
     description:
       "Initiate an OAuth authorization flow for a third-party service.",
     tags: ["oauth"],
-    requirePolicyEnforcement: true,
     requestBody: z.object({
       service: z.string(),
       requestedScopes: z.array(z.unknown()),
@@ -693,10 +711,13 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "integrations_oauth_start_post",
     endpoint: "integrations/oauth/start",
     method: "POST",
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Start OAuth flow (legacy)",
     description: "Legacy alias for oauth/start.",
     tags: ["oauth"],
-    requirePolicyEnforcement: true,
     requestBody: z.object({
       service: z.string(),
       requestedScopes: z.array(z.unknown()),
@@ -707,20 +728,26 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "workspacefiles_get",
     endpoint: "workspace-files",
     method: "GET",
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "List workspace files",
     description: "Return an array of files in the workspace directory.",
     tags: ["workspace"],
-    requirePolicyEnforcement: true,
     handler: () => handleWorkspaceFilesList(),
   },
   {
     operationId: "workspacefiles_read_get",
     endpoint: "workspace-files/read",
     method: "GET",
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Read a workspace file",
     description: "Return the contents of a single file by path.",
     tags: ["workspace"],
-    requirePolicyEnforcement: true,
     queryParams: [
       {
         name: "path",
@@ -735,22 +762,28 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "tools_get",
     endpoint: "tools",
     method: "GET",
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "List tools",
     description:
       "Return available tool names with their descriptions, risk levels, and categories.",
     tags: ["tools"],
-    requirePolicyEnforcement: true,
     handler: () => handleToolNamesList(),
   },
   {
     operationId: "tools_simulate_permission_post",
     endpoint: "tools/simulate-permission",
     method: "POST",
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Simulate tool permission check",
     description:
       "Dry-run a permission check for a tool invocation without executing it.",
     tags: ["tools"],
-    requirePolicyEnforcement: true,
     requestBody: z.object({
       toolName: z.string(),
       input: z.object({}).passthrough(),
@@ -763,22 +796,27 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "diagnostics_envvars_get",
     endpoint: "diagnostics/env-vars",
     method: "GET",
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "List safe environment variables",
     description:
       "Return environment variable names and values that are safe to expose (no secrets).",
     tags: ["diagnostics"],
-    requirePolicyEnforcement: true,
     handler: () => handleEnvVars(),
   },
   {
     operationId: "config_platform_get",
     endpoint: "config/platform",
     method: "GET",
-    policyKey: "config/platform:GET",
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Get platform config",
     description: "Return the platform base URL configuration.",
     tags: ["config"],
-    requirePolicyEnforcement: true,
     responseBody: z.object({
       baseUrl: z.string(),
       success: z.boolean(),
@@ -789,10 +827,13 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "config_platform_put",
     endpoint: "config/platform",
     method: "PUT",
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Update platform config",
     description: "Set the platform base URL.",
     tags: ["config"],
-    requirePolicyEnforcement: true,
     requestBody: z.object({
       baseUrl: z.string(),
     }),
@@ -802,21 +843,26 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "integrations_ingress_config_get",
     endpoint: "integrations/ingress/config",
     method: "GET",
-    policyKey: "integrations/ingress/config:GET",
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Get ingress config",
     description: "Return the current ingress tunnel configuration.",
     tags: ["config"],
-    requirePolicyEnforcement: true,
     handler: () => getIngressConfigResult(),
   },
   {
     operationId: "integrations_ingress_config_put",
     endpoint: "integrations/ingress/config",
     method: "PUT",
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Update ingress config",
     description: "Set the ingress public base URL and enabled state.",
     tags: ["config"],
-    requirePolicyEnforcement: true,
     requestBody: z.object({
       publicBaseUrl: z.string(),
       enabled: z.boolean(),

package/src/runtime/routes/skills-routes.ts

@@ -26,10 +26,10 @@ import {
   uninstallSkill,
   updateSkill,
 } from "../../daemon/handlers/skills.js";
+import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
 import { BadRequestError, InternalError, NotFoundError } from "./errors.js";
 import type { RouteDefinition, RouteHandlerArgs } from "./types.js";
 
-
 const partnerAuditSchema = z.object({
   risk: z.enum(["safe", "low", "medium", "high", "critical", "unknown"]),
   alerts: z.number().optional(),
@@ -44,6 +44,16 @@ const slimSkillBase = {
   emoji: z.string().optional(),
   kind: z.enum(["bundled", "installed", "catalog"]),
   status: z.enum(["enabled", "disabled", "available"]),
+  category: z.enum([
+    "communication",
+    "productivity",
+    "development",
+    "media",
+    "automation",
+    "webSocial",
+    "knowledge",
+    "integration",
+  ]),
 };
 
 const slimSkillSchema = z.discriminatedUnion("origin", [
@@ -129,8 +139,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "listSkills",
     endpoint: "skills",
     method: "GET",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "List all skills",
     description:
       "Return all installed skills. Pass ?include=catalog to also include available catalog skills. Supports optional filter params: origin, kind, q, category.",
@@ -190,15 +202,13 @@ export const ROUTES: RouteDefinition[] = [
       const hasFilter = !!(origin || kind || q || category);
 
       if (hasFilter || include === "catalog") {
-        const result = await listSkillsFiltered(
-          {
-            ...(origin ? { origin } : {}),
-            ...(kind ? { kind } : {}),
-            ...(q ? { q } : {}),
-            ...(category ? { category } : {}),
-            includeCatalog: include === "catalog",
-          },
-        );
+        const result = await listSkillsFiltered({
+          ...(origin ? { origin } : {}),
+          ...(kind ? { kind } : {}),
+          ...(q ? { q } : {}),
+          ...(category ? { category } : {}),
+          includeCatalog: include === "catalog",
+        });
         return {
           skills: result.skills,
           categoryCounts: result.categoryCounts,
@@ -214,8 +224,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "getSkillFileContent",
     endpoint: "skills/:id/files/content",
     method: "GET",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Get skill file content",
     description:
       "Return the content of a single file belonging to an installed or catalog skill.",
@@ -254,11 +266,28 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "getSkillFiles",
     endpoint: "skills/:id/files",
     method: "GET",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Get skill files",
     description: "Return skill metadata and directory contents.",
     tags: ["skills"],
+    responseBody: z.object({
+      skill: slimSkillSchema.describe("Skill metadata"),
+      files: z
+        .array(
+          z.object({
+            path: z.string(),
+            name: z.string(),
+            size: z.number().int(),
+            mimeType: z.string(),
+            isBinary: z.boolean(),
+            content: z.string().nullable(),
+          }),
+        )
+        .describe("Directory contents"),
+    }),
     handler: async ({ pathParams }: RouteHandlerArgs) => {
       const result = await getSkillFiles(pathParams!.id);
       if ("error" in result) {
@@ -272,8 +301,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "enableSkill",
     endpoint: "skills/:id/enable",
     method: "POST",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Enable skill",
     description: "Enable an installed skill.",
     tags: ["skills"],
@@ -288,8 +319,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "disableSkill",
     endpoint: "skills/:id/disable",
     method: "POST",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Disable skill",
     description: "Disable an installed skill.",
     tags: ["skills"],
@@ -304,8 +337,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "configureSkill",
     endpoint: "skills/:id/config",
     method: "PATCH",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Configure skill",
     description: "Update skill configuration (env, apiKey, config).",
     tags: ["skills"],
@@ -316,14 +351,11 @@ export const ROUTES: RouteDefinition[] = [
     }),
     responseBody: z.object({ ok: z.boolean() }),
     handler: ({ pathParams, body = {} }: RouteHandlerArgs) => {
-      const result = configureSkill(
-        pathParams!.id,
-        {
-          env: body.env as Record<string, string> | undefined,
-          apiKey: body.apiKey as string | undefined,
-          config: body.config as Record<string, unknown> | undefined,
-        },
-      );
+      const result = configureSkill(pathParams!.id, {
+        env: body.env as Record<string, string> | undefined,
+        apiKey: body.apiKey as string | undefined,
+        config: body.config as Record<string, unknown> | undefined,
+      });
       if (!result.success) throw new InternalError(result.error);
       return { ok: true };
     },
@@ -332,8 +364,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "checkSkillUpdates",
     endpoint: "skills/check-updates",
     method: "POST",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Check skill updates",
     description: "Check for available updates to installed skills.",
     tags: ["skills"],
@@ -350,8 +384,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "searchSkills",
     endpoint: "skills/search",
     method: "GET",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Search skill catalog",
     description: "Search the skill catalog by query string.",
     tags: ["skills"],
@@ -376,7 +412,9 @@ export const ROUTES: RouteDefinition[] = [
       const query = queryParams.q ?? "";
       if (!query) throw new BadRequestError("q query parameter is required");
       const limitRaw = queryParams.limit;
-      const limit = limitRaw ? Math.max(1, Number.parseInt(limitRaw, 10) || 25) : 25;
+      const limit = limitRaw
+        ? Math.max(1, Number.parseInt(limitRaw, 10) || 25)
+        : 25;
       const result = await searchSkills(query, limit);
       if (!result.success) throw new InternalError(result.error);
       return { skills: result.skills };
@@ -386,8 +424,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "draftSkill",
     endpoint: "skills/draft",
     method: "POST",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Draft a skill",
     description: "Generate a skill draft from source text.",
     tags: ["skills"],
@@ -410,8 +450,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "updateSkill",
     endpoint: "skills/:id/update",
     method: "POST",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Update skill",
     description: "Update an installed skill to the latest version.",
     tags: ["skills"],
@@ -426,8 +468,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "inspectSkill",
     endpoint: "skills/:id/inspect",
     method: "GET",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Inspect skill",
     description: "Return detailed skill information.",
     tags: ["skills"],
@@ -453,8 +497,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "getSkill",
     endpoint: "skills/:id",
     method: "GET",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Get skill",
     description: "Return a single skill by ID with enriched detail fields.",
     tags: ["skills"],
@@ -474,8 +520,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "deleteSkill",
     endpoint: "skills/:id",
     method: "DELETE",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Uninstall skill",
     description: "Remove an installed skill.",
     tags: ["skills"],
@@ -490,8 +538,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "installSkill",
     endpoint: "skills/install",
     method: "POST",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Install skill",
     description: "Install a skill by slug, URL, or spec.",
     tags: ["skills"],
@@ -506,8 +556,18 @@ export const ROUTES: RouteDefinition[] = [
         .describe(
           "Which registry to install from. When omitted, the install flow auto-detects based on slug format.",
         ),
-      overwrite: z.boolean().optional().describe("Replace an existing install. Defaults to true for back-compat with the legacy in-process API."),
-      catalogOnly: z.boolean().optional().describe("When true, restrict to bundled and Vellum catalog skills only — do not fall through to community registries."),
+      overwrite: z
+        .boolean()
+        .optional()
+        .describe(
+          "Replace an existing install. Defaults to true for back-compat with the legacy in-process API.",
+        ),
+      catalogOnly: z
+        .boolean()
+        .optional()
+        .describe(
+          "When true, restrict to bundled and Vellum catalog skills only — do not fall through to community registries.",
+        ),
     }),
     responseBody: z.object({
       ok: z.boolean(),
@@ -515,21 +575,17 @@ export const ROUTES: RouteDefinition[] = [
     }),
     handler: async ({ body = {} }: RouteHandlerArgs) => {
       const slug =
-        (body.slug as string) ??
-        (body.url as string) ??
-        (body.spec as string);
+        (body.slug as string) ?? (body.url as string) ?? (body.spec as string);
       if (!slug || typeof slug !== "string") {
         throw new BadRequestError("slug, url, or spec is required");
       }
-      const result = await installSkill(
-        {
-          slug,
-          version: body.version as string | undefined,
-          origin: body.origin as "clawhub" | "skillssh" | undefined,
-          catalogOnly: body.catalogOnly as boolean | undefined,
-          overwrite: body.overwrite as boolean | undefined,
-        },
-      );
+      const result = await installSkill({
+        slug,
+        version: body.version as string | undefined,
+        origin: body.origin as "clawhub" | "skillssh" | undefined,
+        catalogOnly: body.catalogOnly as boolean | undefined,
+        overwrite: body.overwrite as boolean | undefined,
+      });
       if (!result.success) throw new InternalError(result.error);
       return { ok: true, skillId: result.skillId };
     },
@@ -538,8 +594,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "createSkill",
     endpoint: "skills",
     method: "POST",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.write"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Create skill",
     description: "Create a new skill.",
     tags: ["skills"],
@@ -561,9 +619,12 @@ export const ROUTES: RouteDefinition[] = [
           "skillId, name, description, and bodyMarkdown are required",
         );
       }
-      const result = await createSkill(
-        { skillId, name, description, bodyMarkdown },
-      );
+      const result = await createSkill({
+        skillId,
+        name,
+        description,
+        bodyMarkdown,
+      });
       if (!result.success) throw new InternalError(result.error);
       return { ok: true };
     },
@@ -572,10 +633,13 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "skillsLocalInspect",
     endpoint: "skills/:id/local-inspect",
     method: "GET",
-    policyKey: "skills",
-    requirePolicyEnforcement: true,
+    policy: {
+      requiredScopes: ["settings.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     summary: "Local skill inspect",
-    description: "Return full local detail for an installed or bundled skill, including featureFlag, toolManifest, installMeta, configEntry, and directoryPath.",
+    description:
+      "Return full local detail for an installed or bundled skill, including featureFlag, toolManifest, installMeta, configEntry, and directoryPath.",
     tags: ["skills"],
     handler: ({ pathParams }: RouteHandlerArgs) => {
       const result = getSkillLocalDetail(pathParams!.id);

package/src/runtime/routes/slack-channel-routes.ts

@@ -12,6 +12,7 @@ import {
   getSlackConversationInfo,
   SlackApiError,
 } from "../../messaging/providers/slack/api.js";
+import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
 import { publishSyncInvalidation } from "../sync/sync-publisher.js";
 import { NotFoundError } from "./errors.js";
 import type { RouteDefinition, RouteHandlerArgs } from "./types.js";
@@ -171,6 +172,10 @@ export const ROUTES: RouteDefinition[] = [
     operationId: "slack_channel_name_resolve",
     endpoint: "conversations/:conversationId/slack-channel/resolve",
     method: "POST",
+    policy: {
+      requiredScopes: ["chat.read"],
+      allowedPrincipalTypes: ACTOR_PRINCIPALS,
+    },
     handler: handleSlackChannelNameResolve,
     summary: "Resolve Slack channel name",
     description: