Let people search the way they talk.

curl -s http://localhost:8080/api/v2/search \
  -H 'Content-Type: application/json' \
  -d '{"query":"black running shoes under 100 EUR",
       "contract":"commerce-search/1.0"}'

<dependency>
  <groupId>io.qwenbridge</groupId>
  <artifactId>qwenbridge-java-sdk</artifactId>
  <version>0.9.1</version>
</dependency>

try (var client = new CommerceClient(URI.create("http://localhost:8080"), apiKey)) {
  client.requireCompatibleServer();
  var response = client.search(
      CommerceContracts.Request.planned("black running shoes under 100 EUR"));
  response.results().hits()
      .forEach(hit -> System.out.println(hit.id() + " " + hit.score()));
}

import { CommerceClient, COMMERCE_CONTRACT_V1 } from "@qwenbridge/sdk";

const client = new CommerceClient({ baseUrl: "http://localhost:8080", bearerToken: apiKey });
await client.requireCompatibleServer();

const response = await client.search({
  query: "black running shoes under 100 EUR",
  contract: COMMERCE_CONTRACT_V1,
});
for (const hit of response.results.hits) console.log(hit.id, hit.score);

curl -N http://localhost:8080/api/v2/search/stream \
  -H 'Content-Type: application/json' -H 'Accept: text/event-stream' \
  -d '{"query":"winter jacket","contract":"commerce-search/1.0"}'

event:search.started
data:{"version":2,"kind":"search.started","requestId":"r-1","sequence":1,"terminal":false}

:heartbeat

event:search.completed
data:{"version":2,"kind":"search.completed","requestId":"r-1",
      "response":{"apiVersion":2,"status":"OK"},"sequence":2,"terminal":true}

# 1. Model server (pulls qwen2.5 and bge-m3)
docker compose up -d qwenbridge-ollama qwenbridge-ollama-init

# 2. Server, no database needed
mvn -B install -DskipTests
mvn -pl qwenbridge-server quarkus:dev

# 3. Ready?
curl -s http://localhost:8080/q/health/ready