Host: memory, sessions, workspace, OS
Every operator a .lolo program can call, from the canonical registry the compiler bakes.
Namespaces on this page: browser/, i18n/, lolo/, memory/, os/, session/, workspace/.
browser/
browser/clipboard-read
Read text from the system clipboard (navigator.clipboard.readText / host clipboard). Requires a user gesture and clipboard permission. Resolves with the clipboard text via the trailing { emit } envelope.
(browser/clipboard-read)Returns: string · Runs on: client
Example
(browser/clipboard-read) // => "clipboard text"browser/clipboard-write
Write text to the system clipboard (navigator.clipboard.writeText / host clipboard). Requires a user gesture. Emits success/failure via the trailing { emit } envelope.
(browser/clipboard-write text)Parameters
| Name | Type | Description |
|---|---|---|
text | string | Text to write |
Returns: void · Runs on: client
Example
(browser/clipboard-write "copied")browser/geolocation-current
Read the current device position (navigator.geolocation.getCurrentPosition / host geolocation). Requires location permission. Resolves with { latitude, longitude, accuracy } via the trailing { emit } envelope.
(browser/geolocation-current options)Parameters
| Name | Type | Description |
|---|---|---|
options | {'kind': 'object', 'fields': {'enableHighAccuracy': 'string', 'timeout': 'number', 'maximumAge': 'number'}, 'open': True} | Optional PositionOptions: { enableHighAccuracy?: boolean, timeout?: number, maximumAge?: number } |
Returns: object · Runs on: client
Example
(browser/geolocation-current) // => {"latitude": 37.77, "longitude": -122.41, "accuracy": 100}browser/open-file-picker
Open the OS file picker (window.showOpenFilePicker / host dialog). Resolves with the selected file metadata list, or emits failure when the user cancels or the capability is denied. Async; use the trailing { emit } envelope for success/failure events.
(browser/open-file-picker options)Parameters
| Name | Type | Description |
|---|---|---|
options | {'kind': 'object', 'fields': {'multiple': 'string', 'accept': 'string'}, 'open': True} | Optional picker config: { multiple?: boolean, accept?: string, types?: Array<{description, accept}> } |
Returns: array · Runs on: client
Example
(browser/open-file-picker) // => [{"name": "file.txt", "size": 1024, "type": "text/plain", "lastModified": 1234567890}]browser/push-subscribe
Subscribe this browser to Web Push notifications: registers the shared push service worker, fetches the VAPID public key from the host (/api/push/vapid-public-key — no key material in the schema), and calls PushManager.subscribe. Requires notification permission (user gesture). Resolves with the flat subscription credentials { endpoint, p256dh, auth } via the trailing { emit } envelope — persist them on an owner-scoped entity row and pass them back to the push.send service as subscription: { endpoint, keys: { p256dh, auth } }. Emits failure when the Push API is unavailable, permission is denied, or the host has no VAPID key configured.
(browser/push-subscribe)Returns: object · Runs on: client
Example
(browser/push-subscribe) // => {"endpoint": "https://...", "p256dh": "...", "auth": "..."}i18n/
i18n/t
The active locale's message for a catalog key, with {{placeholders}} filled from params
(i18n/t key params)Parameters
| Name | Type | Description |
|---|---|---|
key | string | Catalog key (a string literal) |
params | object | Values for the message {{placeholders}} |
Returns: string
Example
(i18n/t "posts.count" {"n":3}) // => "3 posts"lolo/
lolo/emit-body
Emit a .lolo orbital body from the LLM (free-lolo path). Returns the emitted lolo source.
(lolo/emit-body prompt context config)Parameters
| Name | Type | Description |
|---|---|---|
prompt | string | Generation prompt |
context | object | Emission context |
config | object | Emission configuration |
Returns: LoloEmitResult · Runs on: any
Example
(lolo/emit-body "PlayerOrbital" {"topics":["game/2d"]} "player ship with movement")memory/
memory/list
List all memories, optionally filtered by category.
(memory/list category)Parameters
| Name | Type | Description |
|---|---|---|
category | string | Memory category filter |
Returns: array
Example
(memory/list)memory/recall
Search memories by semantic query. Returns matching memory records.
(memory/recall query)Parameters
| Name | Type | Description |
|---|---|---|
query | string | Semantic search query |
Returns: array
Example
(memory/recall "important events")memory/store
Store a new memory. Returns the new memory ID.
(memory/store content category)Parameters
| Name | Type | Description |
|---|---|---|
content | string | Memory content |
category | string | Memory category |
Returns: string · Runs on: any
Example
(memory/store "User preference" "prefs") // => "mem-abc123"os/
os/debounce
Configure debounce interval for an OS event type. Prevents trigger storms during rapid changes.
(os/debounce event interval)Parameters
| Name | Type | Description |
|---|---|---|
event | string | Event type |
interval | number | Debounce interval in milliseconds |
Returns: void · Runs on: server
Example
(os/debounce "MOUSE_MOVE" 100)os/watch-cron
Register cron schedule. Emits OS_CRON_FIRE events with { expression, timestamp } payload.
(os/watch-cron expression)Parameters
| Name | Type | Description |
|---|---|---|
expression | string | Cron expression |
Returns: void · Runs on: server
Example
(os/watch-cron "0 0 * * *")os/watch-env
Register environment variable watcher. Emits OS_ENV_CHANGED events with { variable, oldValue, newValue } payload.
(os/watch-env name)Parameters
| Name | Type | Description |
|---|---|---|
name | string | Environment variable name |
Returns: void · Runs on: server
Example
(os/watch-env "DATABASE_URL")os/watch-files
Register file system watcher. Emits OS_FILE_MODIFIED, OS_FILE_CREATED, OS_FILE_DELETED events with { path, name, dir, timestamp } payload.
(os/watch-files path)Parameters
| Name | Type | Description |
|---|---|---|
path | string | Directory path (variadic) |
Returns: void · Runs on: server
Example
(os/watch-files "/tmp")os/watch-http
Register HTTP response interceptor. Emits OS_HTTP_RESPONSE events with { url, method, status, headers, body, duration } payload.
(os/watch-http url)Parameters
| Name | Type | Description |
|---|---|---|
url | string | URL to monitor (variadic) |
Returns: void · Runs on: server
Example
(os/watch-http "https://api.example.com")os/watch-port
Register port monitor. Emits OS_PORT_OPENED, OS_PORT_CLOSED events with { port, protocol, pid, address } payload.
(os/watch-port port)Parameters
| Name | Type | Description |
|---|---|---|
port | number | Port number (variadic) |
Returns: void · Runs on: server
Example
(os/watch-port 8080)os/watch-process
Register process monitor. Emits OS_PROCESS_EXITED, OS_PROCESS_STARTED events with { pid, name, exitCode, signal, args, duration } payload.
(os/watch-process pid)Parameters
| Name | Type | Description |
|---|---|---|
pid | number | Process ID (variadic) |
Returns: void · Runs on: server
Example
(os/watch-process 12345)os/watch-signal
Register OS signal handler. Emits OS_SIGNAL_USR1, OS_SIGNAL_HUP, etc. with { pid, timestamp } payload.
(os/watch-signal signal)Parameters
| Name | Type | Description |
|---|---|---|
signal | string | Signal name |
Returns: void · Runs on: server
Example
(os/watch-signal "SIGUSR1")session/
session/append-history
Append an entry to the per-orbital conversation history.
(session/append-history orbital entry)Parameters
| Name | Type | Description |
|---|---|---|
orbital | string | Orbital name |
entry | object | History entry |
Returns: void · Runs on: any
Example
(session/append-history "ProductOrbital" {"role":"user","content":"Add a search bar"})session/read-analysis
Read the pre-computed analysis result.
(session/read-analysis)Returns: object
Example
(session/read-analysis)session/read-errors
Read validation errors for an orbital.
(session/read-errors orbital)Parameters
| Name | Type | Description |
|---|---|---|
orbital | string | Orbital name |
Returns: array
Example
(session/read-errors "validator") // => ["error1"]session/read-history
Read the per-orbital conversation history.
(session/read-history orbital)Parameters
| Name | Type | Description |
|---|---|---|
orbital | string | Orbital name |
Returns: array
Example
(session/read-history "chat") // => [{"role" "user"}]session/read-memory
Read the per-orbital memory from the session store.
(session/read-memory orbital)Parameters
| Name | Type | Description |
|---|---|---|
orbital | string | Orbital name |
Returns: object
Example
(session/read-memory "agent") // => {"key" "value"}session/read-spec
Read the per-orbital spec.json from the session store.
(session/read-spec orbital)Parameters
| Name | Type | Description |
|---|---|---|
orbital | string | Orbital name |
Returns: object
Example
(session/read-spec "game") // => {"version" "1.0"}session/write-errors
Write validation errors for an orbital.
(session/write-errors orbital errors)Parameters
| Name | Type | Description |
|---|---|---|
orbital | string | Orbital name |
errors | array | Error list |
Returns: void · Runs on: any
Example
(session/write-errors "validator" ["error"])session/write-memory
Write per-orbital memory to the session store.
(session/write-memory orbital data)Parameters
| Name | Type | Description |
|---|---|---|
orbital | string | Orbital name |
data | object | Memory data |
Returns: void · Runs on: any
Example
(session/write-memory "ProductOrbital" {"notes":["initial draft"]})session/write-spec
Write the per-orbital spec.json to the session store.
(session/write-spec orbital spec)Parameters
| Name | Type | Description |
|---|---|---|
orbital | string | Orbital name |
spec | object | Spec object |
Returns: void · Runs on: any
Example
(session/write-spec "ProductOrbital" {"goal":"manage products"})workspace/
workspace/archive-orbital
Archive (remove from active set) an orbital from the workspace.
(workspace/archive-orbital name)Parameters
| Name | Type | Description |
|---|---|---|
name | string | Orbital name |
Returns: void · Runs on: any
Example
(workspace/archive-orbital "my-orbital")workspace/exists
Check if a file exists in the workspace.
(workspace/exists path)Parameters
| Name | Type | Description |
|---|---|---|
path | string | File path |
Returns: boolean
Example
(workspace/exists "config.json") // => trueworkspace/list-orbitals
List all orbital names in the workspace.
(workspace/list-orbitals)Returns: array
Example
(workspace/list-orbitals) // => ["orbital1" "orbital2"]workspace/read-file
Read a file from the workspace.
(workspace/read-file path)Parameters
| Name | Type | Description |
|---|---|---|
path | string | File path |
Returns: string
Example
(workspace/read-file "config.json")workspace/read-orbital
Read an orbital definition from the workspace by name.
(workspace/read-orbital name)Parameters
| Name | Type | Description |
|---|---|---|
name | string | Orbital name |
Returns: object
Example
(workspace/read-orbital "my-orbital")workspace/read-plan
Read the plan snapshot from the workspace.
(workspace/read-plan)Returns: object
Example
(workspace/read-plan)workspace/read-schema
Read the composed schema.orb from the workspace.
(workspace/read-schema)Returns: object
Example
(workspace/read-schema)workspace/write-file
Write a file to the workspace.
(workspace/write-file path content)Parameters
| Name | Type | Description |
|---|---|---|
path | string | File path |
content | any | Content to write |
Returns: void · Runs on: any
Example
(workspace/write-file "orbitals/Product.orb" {"orbitals":[]})workspace/write-orbital
Write an orbital definition to the workspace.
(workspace/write-orbital name definition)Parameters
| Name | Type | Description |
|---|---|---|
name | string | Orbital name |
definition | object | Orbital definition |
Returns: void · Runs on: any
Example
(workspace/write-orbital "ProductOrbital" {"name":"ProductOrbital"})workspace/write-plan
Write the plan snapshot to the workspace.
(workspace/write-plan plan)Parameters
| Name | Type | Description |
|---|---|---|
plan | object | Plan object |
Returns: void · Runs on: any
Example
(workspace/write-plan ["create entity","add list page"])workspace/write-schema
Write the composed schema.orb to the workspace.
(workspace/write-schema schema)Parameters
| Name | Type | Description |
|---|---|---|
schema | object | Schema object |
Returns: void · Runs on: any
Example
(workspace/write-schema {"orbitals":[{"name":"ProductOrbital"}]})Orb
The language where the rule is the program.