botinabox 2.9.1 → 2.9.3

package/dist/channels/slack/media-type.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Slack filetype → AttachmentMediaType mapping.
+ *
+ * Extensible: add new entries to FILETYPE_MAP to support new formats.
+ * The categories align with observation media_type values used elsewhere
+ * in the broader platform.
+ */
+import type { AttachmentMediaType } from "../../shared/types/channel.js";
+/**
+ * Map a Slack `filetype` string to an AttachmentMediaType category.
+ * Unknown types fall through to `"misc"`.
+ */
+export declare function slackFiletypeToMediaType(filetype: string | undefined): AttachmentMediaType;
+export declare function extractUrls(text: string): string[];

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

@@ -0,0 +1,9 @@
+/**
+ * Slack channel configuration types.
+ * Story 4.5
+ */
+export interface SlackConfig {
+    botToken: string;
+    appToken?: string;
+    signingSecret?: string;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Slack outbound formatting.
+ * Story 4.5
+ */
+/**
+ * Convert standard markdown to Slack's mrkdwn format.
+ * - **bold** → *bold*
+ * - _italic_ preserved
+ * - `code` preserved
+ * - ```code block``` preserved
+ */
+export declare function formatForSlack(text: string): string;

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

@@ -0,0 +1,41 @@
+/**
+ * Local voice transcription via whisper-node (whisper.cpp bindings).
+ *
+ * whisper-node is an optional dependency — if not installed, transcription
+ * degrades gracefully (returns null). Requires ffmpeg on the system PATH
+ * for audio format conversion.
+ *
+ * Setup:
+ *   npm install whisper-node
+ *   npx whisper-node download    # download a model (e.g. base.en)
+ *   brew install ffmpeg           # or equivalent for your platform
+ */
+export interface TranscribeOptions {
+    /** Whisper model name (default: "base.en"). Run `npx whisper-node download` to get models. */
+    modelName?: string;
+    /** Language code (default: "auto"). Use "en" for English-only models. */
+    language?: string;
+}
+export interface TranscribeResult {
+    /** The full transcribed text */
+    text: string;
+    /** Individual segments with timestamps */
+    segments: Array<{
+        start: string;
+        end: string;
+        speech: string;
+    }>;
+}
+/**
+ * Transcribe an audio buffer using whisper-node.
+ *
+ * @param audioBuffer - Raw audio data (any format ffmpeg can decode)
+ * @param filename - Original filename (used for temp file extension)
+ * @param opts - Transcription options
+ * @returns Transcribed text, or null if transcription fails or whisper-node is not installed
+ */
+export declare function transcribeAudio(audioBuffer: Buffer, filename: string, opts?: TranscribeOptions): Promise<string | null>;
+/**
+ * Download an audio file from a URL with bearer token authentication.
+ */
+export declare function downloadAudio(url: string, token: string): Promise<Buffer | null>;

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

@@ -0,0 +1,23 @@
+/**
+ * WebhookAdapter — ChannelAdapter implementation for webhook-based channels.
+ * Story 4.7
+ */
+import type { ChannelAdapter, ChannelCapabilities, ChannelMeta, ChannelConfig, InboundMessage, OutboundPayload, SendResult, HealthStatus } from "../../shared/index.js";
+export declare class WebhookAdapter implements ChannelAdapter {
+    readonly id = "webhook";
+    readonly meta: ChannelMeta;
+    readonly capabilities: ChannelCapabilities;
+    onMessage?: (message: InboundMessage) => Promise<void>;
+    private connected;
+    private config;
+    private webhookServer;
+    connect(config: ChannelConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<HealthStatus>;
+    send(target: {
+        peerId: string;
+        threadId?: string;
+    }, payload: OutboundPayload): Promise<SendResult>;
+}
+/** Factory function — default export for auto-discovery. */
+export default function createWebhookAdapter(): WebhookAdapter;

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

@@ -0,0 +1,13 @@
+/**
+ * HMAC signature verification for webhook payloads.
+ * Story 4.7
+ */
+/**
+ * Verify that the HMAC-SHA256 signature of body matches the provided signature.
+ * Uses timing-safe comparison to prevent timing attacks.
+ *
+ * @param body      - The raw request body string
+ * @param secret    - The shared HMAC secret
+ * @param signature - The signature to verify (hex string, possibly prefixed with "sha256=")
+ */
+export declare function verifyHmac(body: string, secret: string, signature: string): boolean;

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

@@ -1,73 +1,10 @@
-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-CVm1AWUF.js';
-import '../../provider-BHkqkSdq.js';
-
 /**
- * WebhookAdapter — ChannelAdapter implementation for webhook-based channels.
+ * @botinabox/channel-webhook — Webhook channel adapter.
  * Story 4.7
  */
-
-declare class WebhookAdapter implements ChannelAdapter {
-    readonly id = "webhook";
-    readonly meta: ChannelMeta;
-    readonly capabilities: ChannelCapabilities;
-    onMessage?: (message: InboundMessage) => Promise<void>;
-    private connected;
-    private config;
-    private webhookServer;
-    connect(config: ChannelConfig): Promise<void>;
-    disconnect(): Promise<void>;
-    healthCheck(): Promise<HealthStatus>;
-    send(target: {
-        peerId: string;
-        threadId?: string;
-    }, payload: OutboundPayload): Promise<SendResult>;
-}
-/** Factory function — default export for auto-discovery. */
-declare function createWebhookAdapter(): WebhookAdapter;
-
-/**
- * Minimal HTTP server for webhook inbound messages.
- * Story 4.7
- */
-
-interface WebhookServerOpts {
-    port?: number;
-    secret?: string;
-    onMessage: (msg: InboundMessage) => Promise<void>;
-}
-declare class WebhookServer {
-    private server;
-    private readonly port;
-    private readonly secret;
-    private readonly onMessage;
-    constructor(opts: WebhookServerOpts);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    private handleRequest;
-}
-
-/**
- * HMAC signature verification for webhook payloads.
- * Story 4.7
- */
-/**
- * Verify that the HMAC-SHA256 signature of body matches the provided signature.
- * Uses timing-safe comparison to prevent timing attacks.
- *
- * @param body      - The raw request body string
- * @param secret    - The shared HMAC secret
- * @param signature - The signature to verify (hex string, possibly prefixed with "sha256=")
- */
-declare function verifyHmac(body: string, secret: string, signature: string): boolean;
-
-/**
- * Webhook channel configuration types.
- * Story 4.7
- */
-interface WebhookConfig {
-    callbackUrl?: string;
-    secret?: string;
-    port?: number;
-}
-
-export { WebhookAdapter, type WebhookConfig, WebhookServer, type WebhookServerOpts, createWebhookAdapter as default, verifyHmac };
+export { WebhookAdapter } from "./adapter.js";
+export { WebhookServer } from "./server.js";
+export type { WebhookServerOpts } from "./server.js";
+export { verifyHmac } from "./hmac.js";
+export type { WebhookConfig } from "./models.js";
+export { default } from "./adapter.js";

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

@@ -0,0 +1,9 @@
+/**
+ * Webhook channel configuration types.
+ * Story 4.7
+ */
+export interface WebhookConfig {
+    callbackUrl?: string;
+    secret?: string;
+    port?: number;
+}

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

@@ -0,0 +1,20 @@
+/**
+ * Minimal HTTP server for webhook inbound messages.
+ * Story 4.7
+ */
+import type { InboundMessage } from "../../shared/index.js";
+export interface WebhookServerOpts {
+    port?: number;
+    secret?: string;
+    onMessage: (msg: InboundMessage) => Promise<void>;
+}
+export declare class WebhookServer {
+    private server;
+    private readonly port;
+    private readonly secret;
+    private readonly onMessage;
+    constructor(opts: WebhookServerOpts);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleRequest;
+}

package/dist/cli/templates/config.yml.d.ts

@@ -0,0 +1,7 @@
+export interface ConfigTemplateOptions {
+    name: string;
+    channel?: string;
+    provider?: string;
+    typescript?: boolean;
+}
+export declare function configYmlTemplate(opts: ConfigTemplateOptions): string;

package/dist/cli/templates/env.d.ts

@@ -0,0 +1 @@
+export declare function envTemplate(channel?: string, provider?: string): string;

package/dist/cli/templates/index.ts.d.ts

@@ -0,0 +1,2 @@
+export declare function indexTsTemplate(name: string): string;
+export declare function indexJsTemplate(name: string): string;

package/dist/cli/templates/package.json.d.ts

@@ -0,0 +1,5 @@
+export interface PackageJsonTemplateOptions {
+    name: string;
+    typescript?: boolean;
+}
+export declare function packageJsonTemplate(opts: PackageJsonTemplateOptions): string;

package/dist/cli.d.ts

@@ -1,4 +1,2 @@
 #!/usr/bin/env node
-declare function main(args: string[]): Promise<void>;
-
-export { main };
+export declare function main(args: string[]): Promise<void>;

package/dist/connectors/google/calendar-connector.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Google Calendar connector — pulls calendar events.
+ *
+ * Produces `CalendarEventRecord` objects. Does NOT write to any database
+ * table; the consuming application decides how to store records.
+ */
+import type { Connector, ConnectorMeta, AuthResult, SyncOptions, SyncResult } from '../../shared/types/connector.js';
+import type { CalendarEventRecord, GoogleConnectorConfig } from './types.js';
+export interface CalendarConnectorOpts {
+    /** Load persisted tokens for a given account key (OAuth2 flow only). */
+    tokenLoader?: (key: string) => Promise<string | null>;
+    /** Persist tokens for a given account key (OAuth2 flow only). */
+    tokenSaver?: (key: string, value: string) => Promise<void>;
+}
+export declare class GoogleCalendarConnector implements Connector<CalendarEventRecord> {
+    readonly id = "google-calendar";
+    readonly meta: ConnectorMeta;
+    private tokenLoader?;
+    private tokenSaver?;
+    private client;
+    private config;
+    private tokens;
+    private calendar;
+    constructor(opts?: CalendarConnectorOpts);
+    connect(config: GoogleConnectorConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        account?: string;
+        error?: string;
+    }>;
+    authenticate(codeProvider: (authUrl: string) => Promise<string>): Promise<AuthResult>;
+    sync(options?: SyncOptions): Promise<SyncResult<CalendarEventRecord>>;
+    /** Incremental sync using Calendar syncToken. */
+    private syncIncremental;
+    /** Full sync using timeMin. */
+    private syncFull;
+    private ensureConnected;
+    private mapEvent;
+}

package/dist/connectors/google/drive-connector.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Google Drive connector — pulls file metadata from Drive.
+ *
+ * Produces `DriveFileRecord` objects. Does NOT write to any database
+ * table; the consuming application decides how to store records.
+ *
+ * Supports incremental sync via Drive Changes API (startPageToken)
+ * and full sync via files.list with optional folder/MIME filters.
+ */
+import type { Connector, ConnectorMeta, AuthResult, SyncOptions, SyncResult } from '../../shared/types/connector.js';
+import type { DriveFileRecord, GoogleConnectorConfig } from './types.js';
+export interface DriveConnectorOpts {
+    /** Load persisted tokens for a given account key (OAuth2 flow only). */
+    tokenLoader?: (key: string) => Promise<string | null>;
+    /** Persist tokens for a given account key (OAuth2 flow only). */
+    tokenSaver?: (key: string, value: string) => Promise<void>;
+}
+export declare class GoogleDriveConnector implements Connector<DriveFileRecord> {
+    readonly id = "google-drive";
+    readonly meta: ConnectorMeta;
+    private tokenLoader?;
+    private tokenSaver?;
+    private client;
+    private config;
+    private tokens;
+    private drive;
+    constructor(opts?: DriveConnectorOpts);
+    connect(config: GoogleConnectorConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        account?: string;
+        error?: string;
+    }>;
+    authenticate(codeProvider: (authUrl: string) => Promise<string>): Promise<AuthResult>;
+    sync(options?: SyncOptions): Promise<SyncResult<DriveFileRecord>>;
+    /** Incremental sync using Drive Changes API. */
+    private syncIncremental;
+    /** Full sync using files.list. */
+    private syncFull;
+    private ensureConnected;
+    private mapFile;
+}

package/dist/connectors/google/drive-read.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Google Drive file read primitives — download or export files to raw bytes.
+ *
+ * Signature-agnostic primitives that produce `{ buffer, mimeType, filename }`
+ * tuples for use in attachment enrichment pipelines and other file consumers.
+ */
+/**
+ * Raw file bytes fetched from Google Drive, plus the metadata needed to
+ * decide what to do with them (MIME type → extractor, filename → display).
+ */
+export interface DriveFileBytes {
+    buffer: Buffer;
+    mimeType: string;
+    filename: string;
+    /** Size in bytes as reported by the download response. */
+    size: number;
+}
+/**
+ * Supported export target formats for Google-native file types
+ * (Docs, Sheets, Slides, Drawings).
+ */
+export type GoogleDocExportAs = 'docx' | 'xlsx' | 'pptx' | 'png' | 'pdf' | 'txt' | 'csv' | 'html';
+/**
+ * Download a binary Drive file as raw bytes.
+ *
+ * Use this for files uploaded to Drive in their native format (pdf, docx,
+ * xlsx, pptx, jpg, png, mp4, etc.) — anything where the Drive `mimeType`
+ * is NOT `application/vnd.google-apps.*`.
+ *
+ * For Google-native formats (Docs, Sheets, Slides, Drawings) use
+ * `exportGoogleDoc` instead — `files.get` with `alt: 'media'` fails on
+ * those with `fileNotDownloadable`.
+ *
+ * @param drive - googleapis `drive_v3.Drive` instance (kept as `any` to avoid hard type import)
+ * @param fileId - Drive file ID
+ * @returns Promise resolving to `DriveFileBytes` with buffer, mimeType, filename, and size
+ */
+export declare function downloadDriveFile(drive: any, fileId: string): Promise<DriveFileBytes>;
+/**
+ * Export a Google-native document to a downloadable format.
+ *
+ * The `exportAs` argument picks the target MIME type:
+ *   - docx → application/vnd.openxmlformats-officedocument.wordprocessingml.document
+ *   - xlsx → application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
+ *   - pptx → application/vnd.openxmlformats-officedocument.presentationml.presentation
+ *   - png  → image/png
+ *   - pdf  → application/pdf
+ *   - txt  → text/plain
+ *   - csv  → text/csv  (only valid for spreadsheets)
+ *   - html → text/html
+ *
+ * Throws if the source file is not a Google-native type, or if the
+ * requested export is not supported for that type (e.g., csv on a Doc).
+ *
+ * @param drive - googleapis `drive_v3.Drive` instance
+ * @param fileId - Drive file ID
+ * @param exportAs - Target export format
+ * @returns Promise resolving to `DriveFileBytes` with exported content
+ */
+export declare function exportGoogleDoc(drive: any, fileId: string, exportAs: GoogleDocExportAs): Promise<DriveFileBytes>;
+/**
+ * High-level dispatcher. Fetches file metadata, inspects the mimeType,
+ * and picks `downloadDriveFile` (binary) or `exportGoogleDoc` (native)
+ * automatically.
+ *
+ * Google-native → exported format mapping:
+ *   - Docs       → docx
+ *   - Sheets     → xlsx
+ *   - Slides     → pptx
+ *   - Drawings   → png
+ *   - Scripts    → throws (not supported)
+ *   - Forms/Site → throws (not supported)
+ *
+ * Consumers that want a different export target (e.g., gdoc → pdf for
+ * Claude's native PDF reading) should call `exportGoogleDoc` directly.
+ *
+ * @param drive - googleapis `drive_v3.Drive` instance
+ * @param fileId - Drive file ID
+ * @returns Promise resolving to `DriveFileBytes` with automatically chosen format
+ */
+export declare function readDriveFile(drive: any, fileId: string): Promise<DriveFileBytes>;

package/dist/connectors/google/gmail-connector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Gmail connector — pulls email metadata and optionally sends mail.
+ *
+ * Produces `EmailRecord` objects. Does NOT write to any database table;
+ * the consuming application decides how to store records.
+ */
+import type { Connector, ConnectorMeta, AuthResult, SyncOptions, SyncResult, PushResult } from '../../shared/types/connector.js';
+import type { EmailRecord, GoogleConnectorConfig } from './types.js';
+export interface GmailConnectorOpts {
+    /** Load persisted tokens for a given account key (OAuth2 flow only). */
+    tokenLoader?: (key: string) => Promise<string | null>;
+    /** Persist tokens for a given account key (OAuth2 flow only). */
+    tokenSaver?: (key: string, value: string) => Promise<void>;
+}
+export declare class GoogleGmailConnector implements Connector<EmailRecord> {
+    readonly id = "google-gmail";
+    readonly meta: ConnectorMeta;
+    private tokenLoader?;
+    private tokenSaver?;
+    private client;
+    private config;
+    private tokens;
+    private gmail;
+    constructor(opts?: GmailConnectorOpts);
+    connect(config: GoogleConnectorConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        account?: string;
+        error?: string;
+    }>;
+    authenticate(codeProvider: (authUrl: string) => Promise<string>): Promise<AuthResult>;
+    sync(options?: SyncOptions): Promise<SyncResult<EmailRecord>>;
+    /** Incremental sync using Gmail history API. */
+    private syncIncremental;
+    /** Full sync — list messages and fetch each one. */
+    private syncFull;
+    push(payload: EmailRecord): Promise<PushResult>;
+    private ensureConnected;
+    /** Fetch a single message by ID and parse into an EmailRecord. */
+    private fetchMessage;
+}