AI Chat Components

AGENTS.md

@@ -86,6 +86,8 @@ git config core.hooksPath .githooks
 Optimize PNG screenshots with `pngquant --quality=65-85 --strip --force --ext .png <file>`.
 See `CONTRIBUTING.md` for the full table. Bypass (rarely) with `git commit --no-verify`.
 
+Screenshots are captured at **2x** and declared at half their pixel width (`image::foo.png[width="413"]` for an 826px-wide file), so they stay sharp on high-DPI displays. `tools/screenshot-2x.mjs` does this: it drives Playwright directly with `deviceScaleFactor: 2` and captures a single element, which the Playwright MCP tool cannot do — its resize action takes a width and a height only, so every capture it makes is 1x. Run it with `--url`, `--selector` and `--out`; it prints the resulting pixel size and the width to declare. See the comment at the top of the file for the rest of its options.
+
 ## Conventions
 
 - In multi-locale examples use German (`de`) as the secondary locale.

build.gradle

@@ -1,6 +1,7 @@
 ext.jmixCompositeProjectRoot = true
 
 def projectNames = [
+        'ai-chat-ex1',
         'audit-ex1',
         'authserver-ex1',
         'bpm-ex1',

content/modules/ROOT/nav.adoc

@@ -39,6 +39,7 @@ include::bpm:partial$nav.adoc[]
 * xref:ROOT:add-ons.adoc[]
 +
 --
+include::ai-chat:partial$nav.adoc[]
 include::ai-tools:partial$nav.adoc[]
 include::appsettings:partial$nav.adoc[]
 include::audit:partial$nav.adoc[]

content/modules/ai-chat/examples/ai-chat-ex1/.gitignore

@@ -0,0 +1,35 @@
+.jmix
+
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**
+!**/src/test/**
+
+# Remove this line if you want to follow recommendations in src/main/bundles/README.md
+src/main/bundles/
+
+### IntelliJ IDEA ###
+.idea/*
+!.idea/encodings.xml
+*.iws
+*.iml
+*.ipr
+out/
+/target/
+
+### VS Code ###
+.vscode/
+
+# The following files are generated/updated by vaadin-gradle-plugin
+node_modules/
+src/main/frontend/generated/
+pnpmfile.js
+vite.generated.ts
+webpack.generated.js
+
+.DS_Store
+
+.agents/
+.claude/
+.skills/

content/modules/ai-chat/examples/ai-chat-ex1/README.md

@@ -0,0 +1,44 @@
+# Ai Chat Ex1
+
+This is a web application based on the [Jmix](https://www.jmix.io) framework.
+
+## Getting Started
+
+The newly created project requires Java 21 and uses the embedded HSQL database.
+
+Use the following resources to learn more about Jmix:
+* [Jmix Documentation](https://docs.jmix.io)
+* [Online Demo Applications](https://www.jmix.io/live-demo)
+* [Jmix AI Assistant](https://ai-assistant.jmix.io) (also available in the **Jmix AI** tool window of IntelliJ IDEA)
+
+## Development
+
+- [Setup](https://docs.jmix.io/jmix/setup.html) your development environment.
+- [Open](https://docs.jmix.io/jmix/studio/project.html#opening-existing-project) the project in the IDE.
+- If you want to use AI agents to develop the application, check out the [Jmix AI Agent Guidelines](https://github.com/jmix-framework/jmix-agent-guidelines) repository.
+
+## Running
+
+To start the application, use the **Ai Chat Ex1 Jmix Application** run configuration in your IDE, or run the following command in the project root directory:
+
+```bash
+./gradlew bootRun
+```
+
+The application will be available at <http://localhost:8080>.
+
+The default user credentials are:
+* Login: `admin`
+* Password: `admin`
+
+**WARNING**: Change admin password and remove `ui.login.defaultUsername` and `ui.login.defaultPassword` application properties when deploying the application to production.
+
+## The language model
+
+The chat views talk to a local [Ollama](https://ollama.com) server. Nothing is contacted at startup, so the application runs without it — a chat reports the failure on the first message instead.
+
+Attachments need a model that accepts them. The default `qwen3:8b` handles text only and refuses any attached file — a plain text file as readily as an image — so the Attachments view reports an error until you point the application at a [multimodal model](https://ollama.com/search?c=vision):
+
+```bash
+OLLAMA_CHAT_MODEL=<model> ./gradlew bootRun
+```

content/modules/ai-chat/examples/ai-chat-ex1/build.gradle

@@ -0,0 +1,83 @@
+plugins {
+    id 'io.jmix' version '3.1.0-M1'
+    id 'java'
+    id 'org.jetbrains.gradle.plugin.idea-ext' version '1.4.1'
+}
+
+apply plugin: 'org.springframework.boot'
+apply plugin: 'com.vaadin'
+
+jmix {
+    bomVersion = '3.1.999-SNAPSHOT'
+}
+
+group = 'com.company'
+version = '0.0.1-SNAPSHOT'
+
+repositories {
+    mavenCentral()
+    mavenLocal()
+    maven {
+        url = 'https://nexus.jmix.io/repository/public'
+    }
+    maven {
+        url = 'https://nexus.jmix.io/repository/premium'
+        credentials {
+            username = rootProject['premiumRepoUser']
+            password = rootProject['premiumRepoPass']
+        }
+    }
+}
+
+dependencies {
+    implementation 'io.jmix.core:jmix-core-starter'
+    implementation 'io.jmix.data:jmix-eclipselink-starter'
+    implementation 'io.jmix.security:jmix-security-starter'
+    implementation 'io.jmix.security:jmix-security-flowui-starter'
+    implementation 'io.jmix.security:jmix-security-data-starter'
+    implementation 'io.jmix.localfs:jmix-localfs-starter'
+    implementation 'io.jmix.flowui:jmix-flowui-starter'
+    implementation 'io.jmix.flowui:jmix-flowui-data-starter'
+    implementation 'io.jmix.flowui:jmix-flowui-themes'
+    implementation 'io.jmix.datatools:jmix-datatools-starter'
+    implementation 'io.jmix.datatools:jmix-datatools-flowui-starter'
+
+    // tag::dependencies[]
+    implementation 'io.jmix.aichat:jmix-aichat-flowui-starter'
+    // end::dependencies[]
+
+    // tag::provider-dependencies[]
+    implementation 'org.springframework.ai:spring-ai-starter-model-ollama'
+    // end::provider-dependencies[]
+
+    implementation 'org.springframework.boot:spring-boot-starter-web'
+    implementation 'com.vaadin:vaadin-dev'
+
+    runtimeOnly 'org.hsqldb:hsqldb'
+
+    testImplementation('org.springframework.boot:spring-boot-starter-test') {
+        exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
+    }
+    testImplementation 'io.jmix.flowui:jmix-flowui-test-assist'
+}
+
+configurations.implementation {
+    exclude group: 'com.vaadin', module: 'hilla'
+    exclude group: 'com.vaadin', module: 'hilla-dev'
+    exclude group: 'com.vaadin', module: 'copilot'
+}
+
+test {
+    useJUnitPlatform()
+}
+
+idea {
+    module {
+        excludeDirs.addAll(files '.jmix', 'node_modules', 'src/main/frontend/generated/', 'src/main/bundles')
+    }
+}
+
+vaadin {
+    optimizeBundle = false
+    productionMode = false
+}

content/modules/ai-chat/examples/ai-chat-ex1/gradle.properties

@@ -0,0 +1,2 @@
+hilla.active=false
+org.gradle.jvmargs=-Xmx2g -Dfile.encoding=UTF-8

content/modules/ai-chat/examples/ai-chat-ex1/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,9 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.5.1-bin.zip
+networkTimeout=10000
+retries=0
+retryBackOffMs=500
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists