@dreki-gg/pi-slack 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @dreki-gg/pi-slack
 
+## [0.5.0](https://github.com/jalbarrang/pi-slack/compare/v0.4.0...v0.5.0) (2026-07-11)
+
+
+### Features
+
+* extract pi-slack from dreki-gg/pi-extensions monorepo ([1e14b33](https://github.com/jalbarrang/pi-slack/commit/1e14b33f8d8dd537d2e4df5d6f1ef78ae45855c1))
+
+## 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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Juan Albarran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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.5.0",
   "description": "Slack read tools for pi — messages, threads, channels, search, and file/image downloads with Effect-powered client",
   "keywords": [
     "pi-package",
@@ -13,8 +13,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/dreki-gg/pi-extensions",
-    "directory": "packages/slack"
+    "url": "git+https://github.com/jalbarrang/pi-slack.git"
   },
   "type": "module",
   "files": [
@@ -44,7 +43,9 @@
     "bun-types": "^1.3.14",
     "oxfmt": "^0.43.0",
     "oxlint": "^1.58.0",
-    "typescript": "^6.0.0"
+    "typescript": "^6.0.0",
+    "@earendil-works/pi-coding-agent": "^0.75.4",
+    "typebox": "^1.0.55"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",