@stack-spot/ai-chat-widget 0.10.0 → 1.0.0-dev.1768314799914

package/src/app-metadata.json

@@ -0,0 +1,171 @@
+{
+  "name": "@stack-spot/ai-chat-widget",
+  "version": "1.0.0-dev.1768314799914",
+  "date": "Tue Jan 13 2026 14:33:24 GMT+0000 (Coordinated Universal Time)",
+  "dependencies": [
+    {
+      "name": "@stack-spot/app-metadata",
+      "version": "1.0.1"
+    },
+    {
+      "name": "@types/lodash",
+      "version": "4.17.9"
+    },
+    {
+      "name": "@types/react",
+      "version": "18.3.11"
+    },
+    {
+      "name": "@types/react-dom",
+      "version": "18.3.0"
+    },
+    {
+      "name": "@types/react-syntax-highlighter",
+      "version": "15.5.13"
+    },
+    {
+      "name": "@typescript-eslint/eslint-plugin",
+      "version": "6.21.0(@typescript-eslint/parser@6.21.0(eslint@8.57.1)(typescript@5.6.2))(eslint@8.57.1)(typescript@5.6.2)"
+    },
+    {
+      "name": "@typescript-eslint/parser",
+      "version": "6.21.0(eslint@8.57.1)(typescript@5.6.2)"
+    },
+    {
+      "name": "cpy-cli",
+      "version": "5.0.0"
+    },
+    {
+      "name": "eslint",
+      "version": "8.57.1"
+    },
+    {
+      "name": "eslint-plugin-filenames",
+      "version": "1.3.2(eslint@8.57.1)"
+    },
+    {
+      "name": "eslint-plugin-import",
+      "version": "2.30.0(@typescript-eslint/parser@6.21.0(eslint@8.57.1)(typescript@5.6.2))(eslint@8.57.1)"
+    },
+    {
+      "name": "eslint-plugin-lodash",
+      "version": "7.4.0(eslint@8.57.1)"
+    },
+    {
+      "name": "eslint-plugin-promise",
+      "version": "6.6.0(eslint@8.57.1)"
+    },
+    {
+      "name": "eslint-plugin-react",
+      "version": "7.37.1(eslint@8.57.1)"
+    },
+    {
+      "name": "eslint-plugin-react-hooks",
+      "version": "4.6.2(eslint@8.57.1)"
+    },
+    {
+      "name": "react",
+      "version": "18.2.0"
+    },
+    {
+      "name": "react-dom",
+      "version": "18.2.0(react@18.2.0)"
+    },
+    {
+      "name": "rimraf",
+      "version": "5.0.10"
+    },
+    {
+      "name": "styled-components",
+      "version": "6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)"
+    },
+    {
+      "name": "tsc-esm-fix",
+      "version": "2.20.27"
+    },
+    {
+      "name": "typescript",
+      "version": "5.6.2"
+    },
+    {
+      "name": "@citric/core",
+      "version": "6.4.0(lodash@4.17.21)(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0))"
+    },
+    {
+      "name": "@citric/icons",
+      "version": "5.13.0(react@18.2.0)"
+    },
+    {
+      "name": "@citric/ui",
+      "version": "6.10.2(@citric/core@6.4.0(lodash@4.17.21)(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)))(@citric/icons@5.13.0(react@18.2.0))(lodash@4.17.21)(react-dom@18.2.0(react@18.2.0))(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0))"
+    },
+    {
+      "name": "@dagrejs/dagre",
+      "version": "1.1.8"
+    },
+    {
+      "name": "@monaco-editor/react",
+      "version": "4.7.0(monaco-editor@0.52.2)(react-dom@18.2.0(react@18.2.0))(react@18.2.0)"
+    },
+    {
+      "name": "@stack-spot/citric-icons",
+      "version": "0.3.0"
+    },
+    {
+      "name": "@stack-spot/citric-react",
+      "version": "0.40.3(@stack-spot/citric-icons@0.3.0)(@stack-spot/portal-theme@1.2.1(@citric/core@6.4.0(lodash@4.17.21)(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)))(react-dom@18.2.0(react@18.2.0))(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)))(@stack-spot/portal-translate@2.1.0(react-dom@18.2.0(react@18.2.0))(react@18.2.0))(lodash@4.17.21)(react-dom@18.2.0(react@18.2.0))(react@18.2.0)"
+    },
+    {
+      "name": "@stack-spot/portal-components",
+      "version": "2.27.3(@citric/core@6.4.0(lodash@4.17.21)(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)))(@citric/icons@5.13.0(react@18.2.0))(@citric/ui@6.10.2(@citric/core@6.4.0(lodash@4.17.21)(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)))(@citric/icons@5.13.0(react@18.2.0))(lodash@4.17.21)(react-dom@18.2.0(react@18.2.0))(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)))(@stack-spot/portal-theme@1.2.1(@citric/core@6.4.0(lodash@4.17.21)(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)))(react-dom@18.2.0(react@18.2.0))(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)))(@stack-spot/portal-translate@2.1.0(react-dom@18.2.0(react@18.2.0))(react@18.2.0))(@types/react@18.3.11)(react-dom@18.2.0(react@18.2.0))(react@18.2.0)"
+    },
+    {
+      "name": "@stack-spot/portal-network",
+      "version": "0.212.4(@stack-spot/auth@6.1.0)(@stack-spot/opa@2.5.0(@stack-spot/auth@6.1.0)(react-dom@18.2.0(react@18.2.0))(react@18.2.0))(@stack-spot/portal-translate@2.1.0(react-dom@18.2.0(react@18.2.0))(react@18.2.0))(@tanstack/react-query@5.59.16(react@18.2.0))(react-dom@18.2.0(react@18.2.0))(react@18.2.0)"
+    },
+    {
+      "name": "@stack-spot/portal-theme",
+      "version": "1.2.1(@citric/core@6.4.0(lodash@4.17.21)(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0)))(react-dom@18.2.0(react@18.2.0))(react@18.2.0)(styled-components@6.1.10(react-dom@18.2.0(react@18.2.0))(react@18.2.0))"
+    },
+    {
+      "name": "@stack-spot/portal-translate",
+      "version": "2.1.0(react-dom@18.2.0(react@18.2.0))(react@18.2.0)"
+    },
+    {
+      "name": "@xyflow/react",
+      "version": "12.10.0(@types/react@18.3.11)(react-dom@18.2.0(react@18.2.0))(react@18.2.0)"
+    },
+    {
+      "name": "lodash",
+      "version": "4.17.21"
+    },
+    {
+      "name": "monaco-editor",
+      "version": "0.52.2"
+    },
+    {
+      "name": "react-infinite-scroll-component",
+      "version": "6.1.0(react@18.2.0)"
+    },
+    {
+      "name": "react-international-phone",
+      "version": "4.6.1(react@18.2.0)"
+    },
+    {
+      "name": "react-markdown",
+      "version": "9.0.1(@types/react@18.3.11)(react@18.2.0)"
+    },
+    {
+      "name": "react-syntax-highlighter",
+      "version": "15.5.0(react@18.2.0)"
+    },
+    {
+      "name": "remark-gfm",
+      "version": "4.0.0"
+    },
+    {
+      "name": "ulid",
+      "version": "2.4.0"
+    }
+  ]
+}

