Two-action support reference

This reference selects billing support, technical support, or no_match. The bundled native Kamelets return strings and perform no backend operations.

Build Barn:

mvn verify -DskipUI

Start Barn with an isolated local data directory:

java -Dwanaku.home=/tmp/barn-semantic-reference \
  -Dquarkus.http.port=8180 \
  -jar apps/wanaku-barn-backend/target/quarkus-app/quarkus-run.jar

Create a definition:

curl --fail-with-body -H 'Content-Type: application/json' \
  --data-binary @examples/semantic-router/reference-definition.json \
  http://127.0.0.1:8180/api/v1/semantic-routers

Read the returned data.id. Publish that definition with POST /api/v1/semantic-routers/{id}/publish. Download the returned catalog name through GET /api/v1/service-catalog/download?name={catalogName}. Decode data.data as a Base64 ZIP.

Set TYPESAFE_API_KEY in the WSR process environment. Start WSR from its checkout with the saved route name:

java -jar target/wanaku-semantic-router-0.1.0-SNAPSHOT.jar runtime --semantic-route support-route

Replace support-route with the name in your saved definition. The local defaults use Barn at http://localhost:8180 and Wanaku management at http://localhost:8080. WSR resolves the current published catalog and its expert snapshot. It verifies the fixed revision and SHA-256 before startup. It checks MCP readiness before registration with Wanaku. It keeps the publication until restart. Set TYPESAFE_MODEL to override the component's default model. Kubernetes can supply the route and service addresses through WSR_* environment settings. Use the WSR deployment guide for the manifest and explicit catalog options. Use the WSR dependency lock for the exact tested Camel build. Barn generates semantic.evaluation.department with operation: choice and instructions and criteria under parameters. The bundled schema comes from Camel 4.23.0-20261009.103642-37, including PR #27494. contract.version stays 1; camel.build is an optional build hint. Republish existing definitions to create evaluation-era revisions and restart WSR against the new revision; old archives remain immutable.

Use the dedicated WSR preview service for classification tests. Set Barn's wanaku.semantic.preview-url to its /api/v1/preview endpoint. Send {"message":"I have a question about my invoice."} to Barn's POST /api/v1/semantic-routers/{id}/preview. Barn sends expertBean, operation: "choice", parameters containing instructions and criteria, and state containing the message. The preview must return billing without executing a Kamelet.

The reference covers both branches, explicit no-match, provider failure, and malformed output through deterministic native Camel fixtures in WSR. The cross-repository acceptance test publishes through Barn, downloads and verifies the ZIP in WSR, initializes MCP, invokes the tool through Wanaku, and checks policy denial before dispatch.

See the contract and the wizard guide.