luigidemasi opened a new pull request, #27494:
URL: https://github.com/apache/camel/pull/27494

   # Description
   
   The semantic language currently assumes instruction-driven boolean, choice 
and score evaluations. This change lets each expert declare a static contract 
for its operations, accepted input shapes, parameters and result meaning. Camel 
validates that contract; the expert owns omitted defaults and applies decision 
policy exactly once.
   
   - Add operation and parameter annotations, structured input, and 
classification results alongside boolean, choice and score results.
   - Support named evaluations and nested typed parameters consistently in 
Java, YAML and XML, with validation before startup or publication of 
replacements.
   - Add `${semantic('name')}` to Simple, preserving typed values and requiring 
a boolean operation when used as a bare predicate.
   - Migrate TypeSafe AI to the contract, including its threshold and 
uncertainty policy, and update documentation, generated schemas and catalog 
metadata.
   
   Validation on the rebased commit:
   
   - Full root `mvnd -B -ntp -Dmaven.build.cache.enabled=false clean install 
-DskipTests`: 699 modules passed; no generated-file drift.
   - `camel-semantic`: 237 tests; `camel-typesafe-ai`: 198 tests.
   - YAML DSL: 463 tests; YAML validator: 222 tests.
   - Focused Simple regression suite: 61 tests. All 1,181 tests passed with no 
failures, errors or skips.
   - `-Psourcecheck` validation passed for the eight affected runtime, DSL and 
catalog modules.
   
   Regression coverage includes boolean-only Simple predicates, TypeSafe 
uncertainty-band boundaries and policies, criteria collisions, structured 
inputs, declaration replacement and YAML reload, parameter placeholders, and 
schema constraints.
   
   # Target
   
   - [x] The change targets `main` (Camel 4).
   
   # Tracking
   
   - [x] Tracked by 
[CAMEL-25382](https://issues.apache.org/jira/browse/CAMEL-25382).
   
   # Apache Camel coding standards and style
   
   - [x] The single signed commit has a meaningful subject and body.
   - [x] Ran the full root `clean install -DskipTests` build using `mvnd`, and 
all generated changes are committed.
   
   # AI-assisted contributions
   
   - [x] The commit includes AI co-authorship attribution and a Signed-off-by 
trailer. This contribution was prepared with Codex on behalf of @luigidemasi.
   
   Generated by Codex via /oss-fix-issue
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to