package/src/chat-interceptors/CustomInputs.ts

@@ -0,0 +1,83 @@
+import { CustomInputResponse } from '@stack-spot/portal-network/api/ai'
+import { Dictionary, translate } from '@stack-spot/portal-translate'
+import { ChatEntry } from '../state/ChatEntry'
+import { ChatState } from '../state/ChatState'
+import { LabeledWithImage } from '../state/types'
+
+const CUSTOM_INPUTS_KEY = 'customInputs'
+
+export class CustomInputs {
+  private value: Record<string, string> = {}
+  private inputs: CustomInputResponse[]
+  private index = 0
+  private resolve?: (value: Record<string, string>) => void
+  private promise: Promise<Record<string, string>>
+  private agent?: LabeledWithImage
+
+  constructor(inputs: CustomInputResponse[], agent?: LabeledWithImage) {
+    this.inputs = inputs
+    this.agent = agent
+    this.promise = new Promise(resolve => {
+      this.resolve = resolve
+    })
+  }
+
+  static getCustomInputsFromChat(chat: ChatState): CustomInputs | undefined {
+    return chat.interceptorMemory.get(CUSTOM_INPUTS_KEY)
+  }
+
+  static setCustomInputsForChat(inputs: CustomInputs, chat: ChatState): void {
+    chat.interceptorMemory.set(CUSTOM_INPUTS_KEY, inputs)
+  }
+
+  static deleteCustomInputsFromChat(chat: ChatState): void {
+    chat.interceptorMemory.delete(CUSTOM_INPUTS_KEY)
+  }
+
+  ask(): ChatEntry {
+    if (this.index >= this.inputs.length) throw new Error('No more questions to ask.')
+    const t = translate(dictionary)
+    const input = this.inputs[this.index]
+    return new ChatEntry({
+      agentType: 'bot',
+      content: input.question,
+      type: 'text',
+      agent: this.agent,
+      badges: [{ label: input.mandatory ? t.required : t.optional }],
+      card: true,
+      actions: input.mandatory ? undefined : [{ type: 'command', appearance: 'primary', title: t.skip, exec: '/skip' }],
+      updated: new Date().toISOString(),
+    })
+  }
+
+  answer(value: string) {
+    this.value[this.inputs[this.index].slug] = value
+    this.skip()
+  }
+
+  skip() {
+    this.index++
+    if (this.hasFinished()) this.resolve?.(this.value)
+  }
+
+  hasFinished() {
+    return this.index === this.inputs.length
+  }
+
+  getValue() {
+    return this.promise
+  }
+}
+
+const dictionary = {
+  en: {
+    required: 'Required information',
+    optional: 'Optional information',
+    skip: 'Skip',
+  },
+  pt: {
+    required: 'Informação obrigatória',
+    optional: 'Informação opcional',
+    skip: 'Pular',
+  },
+} satisfies Dictionary

package/src/chat-interceptors/quick-command-questions.ts

@@ -0,0 +1,25 @@
+import { ChatEntry } from '../state/ChatEntry'
+import { ChatState } from '../state/ChatState'
+import { CustomInputs } from './CustomInputs'
+
+/**
+ * This chat interceptor is responsible for interrupting the normal flow of the chat and asking questions about the variables (custom
+ * inputs) needed to run the quick command previously typed.
+ * 
+ * The first question is actually asked by the `quickCommandInterceptor`, this registers all answers and asks the next questions (if any).
+ * 
+ * @param entry the chat entry.
+ * @param chat the chat state.
+ * @returns false if, and only if, this entry is an answer to a quick command question (custom input). Undefined otherwise.
+ */
+export function quickCommandQuestionsInterceptor(entry: ChatEntry, chat: ChatState) {
+  const { agentType, content } = entry.getValue()
+  if (agentType !== 'user') return
+  const customInputs = CustomInputs.getCustomInputsFromChat(chat)
+  if (!customInputs) return
+  if (content === '/skip') customInputs.skip()
+  else customInputs.answer(content)
+  if (!customInputs.hasFinished()) chat.pushMessage(customInputs.ask())
+  // prevents next interceptors from running
+  return false
+}