Skip to main content
Builtins catalog / nika:wait

Core

Tool family from the canonical registry.

invoke

Call this builtin through the invoke verb.

​
Read this contract

This reference preserves the specification at the revision linked below. Source examples are fragments: their surrounding tasks, inputs and permissions are not supplied here. Consult engine status and nika catalog --tools --json for the installed implementation; a registry declaration is not a runtime qualification.

​
Usage and behavior

illustration
Temporal pause · ONE builtin · 2 modes (relative duration: XOR absolute until: · exactly-one-of validated at parse time). Replaces · legacy nika:sleep (relative-only) + nika:wait_until (absolute-only · cut per ADR-087 Rams sweep · 2026-05-27). Same family · same trust class (PURE) · same temporal-control semantics · the unified surface preserves both behaviors via mode arg. Throws · NIKA-BUILTIN-WAIT-001 on absolute timeout · -002 if the timestamp is in the past · -003 if neither duration: nor until: set (or both set).

Arguments

Pass the values required by the tool contract.

Permissions

Understand authority before granting effects.

Errors and recovery

Read diagnostics and choose a recovery policy.

Workflow templates

Put the fragment inside a complete workflow.

​
Contract provenance

Read the pinned specification · Canonical registry. Tool identity: nika:wait. Specification revision: f8c5df2127c7. The Lab language identity is language:tool:wait; the registry view is ecosystem:tool/nika:wait. They refer to this contract without merging their graph identities.