Skip to content
@teaql

Token efficiency and AI-native components

Semantic Guardrails for AI Coding.

TeaQL

A runtime harness for AI-built business applications.

TeaQL connects a business model, generated domain APIs, and reusable runtimes. Its build-time tools help developers and AI agents evaluate models, discover APIs, and generate application foundations. Its runtime harness carries those contracts into application execution through typed requests, validation, trusted context, policy, transactions, and audit.

Start with an AI agent · Documentation · 中文

Design goals

  • Keep business meaning explicit. Use a shared domain model to describe entities, relationships, and validation, then generate APIs around that vocabulary.
  • Make capabilities discoverable. Give agents model-aware evaluation and progressive Assist for the entities and operations they are working on.
  • Carry rules into execution. Apply validation, query intent, mutation audit, and application-installed policies at the relevant TeaQL execution boundaries.
  • Support change and verification. Regenerate domain libraries as models evolve, keep application code in its own workspace, and verify behavior against explicit language, provider, and version combinations.

Build-time Harness and Runtime Harness

flowchart LR
    subgraph B["Build-time Harness"]
        direction TB
        A["teaql-agent-kit<br/>Development workflow and context governance"]
        C["cargo-teaql CLI"]
        F["teaql-forge-rs<br/>Open-source Rust generation service"]
        S["TeaQL Model-Aware Services<br/>Commercial model services"]
        A --> C
        C --> F
        C --> S
    end

    subgraph R["Runtime Harness"]
        direction TB
        W["Generated Workspace<br/>Business application"]
        T["Generated Type Library<br/>Entity · Q · E · Checker"]
        RT["TeaQL Runtime<br/>Seven language implementations"]
        O["Peripheral tools · Future directions<br/>Observability platform · Policy management · Diagnostics"]
        W --> T
        T --> RT
        RT -.-> O
    end

    B -->|"Generate domain libraries and application workspaces"| R

    style O stroke-dasharray: 5 5
Loading

Build-time Harness runs in the development environment. Agent Kit supplies the workflow and agent integrations; the CLI connects it to model services. Developers can also use the CLI independently. The open-source Forge service focuses on Rust. Commercial TeaQL Agentic Model-Aware Services provide model evaluation, seven-language domain-library generation, target-specific workspaces, and progressive Assist. Their feature sets are documented separately.

Runtime Harness is the application's execution foundation. The Workspace hosts business code and assembles its dependencies. The generated Type Library provides model-specific entities, Q queries, E expressions, and Checker rules. The selected language Runtime executes supported operations through the application's configured context and providers. Type Library and Workspace are build-time outputs that become parts of the running application; application code stays editable, and domain-library changes come from the model and regeneration.

Projects

Project Role
teaql-agent-kit Build TeaQL App Skill, Agent Context Kit, and host integrations. Enforcement depends on the adapter and entry point.
teaql-cargo-cli The cargo-teaql client for model-service discovery, evaluation, generation, and Assist.
teaql-forge-rs A local-first, open-source Rust generation service.
TeaQL Agentic Model-Aware Services Commercial model-intelligence services, including generation and API guidance.

The seven Runtime implementations share an architectural contract and retain their own language APIs, providers, releases, and verification boundaries:

Language Runtime repository
Java teaql-java
Rust teaql-rs
TypeScript teaql-ts
Go teaql-golang
Python teaql-python
.NET teaql-dotnet
Swift teaql-swift

Current status and future directions

The Agent Kit, CLI, open-source Forge, commercial model services, and seven Runtime implementations form the current project landscape. Generated workspaces depend on the selected target; Swift currently has domain-library generation without a separate application-workspace target.

Runtime telemetry, execution traces, structured logs, and audit already provide a foundation for inspecting application behavior. Independent observability products, policy-management tools, and operational diagnostics are future directions shown with a dashed border in the diagram. Audit and telemetry retain separate responsibilities. See Debugging, Audit, and Observability for the existing runtime facilities.

Published packages, generator-selected versions, and verified application scenarios have separate status. Use Latest Versions and the language guides to choose a starting point. Cross-language conformance checks, retained scenario evidence, and performance experiments support verification; each result applies to its recorded scope.

Build your first application

Start with TeaQL Agent Kit. Describe a small business application and choose a language and database. Follow the model → evaluate → generate → implement → verify workflow, then inspect the application's actual build, query, and audited mutation results.

Pinned Loading

  1. teaql-agent-kit teaql-agent-kit Public

    A model-driven harness for AI coding agents: semantic modeling, app generation, progressive API Assist and evidence-based verification.

    TypeScript 2.8k 953

  2. teaql-rs teaql-rs Public

    AI-native Rust library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    Rust 15

  3. teaql-java teaql-java Public

    AI-native Java library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    Java 10 1

  4. teaql-dotnet teaql-dotnet Public

    AI-native C#/.NET library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    C# 1 1

  5. teaql-golang teaql-golang Public

    AI-native Go library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    Go 1 1

  6. teaql-python teaql-python Public

    AI-native Python library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    Python 1 1

Repositories

Showing 10 of 32 repositories
  • teaql-swift Public

    AI-native Swift library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    teaql/teaql-swift's past year of commit activity
    Swift 1 MIT 0 21 2 Updated Nov 20, 2026
  • teaql-dotnet Public

    AI-native C#/.NET library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    teaql/teaql-dotnet's past year of commit activity
    C# 1 Apache-2.0 1 21 1 Updated Nov 20, 2026
  • teaql-python Public

    AI-native Python library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    teaql/teaql-python's past year of commit activity
    Python 1 Apache-2.0 1 22 2 Updated Nov 20, 2026
  • teaql-java Public

    AI-native Java library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    teaql/teaql-java's past year of commit activity
    Java 10 Apache-2.0 1 43 22 Updated Nov 20, 2026
  • teaql-ts Public

    AI-native TypeScript library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    teaql/teaql-ts's past year of commit activity
    TypeScript 2 Apache-2.0 0 25 1 Updated Nov 20, 2026
  • teaql-rs Public

    AI-native Rust library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    teaql/teaql-rs's past year of commit activity
    Rust 15 Apache-2.0 0 52 17 Updated Nov 20, 2026
  • .github Public

    TeaQL organization profile: build-time tools, runtime harness, and project directory.

    teaql/.github's past year of commit activity
    0 0 0 0 Updated Nov 20, 2026
  • teaql-golang Public

    AI-native Go library and runtime for business apps: model-driven, typed SQL queries, safe expressions and audited graph mutations.

    teaql/teaql-golang's past year of commit activity
    Go 1 Apache-2.0 1 22 1 Updated Nov 20, 2026
  • teaql/teaql-python-examples's past year of commit activity
    Python 0 Apache-2.0 0 0 0 Updated Nov 20, 2026
  • teaql-cpp Public
    C++ 1 Apache-2.0 0 0 0 Updated Nov 20, 2026

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…