botinabox 2.16.0 → 2.16.2

package/dist/chunk-NNPCKR6G.js

@@ -0,0 +1,144 @@
+// src/channels/slack/transcribe.ts
+import { execFileSync } from "child_process";
+import { writeFileSync, unlinkSync, mkdirSync } from "fs";
+import { join } from "path";
+import { randomUUID } from "crypto";
+import os from "os";
+import { createRequire } from "module";
+var TEMP_DIR = join(os.tmpdir(), "botinabox-audio");
+async function transcribeAudio(audioBuffer, filename, opts) {
+  let whisper;
+  try {
+    const require2 = createRequire(import.meta.url);
+    const mod = require2("whisper-node");
+    whisper = mod.whisper ?? mod.default ?? mod;
+  } catch {
+    console.warn("[botinabox] whisper-node not installed \u2014 voice transcription unavailable. Run: npm install whisper-node && npx whisper-node download");
+    return null;
+  }
+  try {
+    execFileSync("ffmpeg", ["-version"], { stdio: "ignore" });
+  } catch {
+    console.warn("[botinabox] ffmpeg not found \u2014 required for audio conversion. Install: brew install ffmpeg");
+    return null;
+  }
+  const id = randomUUID().slice(0, 8);
+  const ext = filename.split(".").pop() ?? "aac";
+  mkdirSync(TEMP_DIR, { recursive: true });
+  const inputPath = join(TEMP_DIR, `${id}.${ext}`);
+  const wavPath = join(TEMP_DIR, `${id}.wav`);
+  try {
+    writeFileSync(inputPath, audioBuffer);
+    execFileSync("ffmpeg", ["-y", "-i", inputPath, "-ar", "16000", "-ac", "1", "-c:a", "pcm_s16le", wavPath], {
+      stdio: "ignore",
+      timeout: 3e4
+    });
+    const segments = await whisper(wavPath, {
+      modelName: opts?.modelName ?? "base.en",
+      whisperOptions: {
+        language: opts?.language ?? "auto"
+      }
+    });
+    if (!segments || segments.length === 0) return null;
+    return segments.map((s) => s.speech).join(" ").trim();
+  } catch (err) {
+    console.error("[botinabox] Transcription failed:", err);
+    return null;
+  } finally {
+    try {
+      unlinkSync(inputPath);
+    } catch {
+    }
+    try {
+      unlinkSync(wavPath);
+    } catch {
+    }
+  }
+}
+async function downloadAudio(url, token) {
+  try {
+    const resp = await fetch(url, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (!resp.ok) {
+      console.error(`[botinabox] Audio download failed: ${resp.status} ${resp.statusText}`);
+      return null;
+    }
+    return Buffer.from(await resp.arrayBuffer());
+  } catch (err) {
+    console.error("[botinabox] Audio download error:", err);
+    return null;
+  }
+}
+
+// src/channels/slack/inbound.ts
+var AUDIO_TYPES = /* @__PURE__ */ new Set(["aac", "mp4", "m4a", "ogg", "webm", "mp3", "wav"]);
+function extractVoiceTranscript(file) {
+  const isAudio = file.subtype === "slack_audio" || AUDIO_TYPES.has(file.filetype ?? "");
+  if (!isAudio) return null;
+  const transcript = file.transcription?.preview?.content ?? (typeof file.preview === "string" ? file.preview : null);
+  return transcript ?? null;
+}
+function parseSlackEvent(event) {
+  const id = event.client_msg_id ?? event.ts ?? event.event_ts ?? `slack-${Date.now()}`;
+  const channel = event.channel ?? "unknown";
+  const from = event.user ?? "unknown";
+  const threadId = event.thread_ts !== void 0 ? event.thread_ts : void 0;
+  const receivedAt = event.ts ? new Date(parseFloat(event.ts) * 1e3).toISOString() : (/* @__PURE__ */ new Date()).toISOString();
+  let body = event.text ?? "";
+  if (event.subtype === "file_share" && event.files?.length) {
+    for (const file of event.files) {
+      const transcript = extractVoiceTranscript(file);
+      if (transcript) {
+        body = body ? `${body}
+
+[Voice message] ${transcript}` : `[Voice message] ${transcript}`;
+        break;
+      }
+    }
+  }
+  if (event.subtype === "file_share" && event.files?.length && !body) {
+    const hasAudio = event.files.some(
+      (f) => f.subtype === "slack_audio" || AUDIO_TYPES.has(f.filetype ?? "")
+    );
+    if (hasAudio) {
+      body = "[Voice message \u2014 no transcript available]";
+    }
+  }
+  return {
+    id,
+    channel,
+    from,
+    body,
+    threadId,
+    receivedAt,
+    raw: event
+  };
+}
+async function enrichVoiceMessage(msg, botToken) {
+  if (!msg.body.includes("[Voice message \u2014 no transcript available]")) return msg;
+  const raw = msg.raw;
+  const files = raw?.files;
+  if (!files?.length) return msg;
+  const audioFile = files.find(
+    (f) => f.subtype === "slack_audio" || AUDIO_TYPES.has(f.filetype ?? "")
+  );
+  if (!audioFile?.url_private) return msg;
+  const buffer = await downloadAudio(audioFile.url_private, botToken);
+  if (!buffer) return msg;
+  const filename = audioFile.name ?? `voice.${audioFile.filetype ?? "aac"}`;
+  const transcript = await transcribeAudio(buffer, filename);
+  if (!transcript) return msg;
+  return {
+    ...msg,
+    body: `[Voice message] ${transcript}`
+  };
+}
+
+export {
+  transcribeAudio,
+  downloadAudio,
+  extractVoiceTranscript,
+  parseSlackEvent,
+  enrichVoiceMessage
+};

package/dist/connector-B4Mj0P1b.d.ts

@@ -0,0 +1,79 @@
+/** Connector types — generic external service integrations. */
+interface ConnectorMeta {
+    displayName: string;
+    /** Provider identifier, e.g. "google", "trello", "jira", "salesforce" */
+    provider: string;
+    /** Data type this connector handles, e.g. "email", "calendar", "board", "crm" */
+    dataType: string;
+}
+interface SyncOptions {
+    /** Only sync records after this ISO 8601 timestamp */
+    since?: string;
+    /** Provider-specific incremental sync token */
+    cursor?: string;
+    /** Maximum number of records to fetch */
+    limit?: number;
+    /** Provider-specific query filters */
+    filters?: Record<string, unknown>;
+}
+interface SyncResult<T = Record<string, unknown>> {
+    /** Typed records produced by the connector — consumer decides where to store */
+    records: T[];
+    /** Next incremental sync token (persist for future calls) */
+    cursor?: string;
+    /** Whether more records are available (pagination) */
+    hasMore: boolean;
+    /** Errors encountered during sync (non-fatal per-record failures) */
+    errors: Array<{
+        id?: string;
+        error: string;
+    }>;
+}
+interface PushResult {
+    success: boolean;
+    externalId?: string;
+    error?: string;
+}
+interface AuthResult {
+    success: boolean;
+    account?: string;
+    /** URL the user must visit to authorize (for OAuth flows) */
+    authUrl?: string;
+    error?: string;
+}
+type ConnectorConfig = Record<string, unknown>;
+/**
+ * Generic connector interface for external service integrations.
+ *
+ * Connectors pull and optionally push data to/from external services
+ * (Gmail, Calendar, Trello, Jira, Salesforce, etc.). They produce
+ * typed records — the consuming application decides where to store them.
+ *
+ * @typeParam T - The record type this connector produces/consumes.
+ */
+interface Connector<T = Record<string, unknown>> {
+    readonly id: string;
+    readonly meta: ConnectorMeta;
+    connect(config: ConnectorConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        account?: string;
+        error?: string;
+    }>;
+    /** Pull records from external source */
+    sync(options?: SyncOptions): Promise<SyncResult<T>>;
+    /** Push a record to external source (optional) */
+    push?(payload: T): Promise<PushResult>;
+    /**
+     * Run the authentication/authorization flow for this connector.
+     * For OAuth connectors, this generates the auth URL and exchanges the code for tokens.
+     *
+     * @param codeProvider - called with the auth URL; must return the authorization code.
+     *   For CLI flows, this prints the URL and reads from stdin.
+     *   For programmatic flows, the caller handles the redirect.
+     */
+    authenticate?(codeProvider: (authUrl: string) => Promise<string>): Promise<AuthResult>;
+}
+
+export type { AuthResult as A, ConnectorConfig as C, PushResult as P, SyncOptions as S, Connector as a, ConnectorMeta as b, SyncResult as c };

package/dist/inbound-IBKXBFZF.js

@@ -0,0 +1,11 @@
+import {
+  enrichVoiceMessage,
+  extractVoiceTranscript,
+  parseSlackEvent
+} from "./chunk-NNPCKR6G.js";
+import "./chunk-3RG5ZIWI.js";
+export {
+  enrichVoiceMessage,
+  extractVoiceTranscript,
+  parseSlackEvent
+};

package/dist/provider-DLGUfnNx.d.ts

@@ -0,0 +1,75 @@
+/** LLM provider types — Story 1.5 / 2.1 */
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+interface ChatMessage {
+    role: "user" | "assistant" | "system";
+    content: string | ContentBlock[];
+}
+type ContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+};
+interface ChatParams {
+    messages: ChatMessage[];
+    system?: string;
+    tools?: ToolDefinition[];
+    maxTokens?: number;
+    temperature?: number;
+    model: string;
+    abortSignal?: AbortSignal;
+}
+interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+interface ChatResult {
+    content: string;
+    toolUses?: ToolUse[];
+    usage: TokenUsage;
+    model: string;
+    stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
+}
+interface ToolUse {
+    id: string;
+    name: string;
+    input: unknown;
+}
+interface ModelInfo {
+    id: string;
+    displayName: string;
+    contextWindow: number;
+    maxOutputTokens: number;
+    capabilities: Array<"chat" | "tools" | "vision" | "streaming">;
+    /** Cost in micro-cents per 1M tokens */
+    inputCostPerMToken?: number;
+    outputCostPerMToken?: number;
+}
+interface ResolvedModel {
+    provider: string;
+    model: string;
+}
+interface LLMProvider {
+    id: string;
+    displayName: string;
+    models: ModelInfo[];
+    chat(params: ChatParams): Promise<ChatResult>;
+    chatStream(params: ChatParams): AsyncGenerator<string, ChatResult, unknown>;
+    /** Convert ToolDefinition[] to provider-native format */
+    serializeTools(tools: ToolDefinition[]): unknown;
+}
+
+export type { ChatMessage as C, LLMProvider as L, ModelInfo as M, ResolvedModel as R, TokenUsage as T, ChatParams as a, ChatResult as b, ContentBlock as c, ToolUse as d, ToolDefinition as e };

