Async, composition and contracts

Every operator a .lolo program can call, from the canonical registry the compiler bakes.

On this page

Namespaces on this page: async/, behavior/, checkpoint/, compose/, contract/, integration/, trace/.

async/

`async/all`

Execute effects in parallel, wait for all to complete

lolo

(async/all ...effects)

Parameters

Name	Type	Description
`...effects`	`expression[]`	Effects to execute

Returns: array · Runs on: any

Example

lolo

(async/all (call "api1") (call "api2"))

`async/debounce`

Debounce an event (wait for pause in events)

lolo

(async/debounce event ms)

Parameters

Name	Type	Description
`event`	`string`	Event name to emit
`ms`	`number`	Debounce delay in milliseconds

Returns: void · Runs on: any

Example

lolo

(async/debounce "SEARCH" 300)

`async/delay`

Wait for specified milliseconds, optionally execute an effect after

lolo

(async/delay ms)

Parameters

Name	Type	Description
`ms`	`number`	Milliseconds to wait

Returns: any · Runs on: any

Example

lolo

(async/delay 2000) // Wait 2 seconds

`async/interval`

Execute an effect periodically at a fixed interval

lolo

(async/interval effect interval)

Parameters

Name	Type	Description
`effect`	`any`	Effect to execute
`interval`	`number`	Interval in milliseconds

Returns: string · Runs on: any

Example

lolo

(async/interval (log "tick") 1000) // => "id-123"

`async/race`

Execute effects in parallel, return first to complete

lolo

(async/race ...effects)

Parameters

Name	Type	Description
`...effects`	`expression[]`	Effects to race

Returns: any · Runs on: any

Example

lolo

(async/race (call "api1") (call "api2"))

`async/retry`

Retry an effect with configurable backoff

lolo

(async/retry effect opts)

Parameters

Name	Type	Description
`effect`	`expression`	Effect to retry
`opts`	`object`	{ attempts, backoff, baseDelay }

Returns: any · Runs on: any

Example

lolo

(async/race ["call","api1"] ["call","api2"])

`async/sequence`

Execute effects in sequence (one after another)

lolo

(async/sequence ...effects)

Parameters

Name	Type	Description
`...effects`	`expression[]`	Effects to execute in order

Returns: array · Runs on: any

Example

lolo

(async/sequence (call "validate") (call "save"))

`async/throttle`

Throttle an event (emit at most once per interval)

lolo

(async/throttle event ms)

Parameters

Name	Type	Description
`event`	`string`	Event name to emit
`ms`	`number`	Throttle interval in milliseconds

Returns: void · Runs on: any

Example

lolo

(async/throttle "SCROLL" 100)

`async/timeout`

Add timeout to an effect

lolo

(async/timeout effect ms)

Parameters

Name	Type	Description
`effect`	`expression`	Effect to execute
`ms`	`number`	Timeout in milliseconds

Returns: any · Runs on: any

Example

lolo

(async/timeout (call "api" "fetchData") 5000)

behavior/

`behavior/call`

Call a behavior service action. Returns the ServiceCallResult union — resolves to the specific member when the (behavior, action) pair is a literal.

lolo

(behavior/call behavior action)

Parameters

Name	Type	Description
`behavior`	`string`	Behavior name
`action`	`string`	Action name (variadic)

Returns: ServiceCallResult · Runs on: any

Example

lolo

(behavior/call "user-service" "login")

`behavior/compose`

Compose N orbitals into one application schema. Wires events, picks layout, generates pages.

lolo

(behavior/compose orbitals)

Parameters

Name	Type	Description
`orbitals`	`array`	Array of orbital definitions

Returns: object

Example

lolo

(behavior/compose [{"name": "home"} {"name": "settings"}])

`behavior/detect-layout`

Auto-detect layout from orbital count and wiring topology. Returns single, tabs, sidebar, dashboard, or wizard-flow.

lolo

(behavior/detect-layout orbitals)

Parameters

Name	Type	Description
`orbitals`	`array`	Array of orbitals (variadic)

Returns: string

Example

lolo

(behavior/detect-layout [{"name": "a"} {"name": "b"}]) // => "tabs"

`behavior/instantiate`

Instantiate a behavior from the registry at runtime (meta-programming). Equivalent to compile-time uses but dynamic — the behavior name is a runtime value. Applies the same override surface (linkedEntity, events, config, fields).

lolo

(behavior/instantiate behavior config)

Parameters

Name	Type	Description
`behavior`	`string`	Behavior name
`config`	`object`	Configuration object (variadic)

Returns: BuilderResult · Runs on: any

Example

lolo

(behavior/instantiate "my-behavior" {})

`behavior/pipe`

Left-to-right composition. Each step receives the previous result as its first arg.

lolo

(behavior/pipe value fn)

Parameters

Name	Type	Description
`value`	`any`	Initial value
`fn`	`lambda`	Transform function (variadic)

Returns: any

Example

lolo

(behavior/pipe 5 (fn x (+ "x" 1))) // => 6

`behavior/wire`

Apply cross-orbital event wiring. Adds external emits/listens to inline traits.

lolo

(behavior/wire traits routes)

Parameters

Name	Type	Description
`traits`	`array`	Array of traits
`routes`	`array`	Array of event routes

Returns: array

Example

lolo

(behavior/wire [{"name": "t1"} {"name": "t2"}] [])

checkpoint/

`checkpoint/load`

Load a model checkpoint (ML effect)

lolo

(checkpoint/load path)

