chore(compass-assistant): add compass AI assistant with placeholders COMPASS-9603

packages/compass-assistant/.depcheckrc

@@ -0,0 +1,11 @@
+ignores:
+ - '@mongodb-js/prettier-config-compass'
+ - '@mongodb-js/tsconfig-compass'
+ - '@types/chai'
+ - '@types/sinon-chai'
+ - 'sinon'
+ - '@types/chai-dom'
+ - '@types/react'
+ - '@types/react-dom'
+ignore-patterns:
+ - 'dist'

packages/compass-assistant/.eslintignore

@@ -0,0 +1,2 @@
+.nyc-output
+dist

packages/compass-assistant/.eslintrc.js

@@ -0,0 +1,8 @@
+module.exports = {
+  root: true,
+  extends: ['@mongodb-js/eslint-config-compass/plugin'],
+  parserOptions: {
+    tsconfigRootDir: __dirname,
+    project: ['./tsconfig-lint.json'],
+  },
+};

packages/compass-assistant/.mocharc.js

@@ -0,0 +1 @@
+module.exports = require('@mongodb-js/mocha-config-compass/compass-plugin');

packages/compass-assistant/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@mongodb-js/compass-assistant",
+  "description": "Compass plugin for the AI Assistant",
+  "author": {
+    "name": "MongoDB Inc",
+    "email": "[email protected]"
+  },
+  "private": true,
+  "bugs": {
+    "url": "https://jira.mongodb.org/projects/COMPASS/issues",
+    "email": "[email protected]"
+  },
+  "homepage": "https://github.com/mongodb-js/compass",
+  "version": "1.0.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mongodb-js/compass.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "SSPL",
+  "main": "dist/index.js",
+  "compass:main": "src/index.tsx",
+  "exports": {
+    "import": "./dist/.esm-wrapper.mjs",
+    "require": "./dist/index.js"
+  },
+  "compass:exports": {
+    ".": "./src/index.tsx"
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "bootstrap": "npm run compile",
+    "compile": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig-lint.json --noEmit",
+    "eslint": "eslint-compass",
+    "prettier": "prettier-compass",
+    "lint": "npm run eslint . && npm run prettier -- --check .",
+    "depcheck": "compass-scripts check-peer-deps && depcheck",
+    "check": "npm run typecheck && npm run lint && npm run depcheck",
+    "check-ci": "npm run check",
+    "test": "mocha",
+    "test-electron": "xvfb-maybe electron-mocha --no-sandbox",
+    "test-cov": "nyc --compact=false --produce-source-map=false -x \"**/*.spec.*\" --reporter=lcov --reporter=text --reporter=html npm run test",
+    "test-watch": "npm run test -- --watch",
+    "test-ci": "npm run test-cov",
+    "test-ci-electron": "npm run test-electron",
+    "reformat": "npm run eslint . -- --fix && npm run prettier -- --write ."
+  },
+  "dependencies": {
+    "@ai-sdk/openai": "^2.0.4",
+    "@mongodb-js/compass-components": "^1.30.5",
+    "@mongodb-js/compass-logging": "^1.7.10",
+    "@mongodb-js/compass-app-registry": "^9.4.18",
+    "ai": "^5.0.5",
+    "compass-preferences-model": "^2.49.0",
+    "react": "^17.0.2",
+    "use-sync-external-store": "^1.5.0"
+  },
+  "devDependencies": {
+    "react-dom": "^17.0.2",
+    "throttleit": "^2.1.0",
+    "@mongodb-js/eslint-config-compass": "^1.4.5",
+    "@mongodb-js/mocha-config-compass": "^1.7.0",
+    "@mongodb-js/prettier-config-compass": "^1.2.8",
+    "@mongodb-js/testing-library-compass": "^1.3.8",
+    "@mongodb-js/tsconfig-compass": "^1.2.9",
+    "@types/chai": "^4.2.21",
+    "@types/chai-dom": "^0.0.10",
+    "@types/mocha": "^9.0.0",
+    "@types/react": "^17.0.5",
+    "@types/react-dom": "^17.0.10",
+    "@types/sinon-chai": "^3.2.5",
+    "chai": "^4.3.6",
+    "depcheck": "^1.4.1",
+    "mocha": "^10.2.0",
+    "nyc": "^15.1.0",
+    "sinon": "^17.0.1",
+    "typescript": "^5.8.3",
+    "xvfb-maybe": "^0.2.1"
+  },
+  "is_compass_plugin": true
+}

packages/compass-assistant/src/@ai-sdk/react/chat.react.ts