package/package.json

@@ -1,100 +1,100 @@
-{
-  "name": "botinabox",
-  "version": "2.16.0",
-  "description": "Bot in a Box — framework for building multi-agent bots",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./anthropic": {
-      "import": "./dist/providers/anthropic/index.js",
-      "types": "./dist/providers/anthropic/index.d.ts"
-    },
-    "./openai": {
-      "import": "./dist/providers/openai/index.js",
-      "types": "./dist/providers/openai/index.d.ts"
-    },
-    "./ollama": {
-      "import": "./dist/providers/ollama/index.js",
-      "types": "./dist/providers/ollama/index.d.ts"
-    },
-    "./slack": {
-      "import": "./dist/channels/slack/index.js",
-      "types": "./dist/channels/slack/index.d.ts"
-    },
-    "./discord": {
-      "import": "./dist/channels/discord/index.js",
-      "types": "./dist/channels/discord/index.d.ts"
-    },
-    "./webhook": {
-      "import": "./dist/channels/webhook/index.js",
-      "types": "./dist/channels/webhook/index.d.ts"
-    },
-    "./google": {
-      "import": "./dist/connectors/google/index.js",
-      "types": "./dist/connectors/google/index.d.ts"
-    }
-  },
-  "bin": {
-    "botinabox": "./bin/botinabox.mjs"
-  },
-  "files": [
-    "dist",
-    "bin"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsup && tsc --emitDeclarationOnly",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "check-docs": "echo 'Documentation check passed'",
-    "prepublishOnly": "npm run build && npm run typecheck && npm test"
-  },
-  "dependencies": {
-    "@types/uuid": "^10.0.0",
-    "ajv": "^8.17.1",
-    "cron-parser": "^4.9.0",
-    "latticesql": "^1.13.4",
-    "uuid": "^13.0.0",
-    "yaml": "^2.7.0"
-  },
-  "optionalDependencies": {
-    "whisper-node": "^1.1.1"
-  },
-  "peerDependencies": {
-    "@anthropic-ai/sdk": "^0.52.0",
-    "googleapis": ">=140.0.0 <200.0.0",
-    "openai": "^4.104.0"
-  },
-  "peerDependenciesMeta": {
-    "@anthropic-ai/sdk": {
-      "optional": true
-    },
-    "openai": {
-      "optional": true
-    },
-    "googleapis": {
-      "optional": true
-    }
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/automated-industries/botinabox.git"
-  },
-  "devDependencies": {
-    "@anthropic-ai/sdk": "^0.52.0",
-    "@types/better-sqlite3": "^7.6.12",
-    "@types/node": "^22.10.0",
-    "googleapis": "^171.4.0",
-    "openai": "^4.104.0",
-    "tsup": "^8.3.5",
-    "typescript": "^5.7.2",
-    "vitest": "^3.0.0"
-  }
-}
+{
+  "name": "botinabox",
+  "version": "2.16.2",
+  "description": "Bot in a Box — framework for building multi-agent bots",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./anthropic": {
+      "import": "./dist/providers/anthropic/index.js",
+      "types": "./dist/providers/anthropic/index.d.ts"
+    },
+    "./openai": {
+      "import": "./dist/providers/openai/index.js",
+      "types": "./dist/providers/openai/index.d.ts"
+    },
+    "./ollama": {
+      "import": "./dist/providers/ollama/index.js",
+      "types": "./dist/providers/ollama/index.d.ts"
+    },
+    "./slack": {
+      "import": "./dist/channels/slack/index.js",
+      "types": "./dist/channels/slack/index.d.ts"
+    },
+    "./discord": {
+      "import": "./dist/channels/discord/index.js",
+      "types": "./dist/channels/discord/index.d.ts"
+    },
+    "./webhook": {
+      "import": "./dist/channels/webhook/index.js",
+      "types": "./dist/channels/webhook/index.d.ts"
+    },
+    "./google": {
+      "import": "./dist/connectors/google/index.js",
+      "types": "./dist/connectors/google/index.d.ts"
+    }
+  },
+  "bin": {
+    "botinabox": "./bin/botinabox.mjs"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "check-docs": "echo 'Documentation check passed'",
+    "prepublishOnly": "npm run build && npm run typecheck && npm test"
+  },
+  "dependencies": {
+    "@types/uuid": "^10.0.0",
+    "ajv": "^8.17.1",
+    "cron-parser": "^4.9.0",
+    "latticesql": "^1.13.6",
+    "uuid": "^13.0.0",
+    "yaml": "^2.7.0"
+  },
+  "optionalDependencies": {
+    "whisper-node": "^1.1.1"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "googleapis": ">=140.0.0 <200.0.0",
+    "openai": "^4.104.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    },
+    "googleapis": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/automated-industries/botinabox.git"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.10.0",
+    "googleapis": "^171.4.0",
+    "openai": "^4.104.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.0"
+  }
+}