Handbook

Messages and file refs

LCDL keeps chat-shaped data explicit so transports stay thin:

Updated

  • FileRef — lightweight file pointer metadata for attaching context without leaking raw paths into prompts unintentionally.
  • LlmMessage — role/content pairs aligned with OpenAI-style chat messages.
  • build_openai_messages — constructs provider-ready message lists from higher-level inputs (see src/forge_lcdl/messages.py).

Use these types when composing TaskRunner calls or custom transports so retries, caching, and audits see a stable wire shape.

See also