function · world
query
Executes one registered detached query.
world.query(query_id, request?) -> query_result
- Stable ID
world.query- Owner
- app.ScriptPackageHost
- Authority
- read_only
- Timing
- immediate
- Availability
- Phase 14 package callbacks
- Side effects
- none
- Determinism
- Host-created package identity and per-callback budgets.
- Introduced
- 1.0.0
Usage
Use the stable query ID and a bounded request table. Handle completed, unavailable, exhausted, and invalid results explicitly.
Parameters
- query_id: stable ID of a registered query.
- request: optional table containing filters, cursor, and page_size.
Returns
A detached query result table with status, records, cursor, detail, and bounded work metadata.
Cost
Constant-size contract lookup or bounded retained-record access.
Fields
This symbol has no fields.
Errors
Examples
local result = world.query("world.resource.counts", {page_size = 16})
API history
- 1.0.0: Runtime contract published from the complete Phase 14 registry.