@dreki-gg/pi-slack 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @dreki-gg/pi-slack
 
+## 0.4.0
+
+### Minor Changes
+
+- Add a `slack_delete_message` tool that deletes a message the bot previously
+  posted via Slack's `chat.delete` API. Pass the channel ID and the message `ts`;
+  bots can only delete their own messages. No new scope is required — it uses the
+  existing `chat:write` permission.
+
 ## 0.3.0
 
 ### Minor Changes

package/README.md

@@ -15,6 +15,7 @@ Uses [Effect](https://effect.website) for the Slack client layer (typed errors,
 | `slack_download_file` | Download a shared file/image to temp directory |
 | `slack_post_message` | Post a message to a channel or reply in a thread (requires `chat:write`) |
 | `slack_edit_message` | Edit a message the bot previously posted (requires `chat:write`) |
+| `slack_delete_message` | Delete a message the bot previously posted (requires `chat:write`) |
 
 ## Setup
 

package/extensions/slack/client/messages.ts

@@ -19,6 +19,13 @@ export interface EditMessageResult {
   channel: string;
 }
 
+export interface DeleteMessageResult {
+  /** Timestamp of the deleted message. */
+  ts: string;
+  /** Channel the message lived in. */
+  channel: string;
+}
+
 // ---------------------------------------------------------------------------
 // Effects
 // ---------------------------------------------------------------------------
@@ -63,3 +70,17 @@ export function editMessage(params: { channel: string; ts: string; text: string
     } satisfies EditMessageResult;
   });
 }
+
+export function deleteMessage(params: { channel: string; ts: string }) {
+  return Effect.gen(function* () {
+    const resp = yield* slackPost<{ ok: true; ts: string; channel: string }>('chat.delete', {
+      channel: params.channel,
+      ts: params.ts,
+    });
+
+    return {
+      ts: resp.ts,
+      channel: resp.channel,
+    } satisfies DeleteMessageResult;
+  });
+}

package/extensions/slack/format.ts

@@ -1,7 +1,11 @@
 import type { SlackChannel, SlackMessage, ReadMessagesResult } from './client/channels.js';
 import type { SearchResult } from './client/search.js';
 import type { DownloadedFile, SlackFileInfo } from './client/files.js';
-import type { PostMessageResult, EditMessageResult } from './client/messages.js';
+import type {
+  PostMessageResult,
+  EditMessageResult,
+  DeleteMessageResult,
+} from './client/messages.js';
 
 // ---------------------------------------------------------------------------
 // Channels
@@ -94,6 +98,10 @@ export function formatEditedMessage(result: EditMessageResult): string {
   return `✏️ Message edited in ${result.channel} (ts: ${result.ts})`;
 }
 
+export function formatDeletedMessage(result: DeleteMessageResult): string {
+  return `🗑️ Message deleted in ${result.channel} (ts: ${result.ts})`;
+}
+
 // ---------------------------------------------------------------------------
 // Files
 // ---------------------------------------------------------------------------

package/extensions/slack/index.ts

@@ -14,7 +14,7 @@ import { listChannels } from './client/channels.js';
 import { readMessages, readThread } from './client/channels.js';
 import { searchMessages } from './client/search.js';
 import { downloadFile } from './client/files.js';
-import { postMessage, editMessage } from './client/messages.js';
+import { postMessage, editMessage, deleteMessage } from './client/messages.js';
 import {
   formatChannelList,
   formatMessages,
@@ -23,6 +23,7 @@ import {
   formatDownloadedFile,
   formatPostedMessage,
   formatEditedMessage,
+  formatDeletedMessage,
 } from './format.js';
 import {
   TOOL_GUIDELINES,
@@ -33,6 +34,7 @@ import {
   downloadFileParams,
   postMessageParams,
   editMessageParams,
+  deleteMessageParams,
 } from './tools.js';
 
 // ---------------------------------------------------------------------------
@@ -379,6 +381,47 @@ export default function slackExtension(pi: ExtensionAPI) {
     },
   });
 
+  // -------------------------------------------------------------------------
+  // slack_delete_message
+  // -------------------------------------------------------------------------
+
+  pi.registerTool({
+    name: 'slack_delete_message',
+    label: 'Slack Delete Message',
+    description:
+      'Delete a message the bot previously posted. Requires the bot token to have the `chat:write` scope. Bots can only delete their own messages.',
+    promptSnippet: 'Delete a message the bot previously posted',
+    promptGuidelines: TOOL_GUIDELINES,
+    parameters: deleteMessageParams,
+
+    async execute(
+      _toolCallId: string,
+      params: {
+        channel: string;
+        ts: string;
+      },
+    ) {
+      const creds = getCredentials();
+      if (!creds) return missingCredentials('bot');
+
+      try {
+        const result = await runSlack(
+          creds,
+          deleteMessage({
+            channel: params.channel,
+            ts: params.ts,
+          }),
+        );
+        return textResult(formatDeletedMessage(result), {
+          channel: result.channel,
+          ts: result.ts,
+        });
+      } catch (err) {
+        return errorResult(`❌ ${(err as Error).message}`);
+      }
+    },
+  });
+
   // -------------------------------------------------------------------------
   // /slack command — status check
   // -------------------------------------------------------------------------

package/extensions/slack/tools.ts

@@ -13,6 +13,7 @@ export const TOOL_GUIDELINES = [
   'Use `slack_download_file` to download images or files shared in Slack. The tool saves files to a temp directory and returns the path — use `read` to view images.',
   'Use `slack_post_message` to send a message to a channel or reply in a thread. The bot token must have the `chat:write` scope and the bot must be a member of the target channel.',
   'Use `slack_edit_message` to edit a message the bot previously posted. Pass the channel ID and the message `ts` (returned by `slack_post_message`). Bots can only edit their own messages.',
+  'Use `slack_delete_message` to delete a message the bot previously posted. Pass the channel ID and the message `ts`. Bots can only delete their own messages.',
   'When messages reference files or images (shown with 📎), download them with `slack_download_file` using the file ID to get visual context.',
   'Channel IDs look like C0123ABC456. Thread timestamps look like 1512085950.000216.',
 ];
@@ -147,3 +148,12 @@ export const editMessageParams = Type.Object({
     description: 'New message text. Supports Slack mrkdwn formatting.',
   }),
 });
+
+export const deleteMessageParams = Type.Object({
+  channel: Type.String({
+    description: 'Channel ID (e.g. C0123ABC456) where the message lives.',
+  }),
+  ts: Type.String({
+    description: 'Timestamp of the message to delete (the `ts` returned by slack_post_message).',
+  }),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreki-gg/pi-slack",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Slack read tools for pi — messages, threads, channels, search, and file/image downloads with Effect-powered client",
   "keywords": [
     "pi-package",