Skip to content

llm.md

Latest commit

 

History

History
93 lines (70 loc) · 2.45 KB

llm.md

File metadata and controls

93 lines (70 loc) · 2.45 KB
Raw

llm

Call an LLM. Choose response (single-shot / chat) or agent (subprocess loop with tools).
Kind Keyword
Since 0.1.3

Syntax

llm <name>

Arguments

Name Type Required
name identifier yes

Description

Body-level keyword. Bind the result to <name> for use by subsequent nodes. Common settings (model, system, temperature, max-tokens) live directly under llm; mode-specific children (response or agent) define how the call runs. Exactly one of response or agent must be present.

Valid inside action, page, fragment, api, webhook, job, and schedule bodies. Nodes that follow the llm see the final assistant reply on :<name>.text, plus :<name>.cost_usd, :<name>.session_id, :<name>.duration_ms, :<name>.stop_reason. For long-running jobs, attach an on progress handler to the agent block to persist or broadcast incremental progress while the subprocess runs.

Children

Examples

Streaming chat (response mode)

action /chat method POST
  llm reply
    model: claude-sonnet-4-6
    system: You are a helpful assistant
    response
      history: SELECT papel, conteudo FROM mensagem WHERE conversa_id = :id ORDER BY criada
      stream: #chat-msgs
      stream-swap: append

Agent loop (subprocess claude CLI)

job process-doc
  llm task
    model: claude-sonnet-4-6
    system: Code assistant
    agent
      cwd: /workspaces/jobs/:doc_id
      tools: read, write, bash
      max-turns: 10
      max-budget-usd: 0.50
      permission-mode: plan

Agent in a job with live progress

job run-review
  llm review
    model: claude-sonnet-4-6
    agent
      cwd: :bundle_dir
      max-budget-usd: 2.00
      on progress
        query: UPDATE review_job SET progress = :progress WHERE id = :job_id
  query: UPDATE review_job SET status = 'done', summary = :review.text WHERE id = :job_id

See also

Provenance
Spec last touched 36bcf1b (2026-05-20)
Source last touched af278bb (2026-05-20)
Source files internal/parser/parser.go