Parameters

Name	Type	Description
`path`	`string`	Checkpoint path

Returns: object

Example

lolo

(checkpoint/load "model-v1") // => {}

`checkpoint/save`

Save a model checkpoint (ML effect)

lolo

(checkpoint/save model path)

Parameters

Name	Type	Description
`model`	`object`	Model object
`path`	`string`	Checkpoint path

Returns: void · Runs on: any

Example

lolo

(checkpoint/save {"layers":[{"type":"dense","units":2}]} "ckpt-1")

compose/

`compose/compose-all`

Compose all orbitals in the workspace into a single schema. Backed by composeBehaviors.

lolo

(compose/compose-all)

Returns: ComposeAllResult · Runs on: any

Example

lolo

(compose/compose-all) // => {}

`compose/compose-children`

Compose child orbitals under a parent for recursive builds.

lolo

(compose/compose-children parent)

Parameters

Name	Type	Description
`parent`	`object`	Parent orbital

Returns: ComposeChildrenResult · Runs on: any

Example

lolo

(compose/compose-children "GameScreenOrbital") // => {}

contract/

`contract/clamp-output`

Clamp output tensor to contract ranges

lolo

(contract/clamp-output tensor ranges)

Parameters

Name	Type	Description
`tensor`	`any`	Output tensor
`ranges`	`object`	Range constraints

Returns: tensor

Example

lolo

(contract/clamp-output [1 2 3] {"min": 0, "max": 255}) // => [1 2 3]

`contract/entity-to-tensor`

Convert entity fields to tensor via contract

lolo

(contract/entity-to-tensor entity contract)

Parameters

Name	Type	Description
`entity`	`object`	Entity object
`contract`	`object`	Contract schema

Returns: tensor

Example

lolo

(contract/entity-to-tensor {"price":10,"qty":2} {"fields":["price","qty"]}) // => []

`contract/tensor-to-payload`

Convert output tensor to event payload via contract

lolo

(contract/tensor-to-payload tensor contract)

Parameters

Name	Type	Description
`tensor`	`any`	Output tensor
`contract`	`object`	Contract schema

Returns: object

Example

lolo

(contract/tensor-to-payload [0.5,0.7] {"fields":["price","qty"]}) // => {}

`contract/validate-input`

Validate tensor against input contract. Returns { valid, violations } — guard on valid, or read violations for the detail.

lolo

(contract/validate-input tensor contract)

Parameters

Name	Type	Description
`tensor`	`any`	Input tensor
`contract`	`object`	Contract schema

Returns: object

Example

lolo

(contract/validate-input [0.5,0.7] {"ranges":{"0":{"min":0,"max":1},"1":{"min":0,"max":1}}}) // => {"valid": true, "violations": []}

`contract/validate-output`

Validate tensor against output contract. Returns { valid, violations } — guard on valid, or read violations for the detail.

lolo

(contract/validate-output tensor contract)

Parameters

Name	Type	Description
`tensor`	`any`	Output tensor
`contract`	`object`	Contract schema

Returns: object

Example

lolo

(contract/validate-output [0.5,0.7] {"ranges":{"0":{"min":0,"max":1},"1":{"min":0,"max":1}}}) // => {"valid": true, "violations": []}

`contract/violations`

List contract violations

lolo

(contract/violations tensor contract)

Parameters

Name	Type	Description
`tensor`	`any`	Tensor
`contract`	`object`	Contract schema

Returns: array

Example

lolo

(contract/violations [0.5,1.7] {"ranges":{"0":{"min":0,"max":1},"1":{"min":0,"max":1}}}) // => []

integration/

`integration/github-create-issue`

Create a GitHub issue. Typed wrapper for the GitHub API.

lolo

(integration/github-create-issue repo title body)

Parameters

Name	Type	Description
`repo`	`string`	Repository identifier
`title`	`string`	Issue title
`body`	`string`	Issue description

Returns: object · Runs on: any

Example

lolo

(integration/github-create-issue "owner/repo" "Bug found" "Details here")

`integration/github-get-repo`

Get a GitHub repository. Typed wrapper for the GitHub API.

lolo

(integration/github-get-repo owner repo)

Parameters

Name	Type	Description
`owner`	`string`	Repository owner
`repo`	`string`	Repository name

Returns: object · Runs on: any

Example

lolo

(integration/github-get-repo "microsoft" "vscode")

`integration/http`

HTTP request with caller-declared response schema. Validates the response against the schema before returning.

lolo

(integration/http method url body)

Parameters

Name	Type	Description
`method`	`string`	HTTP method
`url`	`string`	Request URL
`body`	`any`	Request body or config (variadic)

Returns: object · Runs on: any

Example

lolo

(integration/http "GET" "https://api.example.com/data")

trace/

`trace/emit`

Emit a structured trace event for observability (115 call sites in rabit today).

lolo

(trace/emit event)

Parameters

Name	Type	Description
`event`	`string`	Event name

Returns: void · Runs on: any

Example

lolo

(trace/emit "cache-hit")

`trace/log`

Log a message at the given level.

lolo

(trace/log level msg)

Parameters

Name	Type	Description
`level`	`string`	Log level
`msg`	`string`	Message text

Returns: void · Runs on: any

Example

lolo

(trace/log "info" "Processing started")

Validation

Randomness

Orb

The language where the rule is the program.

Learn

Get started Docs Blog

Tools

Playground Standard library Explore Play Downloads Studio

Community

GitHub Discord Almadar