AEL Docs
Follow updates
Menu
Follow updates
Browse the documentation

AEL 1.0.0

Standard library and core types

The standard library of AEL, the Agent Engineering Language, comes with the language: the core types, the operations on them, and the clients a program needs to reach models and web APIs, with no package to add. This section describes the standard library of AEL 1.0.0, one subject per page.

The pages

  • Numbers

    The integer types, their literals and operators, wrapping and saturating operations, and checked conversions.

  • Text and collections

    Bounded text, bounded lists and fixed arrays, and the operations on each.

  • Results and errors

    Option, Result, the built-in error types, and how library operations report failure.

  • Console and logging

    Printing, console input, the time and token summary, and structured logs.

  • Time

    Monotonic and wall-clock time, deadlines, timers and schedules.

  • Files and processes

    Reading and writing files, and running your own programs as typed tools.

  • HTTP client

    Calling web APIs over HTTP and HTTPS without a server package.

  • Model client

    The built-in client for OpenAI-compatible model APIs.

  • JSON

    How typed values are read from and written to JSON.

  • Testing

    Tests, mock and recorded model responses, and prompt evaluations.

What the library gives you

  • Predictable memory. Collections have a fixed capacity, written in their type, a full collection returns an explicit result, and small devices need no heap.
  • Models without extra software. A built-in client for OpenAI-compatible APIs, including realtime sessions, comes with the language, with explicit or default parameters and no server or SDK to add.
  • Many requests, few threads. A multi-core, nonblocking runtime needs no thread per user, and programs that don't need worker threads don't get them.
  • Failures you can see. Operations that can fail return a typed result that you handle, and each page states the limits of what it describes.

How this reference names operations

Each page describes an operation by what it does, what it takes and what it returns. The types are named as you write them, such as Str<N>, Vec<T, N> and Result<T, E>, and Types in the language guide introduces each of them. The examples in this section show types, declarations and the handling of results rather than calls to named library operations.

Described elsewhere