@dreki-gg/pi-slack 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @dreki-gg/pi-slack
+
+## 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
+
+- Add `slack_post_message` tool to post messages to a channel or reply in a thread. Posting is gated by the Slack app's `chat:write` OAuth scope (the bot must also be a member of the target channel); scope/permission errors from Slack are surfaced clearly.

package/README.md

@@ -13,6 +13,8 @@ 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`) |
 
 ## Setup
 

package/extensions/slack/client/http.ts

@@ -1,4 +1,4 @@
-import { FetchHttpClient, HttpClient } from '@effect/platform';
+import { FetchHttpClient, HttpClient, HttpClientRequest } from '@effect/platform';
 import { Context, Effect, Layer, Schedule } from 'effect';
 import type { SlackCredentials } from '../config.js';
 import { SlackApiError, SlackAuthError, SlackRateLimitError } from './errors.js';
@@ -84,6 +84,56 @@ export function slackGet<T extends SlackOkResponse>(
   );
 }
 
+/**
+ * Make a POST request to a Slack Web API method with a JSON body.
+ * Handles auth injection, rate limiting (with retry), and error mapping.
+ */
+export function slackPost<T extends SlackOkResponse>(
+  method: string,
+  body: Record<string, unknown>,
+  options?: { useUserToken?: boolean },
+) {
+  return Effect.scoped(
+    Effect.gen(function* () {
+      const config = yield* SlackConfig;
+      const client = yield* HttpClient.HttpClient;
+
+      const token = options?.useUserToken ? config.userToken : config.botToken;
+      if (!token) {
+        return yield* new SlackAuthError({
+          reason: options?.useUserToken
+            ? 'SLACK_USER_TOKEN is required for this operation but not set'
+            : 'SLACK_BOT_TOKEN is required but not set',
+        });
+      }
+
+      const request = HttpClientRequest.post(`${SLACK_BASE_URL}/${method}`).pipe(
+        HttpClientRequest.setHeaders({ Authorization: `Bearer ${token}` }),
+        HttpClientRequest.bodyUnsafeJson(body),
+      );
+
+      const response = yield* client.execute(request);
+
+      // Handle rate limiting
+      if (response.status === 429) {
+        const retryAfter = Number(response.headers['retry-after']) || undefined;
+        return yield* new SlackRateLimitError({ method, retryAfter });
+      }
+
+      const json = (yield* response.json) as SlackResponse;
+
+      if (!json.ok) {
+        return yield* new SlackApiError({
+          method,
+          code: (json as SlackErrorResponse).error,
+        });
+      }
+
+      return json as T;
+    }),
+  );
+}
+
 /**
  * Download a file from Slack using bot token authentication.
  * Returns the raw ArrayBuffer.

package/extensions/slack/client/messages.ts

@@ -0,0 +1,65 @@
+import { Effect } from 'effect';
+import { slackPost } from './http.js';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface PostMessageResult {
+  /** Timestamp of the posted message (also used as thread_ts for replies). */
+  ts: string;
+  /** Channel the message was posted to. */
+  channel: string;
+}
+
+export interface EditMessageResult {
+  /** Timestamp of the edited message. */
+  ts: string;
+  /** Channel the message lives in. */
+  channel: string;
+}
+
+// ---------------------------------------------------------------------------
+// Effects
+// ---------------------------------------------------------------------------
+
+export function postMessage(params: {
+  channel: string;
+  text: string;
+  threadTs?: string;
+  replyBroadcast?: boolean;
+}) {
+  return Effect.gen(function* () {
+    const body: Record<string, unknown> = {
+      channel: params.channel,
+      text: params.text,
+    };
+    if (params.threadTs !== undefined) body.thread_ts = params.threadTs;
+    if (params.replyBroadcast !== undefined) body.reply_broadcast = params.replyBroadcast;
+
+    const resp = yield* slackPost<{ ok: true; ts: string; channel: string }>(
+      'chat.postMessage',
+      body,
+    );
+
+    return {
+      ts: resp.ts,
+      channel: resp.channel,
+    } 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;
+  });
+}

package/extensions/slack/format.ts

@@ -1,6 +1,7 @@
 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';
 
 // ---------------------------------------------------------------------------
 // Channels
@@ -80,6 +81,19 @@ export function formatSearchResults(result: SearchResult, query: string): string
   return `${header}\n\n${matches.join('\n\n')}`;
 }
 
+// ---------------------------------------------------------------------------
+// Posting
+// ---------------------------------------------------------------------------
+
+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})`;
+}
+
 // ---------------------------------------------------------------------------
 // Files
 // ---------------------------------------------------------------------------

