LSP-Examples: Instructions file for Codex

AGENTS.md - BAS, Mako, and Xedge Examples

Purpose

This repository contains independent examples for the Barracuda App Server (BAS) ecosystem:

• BAS is the embedded C/C++ web and application server library.
• Mako Server is a standalone BAS runtime for desktop, server, and embedded Linux development and deployment.
• Xedge is a BAS-powered application environment commonly embedded in a product or firmware image.
• Xedge32 is the ESP32 edition of Xedge and adds ESP32 hardware APIs.
• LSP means Lua Server Pages: HTML resources that execute server-side Lua.

Examples are independent teaching applications, not one monolithic program. Keep changes scoped to the selected example and runtime.

Non-Negotiable Start Gate

Do not analyze, edit, generate, or test repository files until both of these steps are complete:

1. Download and read all 11 mandatory references and skills listed below.
2. Identify the selected example, its runnable app root, its target runtime, and its local instructions.

Do not continue with a partial reference set or guess an undocumented API.

Mandatory Reference Bootstrap

At the beginning of a task, create ./.agents/reference/rtl/ relative to this file and download or refresh every file in the two tables below. Save each file using its listed local filename. Verify that every response succeeded and every file is non-empty; an HTML error page is not a valid reference download.

Create or update ./.agents/reference/rtl/manifest.md with:

• download date;
• source URL;
• local filename;
• any download or validation failure.

Read all downloaded references and skills before making changes. The task-specific guidance later in this file determines which skills are most important for the implementation; it does not make the other downloads optional.

If Downloading Fails

If network or filesystem restrictions block a download:

1. Ask for the elevated network or filesystem permissions required to download and save the files.
2. Retry after permission is granted.
3. If permission is unavailable or downloading still fails, stop before modifying the repository.
4. Give the user a copy-ready list of every missing file. Each item must contain the clickable download link and exact destination path under ./.agents/reference/rtl/.
5. Ask the user to provide the files locally and resume only after all 11 files are accessible and non-empty.