TeaQL gives developers and Coding Agents one continuous, verifiable path: create a typed domain model, evaluate it, generate a domain library and application workspace, then request model-aware API help while coding.
Point cargo teaql or another TeaQL client at this service. Coding Agents use the client instead of calling undocumented framework APIs directly.
export TEAQL_ENDPOINT_PREFIX=http://localhost:8080/
A business requirement becomes a saved, reviewable KSML domain contract before application code is generated.
Build merchant onboarding. Each merchant belongs to a platform. Track tax number, address, external ID, creation time, and last update time.
Clarifies objects, representative values, relationships, constants, ownership, and provider choice, then saves the result as XML/KSML.
The model path—not a chat transcript—is the artifact used for evaluation, review, and regeneration.
KSML uses concrete example values to describe fields and explicit function-like values to describe references and generated behaviors.
<root name="crm-erp-service"
org="doublechaintech"
data_service="postgres">
<platform
name="CRPERPPlatform"
create_time="createTime()"
last_update_time="updateTime()" />
<merchant
name="Global Logistics Corporation"
tax_number="91XXXXXXXXXXXXX"
platform="platform()"
create_time="createTime()"
update_time="updateTime()" />
</root>
Representative values allow the evaluator and generator to infer supported field types. References such as platform() connect business objects. Metadata can add display names, modules, constants, identifiers, and ownership boundaries.
The service returns a Markdown report with Errors, Warnings, Suggestions, and confirmed solid areas.
Evaluation Report ├── Errors must be fixed ├── Warnings require a decision ├── Suggestions optional improvements └── Solid Areas preserve these sections
Generation is blocked when the submitted model contains evaluation Errors. Repair the model, evaluate again, and keep the report as evidence.
Generate the stable domain library separately from the editable application workspace.
java-lib-core — Java entities, requests, expressions, metadata, and runtime registration.rust-lib-core — Rust entities, typed requests, expressions, behaviors, checkers, and providers.java-app-consolejava-web-spring-bootjava-web-quarkusjava-web-micronautrust-app-consolerust-web-axumrust-web-topcoatdoc — data-design documentation and visual previews.agent — generated Coding Agent instructions.evaluation and mergemodel — evaluation assets and model composition.cargo teaql rust-lib-core \ --input model/main.xml \ --output generated/rust-lib-core
cargo teaql rust-web-topcoat \ --input model/main.xml \ --output generated/rust-web-topcoat
The Agent asks for help using the current model, language, action, and exact object name. The response is generated Markdown, not a generic ORM example.
cargo teaql \ --input model/main.xml \ rust-assist-query/merchant
The same pattern supports create, update, delete, expression, list-page, debug, tool API, and runtime-customization guidance.
Generated AGENTS.md
↓
Select language + action + object
↓
Call TeaQL assist API with the model
↓
Use exact generated methods
↓
Compile, test, and request more help
purpose and comment, and attach audit_as / auditAs to writes.These previews use the built-in demo model and its platform object. Submit your own model through the CLI to receive guidance for your own objects.
| Feature / Capability | Java | Rust |
|---|---|---|
| 📚 Workspace API Guide | Preview | Preview |
| 🔹 Create Entity | Preview | Preview |
| 🔹 Update Entity | Preview | Preview |
| 🔹 Query Entity | Preview | Preview |
| 🔹 List Page | Preview | Preview |
| 🔹 Expression | Preview | Preview |
| 🔹 Delete Entity | Preview | Preview |
| 🛠️ Debug Guide | Preview | Preview |
| 🛠️ Tool API: Http | Preview | Preview |
| ⚙️ Runtime Customization | Preview | Preview |