Skip to main content
Builtins catalog / nika:prompt

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
Interactive human-in-the-loop · blocks until answered. mode: selects what is collected (default confirm) · Non-interactive contract (normative · all modes) · when no human can answer (CI · daemon) the engine MUST use default: when present · and MUST fail NIKA-BUILTIN-PROMPT-001 (validation_error · non-interactive without a default:) when absent: never hang forever · never silently pick an answer. A choice whose default: is not an element of choices: is a parse error (NIKA-BUILTIN-PROMPT-002 · validation_error).

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:prompt. Specification revision: f8c5df2127c7. The Lab language identity is language:tool:prompt; the registry view is ecosystem:tool/nika:prompt. They refer to this contract without merging their graph identities.