botinabox 2.4.3 → 2.5.1

package/dist/connectors/google/index.js

@@ -235,8 +235,248 @@ var GoogleCalendarConnector = class {
 function errorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
+
+// src/connectors/google/drive-connector.ts
+var FILE_FIELDS = "id, name, mimeType, webViewLink, webContentLink, modifiedTime, createdTime, size, parents, description, owners, lastModifyingUser, starred, trashed";
+var GoogleDriveConnector = class {
+  id = "google-drive";
+  meta = {
+    displayName: "Google Drive",
+    provider: "google",
+    dataType: "document"
+  };
+  tokenLoader;
+  tokenSaver;
+  client = null;
+  config = null;
+  tokens = null;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  drive = null;
+  constructor(opts = {}) {
+    this.tokenLoader = opts.tokenLoader;
+    this.tokenSaver = opts.tokenSaver;
+  }
+  // ── Lifecycle ──────────────────────────────────────────────────
+  async connect(config) {
+    this.config = config;
+    const scopes = config.scopes ?? [
+      "https://www.googleapis.com/auth/drive.readonly"
+    ];
+    if (config.serviceAccount) {
+      this.client = await createServiceAccountClient(config.serviceAccount, scopes);
+    } else if (config.oauth) {
+      this.client = await createOAuth2Client(config.oauth);
+      if (!this.tokenLoader) {
+        throw new Error("tokenLoader required for OAuth2 flow");
+      }
+      this.tokens = await loadTokens(this.tokenLoader, config.account);
+      if (!this.tokens) {
+        throw new Error(
+          `No stored tokens for account ${config.account}. Complete the OAuth flow first.`
+        );
+      }
+      this.tokens = await refreshIfNeeded(
+        this.client,
+        this.tokens,
+        this.tokenSaver ? async (t) => saveTokens(this.tokenSaver, config.account, t) : void 0
+      );
+      this.client.setCredentials(this.tokens);
+    } else {
+      throw new Error("Either serviceAccount or oauth config is required");
+    }
+    const { google } = await import("googleapis");
+    this.drive = google.drive({ version: "v3", auth: this.client });
+  }
+  async disconnect() {
+    this.client = null;
+    this.drive = null;
+    this.tokens = null;
+    this.config = null;
+  }
+  async healthCheck() {
+    try {
+      this.ensureConnected();
+      const res = await this.drive.about.get({ fields: "user" });
+      return { ok: true, account: res.data.user?.emailAddress ?? this.config.account };
+    } catch (err) {
+      return { ok: false, error: errorMessage2(err) };
+    }
+  }
+  // ── Auth ───────────────────────────────────────────────────────
+  async authenticate(codeProvider) {
+    if (!this.config) {
+      return { success: false, error: "Call connect() first." };
+    }
+    try {
+      if (!this.config.oauth) {
+        return { success: false, error: "OAuth config required. Use serviceAccount for headless auth." };
+      }
+      if (!this.tokenSaver) {
+        return { success: false, error: "tokenSaver required for authenticate() flow." };
+      }
+      const client = await createOAuth2Client(this.config.oauth);
+      const scopes = this.config.scopes ?? [
+        "https://www.googleapis.com/auth/drive.readonly"
+      ];
+      const authUrl = getAuthUrl(client, scopes);
+      const code = await codeProvider(authUrl);
+      const tokens = await exchangeCode(client, code);
+      await saveTokens(this.tokenSaver, this.config.account, tokens);
+      this.tokens = tokens;
+      this.client = client;
+      this.client.setCredentials(tokens);
+      const { google } = await import("googleapis");
+      this.drive = google.drive({ version: "v3", auth: this.client });
+      return { success: true, account: this.config.account };
+    } catch (err) {
+      return { success: false, error: errorMessage2(err) };
+    }
+  }
+  // ── Sync ───────────────────────────────────────────────────────
+  async sync(options) {
+    this.ensureConnected();
+    if (options?.cursor) {
+      return this.syncIncremental(options.cursor, options);
+    }
+    return this.syncFull(options);
+  }
+  /** Incremental sync using Drive Changes API. */
+  async syncIncremental(startPageToken, options) {
+    const records = [];
+    const errors = [];
+    let pageToken = startPageToken;
+    let newStartPageToken;
+    try {
+      do {
+        const res = await this.drive.changes.list({
+          pageToken,
+          fields: `nextPageToken, newStartPageToken, changes(fileId, removed, file(${FILE_FIELDS}))`,
+          pageSize: options?.limit ? Math.min(options.limit - records.length, 100) : 100
+        });
+        for (const change of res.data.changes ?? []) {
+          try {
+            if (change.removed || !change.file) {
+              if (change.fileId) {
+                records.push({
+                  driveFileId: change.fileId,
+                  account: this.config.account,
+                  name: "",
+                  mimeType: "",
+                  webViewLink: "",
+                  modifiedTime: (/* @__PURE__ */ new Date()).toISOString(),
+                  createdTime: "",
+                  owners: [],
+                  starred: false,
+                  trashed: true
+                });
+              }
+            } else {
+              records.push(this.mapFile(change.file));
+            }
+          } catch (err) {
+            errors.push({ id: change.fileId ?? "unknown", error: errorMessage2(err) });
+          }
+          if (options?.limit && records.length >= options.limit) break;
+        }
+        pageToken = res.data.nextPageToken ?? void 0;
+        newStartPageToken = res.data.newStartPageToken ?? void 0;
+      } while (pageToken && (!options?.limit || records.length < options.limit));
+    } catch (err) {
+      if (err?.code === 403 || err?.code === 404) {
+        return this.syncFull(options);
+      }
+      throw err;
+    }
+    return {
+      records,
+      cursor: newStartPageToken,
+      hasMore: !!pageToken,
+      errors
+    };
+  }
+  /** Full sync using files.list. */
+  async syncFull(options) {
+    const records = [];
+    const errors = [];
+    const maxResults = options?.limit ?? 500;
+    const queryParts = ["trashed = false"];
+    const folderId = options?.filters?.folderId;
+    if (folderId) {
+      queryParts.push(`'${folderId}' in parents`);
+    }
+    const mimeType = options?.filters?.mimeType;
+    if (mimeType) {
+      queryParts.push(`mimeType = '${mimeType}'`);
+    }
+    if (options?.since) {
+      queryParts.push(`modifiedTime > '${new Date(options.since).toISOString()}'`);
+    }
+    const q = queryParts.join(" and ");
+    let pageToken;
+    do {
+      const res = await this.drive.files.list({
+        q,
+        fields: `nextPageToken, files(${FILE_FIELDS})`,
+        orderBy: "modifiedTime desc",
+        pageSize: Math.min(maxResults - records.length, 100),
+        ...pageToken ? { pageToken } : {}
+      });
+      for (const file of res.data.files ?? []) {
+        try {
+          records.push(this.mapFile(file));
+        } catch (err) {
+          errors.push({ id: file.id, error: errorMessage2(err) });
+        }
+        if (records.length >= maxResults) break;
+      }
+      pageToken = res.data.nextPageToken ?? void 0;
+    } while (pageToken && records.length < maxResults);
+    const tokenRes = await this.drive.changes.getStartPageToken({});
+    const cursor = tokenRes.data.startPageToken ?? void 0;
+    return {
+      records,
+      cursor,
+      hasMore: !!pageToken,
+      errors
+    };
+  }
+  // ── Internals ─────────────────────────────────────────────────
+  ensureConnected() {
+    if (!this.drive || !this.config) {
+      throw new Error("GoogleDriveConnector is not connected. Call connect() first.");
+    }
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  mapFile(file) {
+    const mapOwner = (o) => ({
+      displayName: o?.displayName ?? "",
+      emailAddress: o?.emailAddress ?? ""
+    });
+    return {
+      driveFileId: file.id,
+      account: this.config.account,
+      name: file.name ?? "(Untitled)",
+      mimeType: file.mimeType ?? "",
+      webViewLink: file.webViewLink ?? "",
+      webContentLink: file.webContentLink ?? void 0,
+      modifiedTime: file.modifiedTime ?? (/* @__PURE__ */ new Date()).toISOString(),
+      createdTime: file.createdTime ?? "",
+      size: file.size ? parseInt(file.size, 10) : void 0,
+      parents: file.parents ?? void 0,
+      description: file.description ?? void 0,
+      owners: (file.owners ?? []).map(mapOwner),
+      lastModifyingUser: file.lastModifyingUser ? mapOwner(file.lastModifyingUser) : void 0,
+      starred: file.starred ?? false,
+      trashed: file.trashed ?? false
+    };
+  }
+};
+function errorMessage2(err) {
+  return err instanceof Error ? err.message : String(err);
+}
 export {
   GoogleCalendarConnector,
+  GoogleDriveConnector,
   GoogleGmailConnector,
   createOAuth2Client,
   createServiceAccountClient,

package/dist/index.js

@@ -4233,7 +4233,12 @@ import { join as join5 } from "path";
 var SEMVER_RE = /^\d+\.\d+\.\d+(-[\w.]+)?$/;
 function getInstalledVersion(pkgName) {
   try {
-    const pkgPath = join5(process.cwd(), "node_modules", pkgName, "package.json");
+    const pkgPath = join5(
+      process.cwd(),
+      "node_modules",
+      pkgName,
+      "package.json"
+    );
     const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
     return pkg.version;
   } catch {
@@ -4265,7 +4270,11 @@ function isNewer(latest, current) {
 async function autoUpdate(packages = ["botinabox", "latticesql"], opts) {
   const log = opts?.quiet ? () => {
   } : console.log;
-  const result = { updated: false, packages: [], restartRequired: false };
+  const result = {
+    updated: false,
+    packages: [],
+    restartRequired: false
+  };
   const toInstall = [];
   for (const pkg of packages) {
     const installed = getInstalledVersion(pkg);
@@ -4274,7 +4283,9 @@ async function autoUpdate(packages = ["botinabox", "latticesql"], opts) {
     if (!latest) continue;
     if (isNewer(latest, installed)) {
       if (!SEMVER_RE.test(latest)) {
-        console.error(`[autoUpdate] Rejecting invalid version "${latest}" for ${pkg}`);
+        console.error(
+          `[autoUpdate] Rejecting invalid version "${latest}" for ${pkg}`
+        );
         continue;
       }
       toInstall.push(`${pkg}@${latest}`);
@@ -4287,11 +4298,14 @@ async function autoUpdate(packages = ["botinabox", "latticesql"], opts) {
     execFileSync("npm", ["install", ...toInstall], {
       cwd: process.cwd(),
       stdio: opts?.quiet ? "ignore" : "inherit",
-      timeout: 6e4
+      timeout: 6e4,
+      shell: process.platform === "win32"
     });
     result.updated = true;
     result.restartRequired = true;
-    log(`[autoUpdate] Updated successfully. Restart required for changes to take effect.`);
+    log(
+      `[autoUpdate] Updated successfully. Restart required for changes to take effect.`
+    );
   } catch (err) {
     console.error("[autoUpdate] Failed to install updates:", err);
   }

package/package.json

@@ -1,99 +1,100 @@
-{
-  "name": "botinabox",
-  "version": "2.4.3",
-  "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",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "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.4.0",
-    "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.5.1",
+  "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",
+    "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.4.0",
+    "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"
+  }
+}

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

@@ -1,32 +0,0 @@
-/**
- * DiscordAdapter — ChannelAdapter implementation for Discord.
- * Story 4.6
- */
-import type { ChannelAdapter, ChannelCapabilities, ChannelMeta, ChannelConfig, InboundMessage, OutboundPayload, SendResult, HealthStatus } from "../../shared/index.js";
-/** Minimal Discord client interface for mockability. */
-export interface DiscordClient {
-    sendMessage(channelId: string, content: string): Promise<{
-        id: string;
-    }>;
-}
-export declare class DiscordAdapter implements ChannelAdapter {
-    readonly id = "discord";
-    readonly meta: ChannelMeta;
-    readonly capabilities: ChannelCapabilities;
-    onMessage?: (message: InboundMessage) => Promise<void>;
-    private connected;
-    private config;
-    private client;
-    constructor(client?: DiscordClient);
-    connect(config: ChannelConfig): Promise<void>;
-    disconnect(): Promise<void>;
-    healthCheck(): Promise<HealthStatus>;
-    send(target: {
-        peerId: string;
-        threadId?: string;
-    }, payload: OutboundPayload): Promise<SendResult>;
-    /** Simulate receiving an inbound message (for testing/webhooks). */
-    receive(event: Record<string, unknown>): Promise<void>;
-}
-/** Factory function — default export for auto-discovery. */
-export default function createDiscordAdapter(client?: DiscordClient): DiscordAdapter;

package/dist/channels/discord/adapter.js

@@ -1,70 +0,0 @@
-/**
- * DiscordAdapter — ChannelAdapter implementation for Discord.
- * Story 4.6
- */
-import { formatForDiscord } from "./outbound.js";
-export class DiscordAdapter {
-    id = "discord";
-    meta = {
-        displayName: "Discord",
-        icon: "https://discord.com/favicon.ico",
-        homepage: "https://discord.com",
-    };
-    capabilities = {
-        chatTypes: ["direct", "group", "channel"],
-        threads: true,
-        reactions: true,
-        editing: true,
-        media: true,
-        polls: false,
-        maxTextLength: 2000,
-        formattingMode: "markdown",
-    };
-    onMessage;
-    connected = false;
-    config = null;
-    client;
-    constructor(client) {
-        this.client = client ?? null;
-    }
-    async connect(config) {
-        this.config = config;
-        this.connected = true;
-    }
-    async disconnect() {
-        this.connected = false;
-        this.config = null;
-    }
-    async healthCheck() {
-        return { ok: this.connected };
-    }
-    async send(target, payload) {
-        if (!this.connected) {
-            return { success: false, error: "Not connected" };
-        }
-        const text = formatForDiscord(payload.text);
-        if (this.client) {
-            try {
-                const result = await this.client.sendMessage(target.peerId, text);
-                return { success: true, messageId: result.id };
-            }
-            catch (err) {
-                return { success: false, error: String(err) };
-            }
-        }
-        // No-op when no client provided
-        return { success: true };
-    }
-    /** Simulate receiving an inbound message (for testing/webhooks). */
-    async receive(event) {
-        if (this.onMessage) {
-            const { parseDiscordEvent } = await import("./inbound.js");
-            const msg = parseDiscordEvent(event);
-            await this.onMessage(msg);
-        }
-    }
-}
-/** Factory function — default export for auto-discovery. */
-export default function createDiscordAdapter(client) {
-    return new DiscordAdapter(client);
-}

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

@@ -1,25 +0,0 @@
-/**
- * Discord inbound message parsing.
- * Story 4.6
- */
-import type { InboundMessage } from "../../shared/index.js";
-export interface DiscordEvent {
-    id?: string;
-    channel_id?: string;
-    guild_id?: string;
-    author?: {
-        id?: string;
-        username?: string;
-    };
-    content?: string;
-    message_reference?: {
-        message_id?: string;
-        channel_id?: string;
-    };
-    timestamp?: string;
-    [key: string]: unknown;
-}
-/**
- * Parse a Discord message event into an InboundMessage.
- */
-export declare function parseDiscordEvent(event: DiscordEvent): InboundMessage;

package/dist/channels/discord/inbound.js

@@ -1,24 +0,0 @@
-/**
- * Discord inbound message parsing.
- * Story 4.6
- */
-/**
- * Parse a Discord message event into an InboundMessage.
- */
-export function parseDiscordEvent(event) {
-    const id = event.id ?? `discord-${Date.now()}`;
-    const channel = event.channel_id ?? "unknown";
-    const from = event.author?.id ?? "unknown";
-    const body = event.content ?? "";
-    const replyToId = event.message_reference?.message_id;
-    const receivedAt = event.timestamp ?? new Date().toISOString();
-    return {
-        id,
-        channel,
-        from,
-        body,
-        replyToId,
-        receivedAt,
-        raw: event,
-    };
-}

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

@@ -1,8 +0,0 @@
-/**
- * Discord channel configuration types.
- * Story 4.6
- */
-export interface DiscordConfig {
-    token: string;
-    guildId?: string;
-}

package/dist/channels/discord/models.js

@@ -1,5 +0,0 @@
-/**
- * Discord channel configuration types.
- * Story 4.6
- */
-export {};