package/extensions/slack/index.ts

@@ -14,12 +14,15 @@ 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 {
   formatChannelList,
   formatMessages,
   formatThread,
   formatSearchResults,
   formatDownloadedFile,
+  formatPostedMessage,
+  formatEditedMessage,
 } from './format.js';
 import {
   TOOL_GUIDELINES,
@@ -28,6 +31,8 @@ import {
   readThreadParams,
   searchParams,
   downloadFileParams,
+  postMessageParams,
+  editMessageParams,
 } from './tools.js';
 
 // ---------------------------------------------------------------------------
@@ -286,6 +291,94 @@ export default function slackExtension(pi: ExtensionAPI) {
     },
   });
 
+  // -------------------------------------------------------------------------
+  // slack_post_message
+  // -------------------------------------------------------------------------
+
+  pi.registerTool({
+    name: 'slack_post_message',
+    label: 'Slack Post Message',
+    description:
+      'Post a message to a Slack channel or reply in a thread. Requires the bot token to have the `chat:write` scope and the bot to be a member of the channel.',
+    promptSnippet: 'Post a message to a Slack channel or thread',
+    promptGuidelines: TOOL_GUIDELINES,
+    parameters: postMessageParams,
+
+    async execute(
+      _toolCallId: string,
+      params: {
+        channel: string;
+        text: string;
+        thread_ts?: string;
+        reply_broadcast?: boolean;
+      },
+    ) {
+      const creds = getCredentials();
+      if (!creds) return missingCredentials('bot');
+
+      try {
+        const result = await runSlack(
+          creds,
+          postMessage({
+            channel: params.channel,
+            text: params.text,
+            threadTs: params.thread_ts,
+            replyBroadcast: params.reply_broadcast,
+          }),
+        );
+        return textResult(formatPostedMessage(result, params.thread_ts), {
+          channel: result.channel,
+          ts: result.ts,
+        });
+      } catch (err) {
+        return errorResult(`❌ ${(err as Error).message}`);
+      }
+    },
+  });
+
+  // -------------------------------------------------------------------------
+  // 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 command — status check
   // -------------------------------------------------------------------------

package/extensions/slack/tools.ts

@@ -11,6 +11,8 @@ export const TOOL_GUIDELINES = [
   'Use `slack_read_thread` to read all replies in a thread. You need both the channel ID and the thread timestamp (thread_ts).',
   '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.',
   '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.',
 ];
@@ -113,3 +115,35 @@ export const downloadFileParams = Type.Object({
     description: 'Slack file ID to download (e.g. F0123ABC456).',
   }),
 });
+
+export const postMessageParams = Type.Object({
+  channel: Type.String({
+    description: 'Channel ID (e.g. C0123ABC456) or #channel-name to post to.',
+  }),
+  text: Type.String({
+    description: 'Message text. Supports Slack mrkdwn formatting.',
+  }),
+  thread_ts: Type.Optional(
+    Type.String({
+      description: 'Reply within this thread (the parent message ts).',
+    }),
+  ),
+  reply_broadcast: Type.Optional(
+    Type.Boolean({
+      description:
+        'When replying in a thread, also broadcast the reply to the channel. Default false.',
+    }),
+  ),
+});
+
+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.',
+  }),
+});

package/package.json

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