internal/

Package agent wires the ADK runner, tools, and system prompt for a single build.

Package archive is the tar+zstd codec shared by internal/snapshot (per-site version history) and internal/portable (cross-instance export/import).

Package assets embeds the self-contained CSS substrate that replaces the former CDN-loaded Tailwind + daisyUI design system.

Package build orchestrates the per-slug build lifecycle: seed the template skeleton, run the agent, lint and retry on failures, and persist the per-site metadata sidecar.

Package compressutil wraps klauspost/compress/zstd with two helpers used by every package that compresses bytes at rest in S3 (editrec transcripts, site files via the store layer, future callers).

Package docs embeds a keyword-searchable copy of the daisyUI component reference (daisyUI's official, self-contained llms.txt) so the build agent can look up class names and modifiers on demand instead of guessing or reaching for a web search.

Package editrec captures per-edit transcripts: every agent tool call plus before/after snapshots of any file the agent mutated.

Package events provides an in-process pub/sub tracker for build lifecycle events.

Package guide implements the owner-facing, fully deterministic "is my site complete?" checklist.

Package lint validates generated HTML — parse errors, broken relative links, broken anchor fragments, and per-template invariants.

Package model resolves a provider/model string to an ADK LLM.

Package photowall is the domain model for the event-photo-wall feature: visitor-uploaded photos held for owner approval, then shown on a rotating full-screen display.

Package portable encodes and decodes the cross-instance site archive used by the workspace Export tool and the landing-page Import flow.

Package quotas is topbanana's per-user policy: how many sites someone may own and which LLM model each agent tier uses for them.

Package sandbox runs user-authored JavaScript handlers (the bodies of /api/* requests) inside a goja Runtime with no host I/O. The agent writes these handlers; this package is what makes them safe to execute.

Package server is the HTTP layer — Echo routes, handlers, template rendering, the subdomain proxy, request validation, and upload handling.

Package snapshot captures and restores the full S3 state of a site as a single tar+zstd archive.

Package state is the per-site key-value store backing the sandbox's `kv.*` API.

Package storetest provides the shared test helpers for constructing a store.Store and unique per-test slugs.

Package textedit holds the pure string transforms and path/name validation shared by the in-process build agent (internal/agent) and the external MCP editing surface (internal/server).