@@ -0,0 +1,149 @@
+// Copyright 2023 Vercel, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import {
+  AbstractChat,
+  type ChatInit,
+  type ChatState,
+  type ChatStatus,
+  type UIMessage,
+} from 'ai';
+import { throttle } from './throttle';
+
+class ReactChatState<UI_MESSAGE extends UIMessage>
+  implements ChatState<UI_MESSAGE>
+{
+  #messages: UI_MESSAGE[];
+  #status: ChatStatus = 'ready';
+  #error: Error | undefined = undefined;
+
+  #messagesCallbacks = new Set<() => void>();
+  #statusCallbacks = new Set<() => void>();
+  #errorCallbacks = new Set<() => void>();
+
+  constructor(initialMessages: UI_MESSAGE[] = []) {
+    this.#messages = initialMessages;
+  }
+
+  get status(): ChatStatus {
+    return this.#status;
+  }
+
+  set status(newStatus: ChatStatus) {
+    this.#status = newStatus;
+    this.#callStatusCallbacks();
+  }
+
+  get error(): Error | undefined {
+    return this.#error;
+  }
+
+  set error(newError: Error | undefined) {
+    this.#error = newError;
+    this.#callErrorCallbacks();
+  }
+
+  get messages(): UI_MESSAGE[] {
+    return this.#messages;
+  }
+
+  set messages(newMessages: UI_MESSAGE[]) {
+    this.#messages = [...newMessages];
+    this.#callMessagesCallbacks();
+  }
+
+  pushMessage = (message: UI_MESSAGE) => {
+    this.#messages = this.#messages.concat(message);
+    this.#callMessagesCallbacks();
+  };
+
+  popMessage = () => {
+    this.#messages = this.#messages.slice(0, -1);
+    this.#callMessagesCallbacks();
+  };
+
+  replaceMessage = (index: number, message: UI_MESSAGE) => {
+    this.#messages = [
+      ...this.#messages.slice(0, index),
+      // We deep clone the message here to ensure the new React Compiler (currently in RC) detects deeply nested parts/metadata changes:
+      this.snapshot(message),
+      ...this.#messages.slice(index + 1),
+    ];
+    this.#callMessagesCallbacks();
+  };
+
+  snapshot = <T>(value: T): T => structuredClone(value);
+
+  '~registerMessagesCallback' = (
+    onChange: () => void,
+    throttleWaitMs?: number
+  ): (() => void) => {
+    const callback = throttleWaitMs
+      ? throttle(onChange, throttleWaitMs)
+      : onChange;
+    this.#messagesCallbacks.add(callback);
+    return () => {
+      this.#messagesCallbacks.delete(callback);
+    };
+  };
+
+  '~registerStatusCallback' = (onChange: () => void): (() => void) => {
+    this.#statusCallbacks.add(onChange);
+    return () => {
+      this.#statusCallbacks.delete(onChange);
+    };
+  };
+
+  '~registerErrorCallback' = (onChange: () => void): (() => void) => {
+    this.#errorCallbacks.add(onChange);
+    return () => {
+      this.#errorCallbacks.delete(onChange);
+    };
+  };
+
+  #callMessagesCallbacks = () => {
+    this.#messagesCallbacks.forEach((callback) => callback());
+  };
+
+  #callStatusCallbacks = () => {
+    this.#statusCallbacks.forEach((callback) => callback());
+  };
+
+  #callErrorCallbacks = () => {
+    this.#errorCallbacks.forEach((callback) => callback());
+  };
+}
+
+export class Chat<
+  UI_MESSAGE extends UIMessage
+> extends AbstractChat<UI_MESSAGE> {
+  #state: ReactChatState<UI_MESSAGE>;
+
+  constructor({ messages, ...init }: ChatInit<UI_MESSAGE>) {
+    const state = new ReactChatState(messages);
+    super({ ...init, state });
+    this.#state = state;
+  }
+
+  '~registerMessagesCallback' = (
+    onChange: () => void,
+    throttleWaitMs?: number
+  ): (() => void) =>
+    this.#state['~registerMessagesCallback'](onChange, throttleWaitMs);
+
+  '~registerStatusCallback' = (onChange: () => void): (() => void) =>
+    this.#state['~registerStatusCallback'](onChange);
+
+  '~registerErrorCallback' = (onChange: () => void): (() => void) =>
+    this.#state['~registerErrorCallback'](onChange);
+}

packages/compass-assistant/src/@ai-sdk/react/throttle.ts

@@ -0,0 +1,22 @@
+// Copyright 2023 Vercel, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import throttleFunction from 'throttleit';
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function throttle<T extends (...args: any[]) => any>(
+  fn: T,
+  waitMs: number | undefined
+): T {
+  return waitMs !== undefined ? throttleFunction(fn, waitMs) : fn;
+}