[chat] adding plan/update plan blocks for threads

packages/adapter-slack/src/index.ts

@@ -27,6 +27,7 @@ import type {
   Logger,
   ModalElement,
   ModalResponse,
+  PlanModel,
   RawMessage,
   ReactionEvent,
   StreamOptions,
@@ -42,7 +43,9 @@ import {
   defaultEmojiResolver,
   isJSX,
   Message,
+  parseMarkdown,
   toModalElement,
+  toPlainText,
 } from "chat";
 import { cardToBlockKit, cardToFallbackText } from "./cards";
 import type { EncryptedTokenData } from "./crypto";
@@ -1987,6 +1990,174 @@ export class SlackAdapter implements Adapter<SlackThreadId, unknown> {
     }
   }
 
+  // ===========================================================================
+  // Plan/Task blocks
+  // ===========================================================================
+
+  async postPlan(
+    threadId: string,
+    plan: PlanModel
+  ): Promise<RawMessage<unknown>> {
+    const { channel, threadTs } = this.decodeThreadId(threadId);
+    const text = this.renderPlanFallbackText(plan);
+    const blocks = this.planToBlockKit(plan);
+
+    try {
+      this.logger.debug("Slack API: chat.postMessage (plan)", {
+        channel,
+        threadTs,
+        blockCount: blocks.length,
+      });
+      const result = await this.client.chat.postMessage(
+        this.withToken({
+          channel,
+          thread_ts: threadTs,
+          text,
+          // biome-ignore lint/suspicious/noExplicitAny: Block Kit blocks are platform-specific
+          blocks: blocks as any[],
+          unfurl_links: false,
+          unfurl_media: false,
+        })
+      );
+      return { id: result.ts as string, threadId, raw: result };
+    } catch (error) {
+      this.handleSlackError(error);
+    }
+  }
+
+  async editPlan(
+    threadId: string,
+    messageId: string,
+    plan: PlanModel
+  ): Promise<RawMessage<unknown>> {
+    const { channel } = this.decodeThreadId(threadId);
+    const text = this.renderPlanFallbackText(plan);
+    const blocks = this.planToBlockKit(plan);
+
+    try {
+      this.logger.debug("Slack API: chat.update (plan)", {
+        channel,
+        messageId,
+        blockCount: blocks.length,
+      });
+      const result = await this.client.chat.update(
+        this.withToken({
+          channel,
+          ts: messageId,
+          text,
+          // biome-ignore lint/suspicious/noExplicitAny: Block Kit blocks are platform-specific
+          blocks: blocks as any[],
+        })
+      );
+
+      return { id: result.ts as string, threadId, raw: result };
+    } catch (error) {
+      this.handleSlackError(error);
+    }
+  }
+
+  private renderPlanFallbackText(plan: PlanModel): string {
+    const lines: string[] = [];
+    lines.push(plan.title || "Plan");
+    for (const task of plan.tasks) {
+      lines.push(`- (${task.status}) ${task.title}`);
+    }
+    return lines.join("\n");
+  }
+
+  private planToBlockKit(plan: PlanModel): unknown[] {
+    const tasks = plan.tasks.map((task: PlanModel["tasks"][number]) => {
+      const details = this.planContentToRichText(task.details);
+      const output = this.planContentToRichText(task.output);
+      return {
+        type: "task_card",
+        task_id: task.id,
+        title: task.title,
+        status: task.status,
+        ...(details ? { details } : null),
+        ...(output ? { output } : null),
+      };
+    });
+    return [
+      {
+        type: "plan",
+        title: plan.title || "Plan",
+        tasks,
+      },
+    ];
+  }
+
+  private planContentToPlainText(content: unknown): string {
+    if (!content) {
+      return "";
+    }
+    if (Array.isArray(content)) {
+      return content.join("\n");
+    }
+    if (typeof content === "string") {
+      return content;
+    }
+    if (
+      typeof content === "object" &&
+      content !== null &&
+      "markdown" in content
+    ) {
+      const markdown = (content as { markdown?: string }).markdown;
+      if (markdown) {
+        return toPlainText(parseMarkdown(markdown));
+      }
+      return "";
+    }
+    if (typeof content === "object" && content !== null && "ast" in content) {
+      const ast = (content as { ast?: unknown }).ast;
+      if (ast) {
+        return toPlainText(ast as Parameters<typeof toPlainText>[0]);
+      }
+      return "";
+    }
+    return "";
+  }
+
+  private planContentToRichText(
+    content: unknown
+  ): { type: "rich_text"; elements: unknown[] } | undefined {
+    if (!content) {
+      return undefined;
+    }
+    if (Array.isArray(content)) {
+      return {
+        type: "rich_text",
+        elements: [
+          {
+            type: "rich_text_list",
+            style: "bullet",
+            elements: content.map((item) => ({
+              type: "rich_text_section",
+              elements: [{ type: "text", text: String(item) }],
+            })),
+          },
+        ],
+      };
+    }
+    const text = this.planContentToPlainText(content);
+    if (!text) {
+      return undefined;
+    }
+    return {
+      type: "rich_text",
+      elements: [
+        {
+          type: "rich_text_section",
+          elements: [{ type: "text", text }],
+        },
+      ],
+    };
+  }
+
+  // ===========================================================================
+  // Message deletion and reactions
+  // ===========================================================================
+
   async deleteMessage(threadId: string, messageId: string): Promise<void> {
     const ephemeral = this.decodeEphemeralMessageId(messageId);
     if (ephemeral) {

packages/chat/src/index.ts

@@ -188,6 +188,7 @@ export type {
   ActionHandler,
   Adapter,
   AdapterPostableMessage,
+  AddTaskOptions,
   AppHomeOpenedEvent,
   AppHomeOpenedHandler,
   AssistantContextChangedEvent,
@@ -200,6 +201,7 @@ export type {
   ChannelInfo,
   ChatConfig,
   ChatInstance,
+  CompletePlanOptions,
   CustomEmojiMap,
   Emoji,
   EmojiFormats,
@@ -227,6 +229,12 @@ export type {
   ModalSubmitEvent,
   ModalSubmitHandler,
   ModalUpdateResponse,
+  PlanContent,
+  PlanMessage,
+  PlanModel,
+  PlanModelTask,
+  PlanTask,
+  PlanTaskStatus,
   Postable,
   PostableAst,
   PostableCard,
@@ -240,12 +248,14 @@ export type {
   SentMessage,
   SlashCommandEvent,
   SlashCommandHandler,
+  StartPlanOptions,
   StateAdapter,
   StreamOptions,
   SubscribedMessageHandler,
   Thread,
   ThreadInfo,
   ThreadSummary,
+  UpdateTaskInput,
   WebhookOptions,
   WellKnownEmoji,
 } from "./types";