Preprocessors Command - Lua CLI

Overview

lua preprocessors manages preprocessor primitives — code that runs before a user message reaches your agent. Use preprocessors for content filtering, routing, rate limiting, validation, and message rewriting.

lua preprocessors                            # Interactive management
lua preprocessors view                       # List all preprocessors
lua preprocessors deploy --preprocessor-name myPre --preprocessor-version 1.0.3

For defining preprocessors in code, see the Preprocessor concept and the Preprocessor API.

Subcommands

Action	What it does
`view`	List all preprocessors defined on the agent.
`versions`	List every version of a specific preprocessor.
`deploy`	Promote a version to active.
`activate`	Re-enable a deactivated preprocessor.
`deactivate`	Pause execution — messages bypass this preprocessor.
`delete`	Permanently remove a preprocessor and all its versions.

Options

Option	Description
`--preprocessor-name <name>`	Preprocessor name. Required for most non-interactive actions.
`--preprocessor-version <ver>`	Version for `deploy`. Pass `latest` for the newest.

The shorthand pre resolves to preprocessor in most argument positions — e.g. lua pre view, lua logs --type pre.

Examples

# Interactive
lua preprocessors

# List everything
lua preprocessors view

# List versions
lua preprocessors versions --preprocessor-name myPre

# Promote a specific version
lua preprocessors deploy --preprocessor-name myPre --preprocessor-version 1.0.3
lua preprocessors deploy --preprocessor-name myPre --preprocessor-version latest

# Pause and resume
lua preprocessors deactivate --preprocessor-name myPre
lua preprocessors activate   --preprocessor-name myPre

# Delete
lua preprocessors delete --preprocessor-name oldPre

Common Workflow

# Edit src/preprocessors/profanity-filter.ts, then:
lua push preprocessor                                            # Build + upload
lua preprocessors versions --preprocessor-name profanityFilter   # Confirm
lua preprocessors deploy --preprocessor-name profanityFilter --preprocessor-version latest
lua logs --type preprocessor --name profanityFilter --limit 20   # Verify execution