botinabox 2.7.11 → 2.8.0

package/dist/channel-DziSPayj.d.ts

@@ -0,0 +1,73 @@
+/** Channel adapter types — Story 1.5 / 4.1 */
+type ChatType = "direct" | "group" | "channel";
+type FormattingMode = "markdown" | "mrkdwn" | "html" | "plain";
+interface ChannelCapabilities {
+    chatTypes: ChatType[];
+    threads: boolean;
+    reactions: boolean;
+    editing: boolean;
+    media: boolean;
+    polls: boolean;
+    maxTextLength: number;
+    formattingMode: FormattingMode;
+}
+interface ChannelMeta {
+    displayName: string;
+    icon?: string;
+    homepage?: string;
+}
+interface InboundMessage {
+    id: string;
+    channel: string;
+    account?: string;
+    from: string;
+    userId?: string;
+    body: string;
+    threadId?: string;
+    replyToId?: string;
+    attachments?: Attachment[];
+    receivedAt: string;
+    raw?: unknown;
+}
+type AttachmentMediaType = "image" | "video" | "audio" | "pdf" | "doc" | "excel" | "presentation" | "html" | "link" | "misc";
+interface Attachment {
+    type: AttachmentMediaType;
+    url?: string;
+    mimeType?: string;
+    filename?: string;
+    size?: number;
+}
+interface OutboundPayload {
+    text: string;
+    threadId?: string;
+    replyToId?: string;
+    attachments?: Attachment[];
+}
+interface SendResult {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+}
+interface HealthStatus {
+    ok: boolean;
+    latencyMs?: number;
+    error?: string;
+}
+type ChannelConfig = Record<string, unknown>;
+interface ChannelAdapter {
+    /** Unique identifier for this adapter instance */
+    id: string;
+    meta: ChannelMeta;
+    capabilities: ChannelCapabilities;
+    connect(config: ChannelConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<HealthStatus>;
+    send(target: {
+        peerId: string;
+        threadId?: string;
+    }, payload: OutboundPayload): Promise<SendResult>;
+    /** Called when a message arrives — set by the framework */
+    onMessage?: (message: InboundMessage) => Promise<void>;
+}
+
+export type { Attachment as A, ChannelAdapter as C, FormattingMode as F, HealthStatus as H, InboundMessage as I, OutboundPayload as O, SendResult as S, AttachmentMediaType as a, ChannelCapabilities as b, ChannelConfig as c, ChannelMeta as d, ChatType as e };

package/dist/channels/discord/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ChannelAdapter, c as ChannelMeta, a as ChannelCapabilities, I as InboundMessage, b as ChannelConfig, H as HealthStatus, O as OutboundPayload, S as SendResult } from '../../channel-06G0vbIn.js';
+import { C as ChannelAdapter, d as ChannelMeta, b as ChannelCapabilities, I as InboundMessage, c as ChannelConfig, H as HealthStatus, O as OutboundPayload, S as SendResult } from '../../channel-DziSPayj.js';
 
 /**
  * DiscordAdapter — ChannelAdapter implementation for Discord.

package/dist/channels/slack/index.d.ts

@@ -1,7 +1,7 @@
-import { C as ChannelAdapter, c as ChannelMeta, a as ChannelCapabilities, I as InboundMessage, b as ChannelConfig, H as HealthStatus, O as OutboundPayload, S as SendResult } from '../../channel-06G0vbIn.js';
-import { H as HookBus, c as ChatPipeline } from '../../chat-pipeline-DuNX5WoL.js';
+import { C as ChannelAdapter, d as ChannelMeta, b as ChannelCapabilities, I as InboundMessage, c as ChannelConfig, H as HealthStatus, O as OutboundPayload, S as SendResult, A as Attachment, a as AttachmentMediaType } from '../../channel-DziSPayj.js';
+import { H as HookBus, c as ChatPipeline } from '../../chat-pipeline-BGgmH_ap.js';
 import 'better-sqlite3';
-import '../../provider-DLGUfnNx.js';
+import '../../provider-BHkqkSdq.js';
 
 /**
  * SlackAdapter — ChannelAdapter implementation for Slack.
@@ -162,6 +162,27 @@ interface SlackConfig {
     signingSecret?: string;
 }
 
+/**
+ * An AttachmentEnricher downloads an attachment and extracts its textual content.
+ *
+ * Returns the extracted text on success, or `null` on failure. The framework
+ * surfaces the filename/URL as a fallback when the enricher returns null.
+ *
+ * @param attachment - The attachment metadata (type, url, filename, etc.)
+ * @param botToken - Slack bot token, required for authenticated downloads from url_private
+ */
+type AttachmentEnricher = (attachment: Attachment, botToken: string) => Promise<string | null>;
+/**
+ * A map from attachment type to the enricher that handles it.
+ * Types without an entry fall through to the framework's default behavior
+ * (surfacing filename + URL in the message body).
+ */
+type AttachmentEnricherMap = Partial<Record<AttachmentMediaType, AttachmentEnricher>>;
+/** Internal: the result of running enrichAttachments on a message. */
+interface EnrichedMessage extends InboundMessage {
+    body: string;
+}
+
 /**
  * SlackBoltAdapter — real Bolt Socket Mode integration for botinabox.
  *
@@ -181,6 +202,8 @@ interface SlackBoltAdapterConfig {
     appToken: string;
     hooks: HookBus;
     pipeline: ChatPipeline;
+    /** Optional per-type attachment enrichers. */
+    attachmentEnrichers?: AttachmentEnricherMap;
 }
 declare class SlackBoltAdapter {
     private app;
@@ -190,4 +213,52 @@ declare class SlackBoltAdapter {
     stop(): Promise<void>;
 }
 
-export { type BoltClient, SlackAdapter, SlackBoltAdapter, type SlackBoltAdapterConfig, type SlackConfig, type SlackEvent, type SlackFile, type TranscribeOptions, type TranscribeResult, createSlackAdapter as default, downloadAudio, enrichVoiceMessage, extractVoiceTranscript, formatForSlack, parseSlackEvent, transcribeAudio };
+/**
+ * Run enrichers over each attachment on an InboundMessage and append extracted
+ * content to the message body.
+ *
+ * Enrichers are run sequentially. If an enricher throws or returns null, the
+ * attachment is surfaced as `[Attached: <filename>]` with no content — the
+ * LLM still sees that a file was present.
+ *
+ * Extracted text is appended to the body in this format:
+ *
+ *     <original body>
+ *
+ *     [Attached: invoice.pdf]
+ *     <extracted content>
+ */
+declare function enrichAttachments(msg: InboundMessage, botToken: string, enrichers: AttachmentEnricherMap): Promise<InboundMessage>;
+
+interface ImageEnricherConfig {
+    /** Anthropic API key for vision calls. */
+    apiKey: string;
+    /** Model to use. Defaults to claude-sonnet-4-6. */
+    model?: string;
+    /** Max tokens for the description. Defaults to 1024. */
+    maxTokens?: number;
+    /** Prompt used for image description. */
+    prompt?: string;
+}
+/**
+ * Build an enricher that sends Slack-hosted images to Claude's vision API
+ * and returns a text description.
+ *
+ * Consumer must provide an Anthropic API key. The Anthropic SDK is a peer
+ * dependency of botinabox — the consumer must have it installed.
+ */
+declare function createImageEnricher(config: ImageEnricherConfig): AttachmentEnricher;
+
+interface PdfEnricherConfig {
+    apiKey: string;
+    model?: string;
+    maxTokens?: number;
+    prompt?: string;
+}
+/**
+ * Build an enricher that sends Slack-hosted PDFs to Claude's document API
+ * and returns a text summary. Requires Claude 3.5+.
+ */
+declare function createPdfEnricher(config: PdfEnricherConfig): AttachmentEnricher;
+
+export { type AttachmentEnricher, type AttachmentEnricherMap, type BoltClient, type EnrichedMessage, type ImageEnricherConfig, type PdfEnricherConfig, SlackAdapter, SlackBoltAdapter, type SlackBoltAdapterConfig, type SlackConfig, type SlackEvent, type SlackFile, type TranscribeOptions, type TranscribeResult, createImageEnricher, createPdfEnricher, createSlackAdapter as default, downloadAudio, enrichAttachments, enrichVoiceMessage, extractVoiceTranscript, formatForSlack, parseSlackEvent, transcribeAudio };

package/dist/channels/slack/index.js

@@ -4,7 +4,7 @@ import {
   extractVoiceTranscript,
   parseSlackEvent,
   transcribeAudio
-} from "../../chunk-NNPCKR6G.js";
+} from "../../chunk-OEMM2LEA.js";
 import {
   chunkText
 } from "../../chunk-ZTZFPTOQ.js";
