[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,8 +43,10 @@ import {
   defaultEmojiResolver,
   isJSX,
   Message,
+  parseMarkdown,
   StreamingMarkdownRenderer,
   toModalElement,
+  toPlainText,
 } from "chat";
 import { cardToBlockKit, cardToFallbackText } from "./cards";
 import type { EncryptedTokenData } from "./crypto";
@@ -1983,6 +1986,186 @@ export class SlackAdapter implements Adapter<SlackThreadId, unknown> {
     }
   }
 
+  // ===========================================================================
+  // PostableObject (Plan, etc.) support
+  // ===========================================================================
+
+  async postObject(
+    threadId: string,
+    kind: string,
+    data: unknown
+  ): Promise<RawMessage<unknown>> {
+    if (kind !== "plan") {
+      throw new Error(`Unsupported postable object kind: ${kind}`);
+    }
+
+    const plan = data as PlanModel;
+    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 editObject(
+    threadId: string,
+    messageId: string,
+    kind: string,
+    data: unknown
+  ): Promise<RawMessage<unknown>> {
+    if (kind !== "plan") {
+      throw new Error(`Unsupported postable object kind: ${kind}`);
+    }
+
+    const plan = data as PlanModel;
+    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/channel.ts

@@ -10,6 +10,7 @@ import {
   toPlainText,
 } from "./markdown";
 import { Message } from "./message";
+import { isPostableObject } from "./plan";
 import type {
   Adapter,
   AdapterPostableMessage,
@@ -18,6 +19,7 @@ import type {
   ChannelInfo,
   EphemeralMessage,
   PostableMessage,
+  PostableObject,
   PostEphemeralOptions,
   SentMessage,
   StateAdapter,
@@ -239,9 +241,22 @@ export class ChannelImpl<TState = Record<string, unknown>>
     };
   }
 
+  async post<T extends PostableObject>(message: T): Promise<T>;
+  async post(
+    message:
+      | string
+      | AdapterPostableMessage
+      | AsyncIterable<string>
+      | CardJSXElement
+  ): Promise<SentMessage>;
   async post(
     message: string | PostableMessage | CardJSXElement
-  ): Promise<SentMessage> {
+  ): Promise<SentMessage | PostableObject> {
+    if (isPostableObject(message)) {
+      await this.handlePostableObject(message);
+      return message;
+    }
+
     // Handle AsyncIterable (streaming) — not supported at channel level,
     // fall through to postMessage
     if (isAsyncIterable(message)) {
@@ -268,6 +283,28 @@ export class ChannelImpl<TState = Record<string, unknown>>
     return this.postSingleMessage(postable);
   }
 
+  private async handlePostableObject(obj: PostableObject): Promise<void> {
+    const adapter = this.adapter;
+    if (obj.isSupported(adapter) && adapter.postObject) {
+      const raw = await adapter.postObject(
+        this.id,
+        obj.kind,
+        obj.getPostData()
+      );
+      obj.onPosted({
+        adapter,
+        messageId: raw.id,
+        threadId: raw.threadId ?? this.id,
+      });
+    } else {
+      obj.onPosted({
+        adapter,
+        messageId: `${obj.kind}_${crypto.randomUUID()}`,
+        threadId: this.id,
+      });
+    }
+  }
+
   private async postSingleMessage(
     postable: AdapterPostableMessage
   ): Promise<SentMessage> {

packages/chat/src/index.ts

@@ -11,6 +11,7 @@ export {
   type MessageData,
   type SerializedMessage,
 } from "./message";
+export { isPostableObject, Plan } from "./plan";
 export { StreamingMarkdownRenderer } from "./streaming-markdown";
 export { type SerializedThread, ThreadImpl } from "./thread";
 
@@ -204,6 +205,7 @@ export type {
   ActionHandler,
   Adapter,
   AdapterPostableMessage,
+  AddTaskOptions,
   AppHomeOpenedEvent,
   AppHomeOpenedHandler,
   AssistantContextChangedEvent,
@@ -216,6 +218,7 @@ export type {
   ChannelInfo,
   ChatConfig,
   ChatInstance,
+  CompletePlanOptions,
   CustomEmojiMap,
   Emoji,
   EmojiFormats,
@@ -243,11 +246,18 @@ export type {
   ModalSubmitEvent,
   ModalSubmitHandler,
   ModalUpdateResponse,
+  PlanContent,
+  PlanModel,
+  PlanModelTask,
+  PlanTask,
+  PlanTaskStatus,
   Postable,
   PostableAst,
   PostableCard,
   PostableMarkdown,
   PostableMessage,
+  PostableObject,
+  PostableObjectContext,
   PostableRaw,
   PostEphemeralOptions,
   RawMessage,
@@ -256,12 +266,14 @@ export type {
   SentMessage,
   SlashCommandEvent,
   SlashCommandHandler,
+  StartPlanOptions,
   StateAdapter,
   StreamOptions,
   SubscribedMessageHandler,
   Thread,
   ThreadInfo,
   ThreadSummary,
+  UpdateTaskInput,
   WebhookOptions,
   WellKnownEmoji,
 } from "./types";