@dreki-gg/pi-slack 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @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
+
+- Add `slack_edit_message` tool so the agent can edit messages it previously posted. Pass the `channel` ID and the message `ts` (returned by `slack_post_message`) along with the new `text` to rewrite a message via Slack's `chat.update`. Reuses the existing `chat:write` scope — bots can only edit their own messages.
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -13,6 +13,9 @@ Uses [Effect](https://effect.website) for the Slack client layer (typed errors,
 | `slack_read_thread` | Read replies in a thread |
 | `slack_search` | Full-text search across workspace (requires user token) |
 | `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

@@ -12,6 +12,20 @@ export interface PostMessageResult {
   channel: string;
 }
 
+export interface EditMessageResult {
+  /** Timestamp of the edited message. */
+  ts: string;
+  /** Channel the message lives in. */
+  channel: string;
+}
+
+export interface DeleteMessageResult {
+  /** Timestamp of the deleted message. */
+  ts: string;
+  /** Channel the message lived in. */
+  channel: string;
+}
+
 // ---------------------------------------------------------------------------
 // Effects
 // ---------------------------------------------------------------------------
@@ -41,3 +55,32 @@ export function postMessage(params: {
     } satisfies PostMessageResult;
   });
 }
+
+export function editMessage(params: { channel: string; ts: string; text: string }) {
+  return Effect.gen(function* () {
+    const resp = yield* slackPost<{ ok: true; ts: string; channel: string }>('chat.update', {
+      channel: params.channel,
+      ts: params.ts,
+      text: params.text,
+    });
+
+    return {
+      ts: resp.ts,
+      channel: resp.channel,
+    } 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 } from './client/messages.js';
+import type {
+  PostMessageResult,
+  EditMessageResult,
+  DeleteMessageResult,
+} from './client/messages.js';
 
 // ---------------------------------------------------------------------------
 // Channels
@@ -85,16 +89,19 @@ export function formatSearchResults(result: SearchResult, query: string): string
 // Posting
 // ---------------------------------------------------------------------------
 
-export function formatPostedMessage(
-  result: PostMessageResult,
-  threadTs?: string,
-): string {
-  const where = threadTs
-    ? `thread ${threadTs} in ${result.channel}`
-    : `${result.channel}`;
+export function formatPostedMessage(result: PostMessageResult, threadTs?: string): string {
+  const where = threadTs ? `thread ${threadTs} in ${result.channel}` : `${result.channel}`;
   return `✅ Message posted to ${where} (ts: ${result.ts})`;
 }
 
+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 } from './client/messages.js';
+import { postMessage, editMessage, deleteMessage } from './client/messages.js';
 import {
   formatChannelList,
   formatMessages,
@@ -22,6 +22,8 @@ import {
   formatSearchResults,
   formatDownloadedFile,
   formatPostedMessage,
+  formatEditedMessage,
+  formatDeletedMessage,
 } from './format.js';
 import {
   TOOL_GUIDELINES,
@@ -31,6 +33,8 @@ import {
   searchParams,
   downloadFileParams,
   postMessageParams,
+  editMessageParams,
+  deleteMessageParams,
 } from './tools.js';
 
 // ---------------------------------------------------------------------------
@@ -334,6 +338,90 @@ export default function slackExtension(pi: ExtensionAPI) {
     },
   });
 
+  // -------------------------------------------------------------------------
+  // slack_edit_message
+  // -------------------------------------------------------------------------
+
+  pi.registerTool({
+    name: 'slack_edit_message',
+    label: 'Slack Edit Message',
+    description:
+      'Edit a message the bot previously posted. Requires the bot token to have the `chat:write` scope. Bots can only edit their own messages.',
+    promptSnippet: 'Edit a message the bot previously posted',
+    promptGuidelines: TOOL_GUIDELINES,
+    parameters: editMessageParams,
+
+    async execute(
+      _toolCallId: string,
+      params: {
+        channel: string;
+        ts: string;
+        text: string;
+      },
+    ) {
+      const creds = getCredentials();
+      if (!creds) return missingCredentials('bot');
+
+      try {
+        const result = await runSlack(
+          creds,
+          editMessage({
+            channel: params.channel,
+            ts: params.ts,
+            text: params.text,
+          }),
+        );
+        return textResult(formatEditedMessage(result), {
+          channel: result.channel,
+          ts: result.ts,
+        });
+      } catch (err) {
+        return errorResult(`❌ ${(err as Error).message}`);
+      }
+    },
+  });
+
+  // -------------------------------------------------------------------------
+  // 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

@@ -12,6 +12,8 @@ export const TOOL_GUIDELINES = [
   'Use `slack_search` for full-text search across the workspace. Requires SLACK_USER_TOKEN to be set.',
   '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.',
 ];
@@ -134,3 +136,24 @@ export const postMessageParams = Type.Object({
     }),
   ),
 });
+
+export const editMessageParams = Type.Object({
+  channel: Type.String({
+    description: 'Channel ID (e.g. C0123ABC456) where the message lives.',
+  }),
+  ts: Type.String({
+    description: 'Timestamp of the message to edit (the `ts` returned by slack_post_message).',
+  }),
+  text: Type.String({
+    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.2.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",