@@ -71,8 +71,8 @@ var SlackAdapter = class {
   /** Simulate receiving an inbound message (for testing/webhooks). */
   async receive(event) {
     if (this.onMessage) {
-      const { parseSlackEvent: parseSlackEvent2 } = await import("../../inbound-IBKXBFZF.js");
-      const { enrichVoiceMessage: enrichVoiceMessage2 } = await import("../../inbound-IBKXBFZF.js");
+      const { parseSlackEvent: parseSlackEvent2 } = await import("../../inbound-5FKJBWPL.js");
+      const { enrichVoiceMessage: enrichVoiceMessage2 } = await import("../../inbound-5FKJBWPL.js");
       let msg = parseSlackEvent2(event);
       if (msg.body.includes("[Voice message") && this.config?.botToken) {
         msg = await enrichVoiceMessage2(msg, this.config.botToken);
@@ -85,6 +85,33 @@ function createSlackAdapter(client) {
   return new SlackAdapter(client);
 }
 
+// src/channels/slack/enrichers/enrich.ts
+async function enrichAttachments(msg, botToken, enrichers) {
+  if (!msg.attachments?.length) return msg;
+  const parts = msg.body ? [msg.body] : [];
+  for (const att of msg.attachments) {
+    const enricher = enrichers[att.type];
+    const label = att.filename ?? att.url ?? att.type;
+    if (!enricher) {
+      parts.push(`[Attached: ${label}]`);
+      continue;
+    }
+    let extracted = null;
+    try {
+      extracted = await enricher(att, botToken);
+    } catch {
+      extracted = null;
+    }
+    if (extracted) {
+      parts.push(`[Attached: ${label}]
+${extracted}`);
+    } else {
+      parts.push(`[Attached: ${label}]`);
+    }
+  }
+  return { ...msg, body: parts.join("\n\n") };
+}
+
 // src/channels/slack/bolt-adapter.ts
 var SlackBoltAdapter = class {
   app = null;
@@ -95,7 +122,7 @@ var SlackBoltAdapter = class {
   async start() {
     const boltModule = "@slack/bolt";
     const bolt = await import(boltModule);
-    const { enrichVoiceMessage: enrichVoiceMessage2 } = await import("../../inbound-IBKXBFZF.js");
+    const { enrichVoiceMessage: enrichVoiceMessage2 } = await import("../../inbound-5FKJBWPL.js");
     const boltApp = new bolt.App({
       token: this.config.botToken,
       appToken: this.config.appToken,
@@ -113,6 +140,9 @@ var SlackBoltAdapter = class {
       if (inbound.body.includes("[Voice message \u2014 no transcript available]")) {
         inbound = await enrichVoiceMessage2(inbound, botToken);
       }
+      if (inbound.attachments?.length && this.config.attachmentEnrichers) {
+        inbound = await enrichAttachments(inbound, botToken, this.config.attachmentEnrichers);
+      }
       await hooks.emit("message.inbound", inbound);
     });
     hooks.register("response.ready", async (ctx) => {
@@ -164,11 +194,113 @@ var SlackBoltAdapter = class {
     }
   }
 };
+
+// src/channels/slack/enrichers/image-enricher.ts
+var DEFAULT_PROMPT = "Describe this image in detail. Include any visible text (OCR), objects, people, layout, and context. Be thorough \u2014 the description will be used as input to another agent that cannot see the image.";
+async function downloadAsBase64(urlPrivate, botToken) {
+  try {
+    const response = await fetch(urlPrivate, {
+      headers: { Authorization: `Bearer ${botToken}` },
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!response.ok) return null;
+    const buffer = Buffer.from(await response.arrayBuffer());
+    return buffer.toString("base64");
+  } catch {
+    return null;
+  }
+}
+function createImageEnricher(config) {
+  const { apiKey, model = "claude-sonnet-4-6", maxTokens = 1024, prompt = DEFAULT_PROMPT } = config;
+  return async (att, botToken) => {
+    if (!att.url) return null;
+    const mediaType = att.mimeType ?? "image/jpeg";
+    const base64 = await downloadAsBase64(att.url, botToken);
+    if (!base64) return null;
+    const anthropicModule = "@anthropic-ai/sdk";
+    const sdk = await import(anthropicModule);
+    const client = new sdk.default({ apiKey });
+    try {
+      const message = await client.messages.create({
+        model,
+        max_tokens: maxTokens,
+        messages: [
+          {
+            role: "user",
+            content: [
+              {
+                type: "image",
+                source: { type: "base64", media_type: mediaType, data: base64 }
+              },
+              { type: "text", text: prompt }
+            ]
+          }
+        ]
+      });
+      const textBlock = message.content.find((c) => c.type === "text");
+      return textBlock?.text ?? null;
+    } catch {
+      return null;
+    }
+  };
+}
+
+// src/channels/slack/enrichers/pdf-enricher.ts
+var DEFAULT_PROMPT2 = "Summarize this PDF in detail. Include all key facts, numbers, dates, names, and any structured content (tables, lists). The summary will be used as input to another agent that cannot see the PDF.";
+async function downloadAsBase642(urlPrivate, botToken) {
+  try {
+    const response = await fetch(urlPrivate, {
+      headers: { Authorization: `Bearer ${botToken}` },
+      signal: AbortSignal.timeout(6e4)
+    });
+    if (!response.ok) return null;
+    const buffer = Buffer.from(await response.arrayBuffer());
+    return buffer.toString("base64");
+  } catch {
+    return null;
+  }
+}
+function createPdfEnricher(config) {
+  const { apiKey, model = "claude-sonnet-4-6", maxTokens = 4096, prompt = DEFAULT_PROMPT2 } = config;
+  return async (att, botToken) => {
+    if (!att.url) return null;
+    const base64 = await downloadAsBase642(att.url, botToken);
+    if (!base64) return null;
+    const anthropicModule = "@anthropic-ai/sdk";
+    const sdk = await import(anthropicModule);
+    const client = new sdk.default({ apiKey });
+    try {
+      const message = await client.messages.create({
+        model,
+        max_tokens: maxTokens,
+        messages: [
+          {
+            role: "user",
+            content: [
+              {
+                type: "document",
+                source: { type: "base64", media_type: "application/pdf", data: base64 }
+              },
+              { type: "text", text: prompt }
+            ]
+          }
+        ]
+      });
+      const textBlock = message.content.find((c) => c.type === "text");
+      return textBlock?.text ?? null;
+    } catch {
+      return null;
+    }
+  };
+}
 export {
   SlackAdapter,
   SlackBoltAdapter,
+  createImageEnricher,
+  createPdfEnricher,
   createSlackAdapter as default,
   downloadAudio,
+  enrichAttachments,
   enrichVoiceMessage,
   extractVoiceTranscript,
   formatForSlack,

package/dist/channels/webhook/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ChannelAdapter, c as ChannelMeta, a as ChannelCapabilities, I as InboundMessage, b as ChannelConfig, H as HealthStatus, O as OutboundPayload, S as SendResult } from '../../channel-06G0vbIn.js';
+import { C as ChannelAdapter, d as ChannelMeta, b as ChannelCapabilities, I as InboundMessage, c as ChannelConfig, H as HealthStatus, O as OutboundPayload, S as SendResult } from '../../channel-DziSPayj.js';
 
 /**
  * WebhookAdapter — ChannelAdapter implementation for webhook-based channels.