lua-cli 3.9.2 → 3.10.0

package/docs/CLI_REFERENCE.md

@@ -14,6 +14,9 @@ Complete reference for all lua-cli commands.
 - [Marketplace](#marketplace)
 - [Utilities](#utilities)
 - [Global Flags](#global-flags)
+- [Models](#models)
+- [Devices](#devices)
+- [Sync](#sync)
 
 ---
 
@@ -29,7 +32,7 @@ lua auth configure
 ```
 
 **Description:**
-Prompts for your API key and stores it securely in the system keychain (macOS Keychain, Windows Credential Vault, Linux libsecret).
+Prompts for your API key and stores it in `~/.lua-cli/credentials` (file-based, works on all platforms including headless Linux and Docker).
 
 **Example:**
 ```bash
@@ -229,7 +232,7 @@ lua push [type] [options]
 ```
 
 **Arguments:**
-- `type` - Primitive type to push: `skill`, `webhook`, `job`, `preprocessor`, `postprocessor`, `mcp`, `all`
+- `type` - Primitive type to push: `skill`, `webhook`, `job`, `preprocessor`, `postprocessor`, `mcp`, `device`, `all`
 
 **Options:**
 - `--name <name>` - Specific primitive name
@@ -912,6 +915,153 @@ lua deploy skill --name my-skill --version 1.0.0
 
 ---
 
+## Models
+
+### `lua models`
+
+Manage the LLM model for your agent.
+
+**Usage:**
+```bash
+lua models [action] [options]
+```
+
+**Actions:**
+- `list` (default) — list all approved models grouped by provider, highlighting the current model
+- `set` — interactively select or non-interactively specify a model; writes it to `src/index.ts` and pushes to server
+- `unset` — remove the model from source and clear it on the server (reverts to platform default)
+
+**Options:**
+- `--model <code>` - Model code to set non-interactively (e.g. `openai/gpt-4o`)
+- `--json` - Output model list as JSON
+
+**Examples:**
+```bash
+# List all available models
+lua models
+lua models list
+
+# Set model interactively
+lua models set
+
+# Set model non-interactively
+lua models set --model openai/gpt-4o
+lua models set --model anthropic/claude-3-5-sonnet
+
+# Revert to platform default
+lua models unset
+
+# Machine-readable output
+lua models list --json
+```
+
+---
+
+## Devices
+
+### `lua devices`
+
+Manage bidirectional agent-device communication.
+
+**Usage:**
+```bash
+lua devices [action] [options]
+```
+
+**Actions:**
+- `list` — list all registered devices
+- `status` — check if a device is online, offline, or disabled
+- `enable` — re-enable a disabled device
+- `disable` — disable a device
+- `remove` — remove a device (prompts for confirmation unless `--force`)
+- `test` — send a test command to a device and display the response
+- `test-trigger` — simulate an inbound trigger from a device
+
+**Options:**
+- `--device-name <name>` - Target device name (interactive picker shown when omitted)
+- `--group <name>` - Filter devices by group (for `list`)
+- `--payload <json>` - JSON payload to send with the command (default: `{}`)
+- `--timeout <ms>` - Command timeout in milliseconds (default: `30000`)
+- `--force` - Skip confirmation prompt (for `remove`)
+
+**Examples:**
+```bash
+# List all devices
+lua devices list
+
+# Filter by group
+lua devices list --group production
+
+# Check device status
+lua devices status --device-name my-sensor
+
+# Enable / disable a device
+lua devices enable --device-name my-sensor
+lua devices disable --device-name my-sensor
+
+# Remove a device
+lua devices remove --device-name my-sensor
+lua devices remove --device-name my-sensor --force   # skip confirmation
+
+# Send a test command
+lua devices test --device-name my-sensor
+lua devices test --device-name my-sensor --payload '{"temp": 22}' --timeout 5000
+
+# Simulate an inbound trigger
+lua devices test-trigger --device-name my-sensor
+```
+
+**Pushing device definitions:**
+```bash
+lua push device               # push device configurations to the server
+lua push all                  # includes devices in full push
+```
+
+---
+
+## Sync
+
+### `lua sync`
+
+Detect and resolve drift between local and server state.
+
+**Usage:**
+```bash
+lua sync [options]
+```
+
+**Options:**
+- `--check` - Report drift and exit 1 if any drift is found (CI/CD use)
+- `--accept` - Auto-pull all server state to local (non-interactive)
+- `--push` - Auto-push all local changes to server (non-interactive)
+- `--force` - Bypass the local conflict guard when pulling
+
+**Description:**
+Compares your local YAML config and source files against the server state. Detects drift for agent fields (name, persona, model) and all primitive types (skills, webhooks, jobs, preprocessors, postprocessors, MCP servers, devices).
+
+**Conflict Guard:**
+`lua sync --pull` (and `--accept`) guards against overwriting local changes made since the last `lua push backup`. If modified files are detected, the pull is refused with a list of conflicted files. Use `--force` to bypass.
+
+**Examples:**
+```bash
+# Interactive drift resolution
+lua sync
+
+# Report drift only (CI check)
+lua sync --check
+
+# Pull all server state to local (non-interactive)
+lua sync --accept
+
+# Pull, bypassing the conflict guard
+lua sync --accept --force
+
+# Push all local state to server (non-interactive)
+lua sync --push
+```
+
+---
+
 ## See Also
 
 - [Getting Started Guide](./GETTING_STARTED.md) - Step-by-step tutorial

package/docs/README.md

@@ -1,6 +1,6 @@
 # Lua CLI - Complete API Documentation
 
-Welcome to the comprehensive API documentation for lua-cli v3.7.1. This guide covers every API, class, and function exported by the package.
+Welcome to the comprehensive API documentation for lua-cli v3.10.0. This guide covers every API, class, and function exported by the package.
 
 ## 📚 Documentation Index
 
@@ -13,6 +13,7 @@ Welcome to the comprehensive API documentation for lua-cli v3.7.1. This guide co
 - [PreProcessor](./api/PreProcessor.md) - Message preprocessing (block/modify messages)
 - [PostProcessor](./api/PostProcessor.md) - Response postprocessing (format/enhance responses)
 - LuaMCPServer - MCP server integration (also auto-created via `lua integrations` command)
+- LuaDevice - Bidirectional device communication (send commands, receive triggers)
 
 ### Runtime APIs
 - [User API](./api/User.md) - User data management
@@ -24,6 +25,7 @@ Welcome to the comprehensive API documentation for lua-cli v3.7.1. This guide co
 - [Orders API](./api/Orders.md) - Order management and fulfillment
 - [Templates API](./api/Templates.md) - WhatsApp template messages
 - [CDN API](./api/CDN.md) - File upload/download
+- Device API - Send commands to and receive triggers from physical/virtual devices
 - Lua Runtime - Channel detection (`import { Lua } from 'lua-cli'`)
 
 ### Utilities
@@ -245,8 +247,8 @@ Each API doc includes:
 
 ---
 
-**Version:** 3.7.0
-**Last Updated:** March 2026
+**Version:** 3.9.3
+**Last Updated:** April 2026
 
 ---
 

package/node_modules/@lua/shared-types/dist/index.d.mts

@@ -5,7 +5,7 @@ import { FinishReason, LanguageModelUsage, ReasoningOutput, CallWarning, UserCon
  * Represents the communication channel through which a request originated.
  * Known channels are typed as string literals, unrecognized channels are unknown.
  */
-type Channel = 'web' | 'whatsapp' | 'facebook' | 'instagram' | 'slack' | 'teams' | 'messagebird' | 'front' | 'api' | 'dev' | 'email' | 'rcs' | 'sms' | 'mms' | string;
+type Channel = 'web' | 'whatsapp' | 'facebook' | 'instagram' | 'slack' | 'teams' | 'messagebird' | 'front' | 'api' | 'dev' | 'email' | 'rcs' | 'sms' | 'mms' | 'device' | string;
 
 /**
  * MIME types supported by Unstructured.io for document text extraction.
@@ -89,4 +89,190 @@ interface AiGenerateOutput {
  */
 declare function aiGenerateInputFromSimplified(prompt: string, content?: UserContent): AiGenerateInput;
 
-export { type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type Channel, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified };
+/**
+ * Sandbox contract: defines what every sandbox MUST expose.
+ * Both lua-cli and lua-core test against this contract.
+ * Update this file when adding new globals or primitives.
+ */
+declare const REQUIRED_PRIMITIVE_SHIMS: readonly ["LuaTool", "LuaSkill", "LuaJob", "LuaWebhook", "PreProcessor", "LuaPreprocessor", "PostProcessor", "LuaPostprocessor", "LuaMCPServer", "defineTool", "defineSkill", "defineJob", "defineWebhook", "definePreProcessor", "definePostProcessor", "defineMCPServer"];
+declare const REQUIRED_PLATFORM_APIS: {
+    readonly User: readonly ["get", "getChatHistory"];
+    readonly Products: readonly ["get", "create", "delete", "search", "getById"];
+    readonly Baskets: readonly ["create", "get", "addItem", "removeItem", "clear", "updateStatus", "updateMetadata", "placeOrder", "getById"];
+    readonly Orders: readonly ["create", "updateStatus", "updateData", "get", "getById"];
+    readonly Data: readonly ["create", "get", "getEntry", "update", "search", "delete"];
+    readonly Jobs: readonly ["create", "getJob", "getAll"];
+    readonly AI: readonly ["generate"];
+    readonly CDN: readonly ["upload", "get"];
+};
+declare const REQUIRED_NESTED_APIS: {
+    readonly Templates: {
+        readonly whatsapp: readonly ["list", "get", "send"];
+    };
+    readonly Lua: {
+        readonly request: readonly ["channel"];
+    };
+};
+declare const REQUIRED_ENUMS: {
+    readonly BasketStatus: readonly ["ACTIVE", "CHECKED_OUT", "ABANDONED", "EXPIRED"];
+    readonly OrderStatus: readonly ["PENDING", "CONFIRMED", "FULFILLED", "CANCELLED"];
+};
+declare const REQUIRED_UTILITIES: readonly ["env"];
+
+/**
+ * Device Gateway Types
+ *
+ * Types for bidirectional communication between AI agents and external devices.
+ * Used across lua-api (gateway), lua-core (runtime), and lua-cli (compilation).
+ */
+/** Command message sent from the server to a device */
+interface DeviceCommandMessage {
+    /** Unique identifier for this command (UUID). Used for idempotency. */
+    commandId: string;
+    /** Command name (must match a command defined in defineDevice) */
+    command: string;
+    /** Command payload (validated against inputSchema if defined) */
+    payload: any;
+    /** Timeout in milliseconds (defaults to 30000) */
+    timeout?: number;
+}
+/** Response message sent from a device back to the server */
+interface DeviceResponseMessage {
+    /** Must match the commandId of the original command */
+    commandId: string;
+    /** Whether the command executed successfully on the device */
+    success: boolean;
+    /** Response data (present when success=true) */
+    data?: any;
+    /** Error message (present when success=false) */
+    error?: string;
+}
+/** Trigger message sent from a device to the server */
+interface DeviceTriggerMessage {
+    /** Trigger name (must match a trigger defined in defineDevice) */
+    triggerName: string;
+    /** Trigger payload (validated against payloadSchema if defined) */
+    payload: any;
+}
+/** Acknowledgment sent from the server back to the device after receiving a trigger */
+interface DeviceTriggerAckMessage {
+    /** Server-generated unique identifier for this trigger event */
+    triggerId: string;
+    /** Whether the trigger was received and queued for processing */
+    received: boolean;
+    /** Error details if the trigger was rejected */
+    error?: string;
+}
+/** Device connection status */
+type DeviceStatus = 'online' | 'offline' | 'registered' | 'disabled';
+/** State of a command in the Valkey state machine */
+type CommandState = 'PENDING' | 'SENT' | 'ACK' | 'COMPLETED' | 'FAILED' | 'TIMED_OUT';
+/** Device information returned by API endpoints */
+interface DeviceInfo {
+    /** Unique device name within the agent */
+    name: string;
+    /** Agent this device belongs to */
+    agentId: string;
+    /** Current connection status */
+    status: DeviceStatus;
+    /** Device group (optional, for fan-out commands) */
+    group?: string;
+    /** Device capabilities */
+    capabilities: string[];
+    /** Free-form device metadata */
+    metadata: Record<string, any>;
+    /** Last time the device was seen (heartbeat or connect) */
+    lastSeenAt: Date | null;
+}
+/** Entry written to the device command stream */
+interface CommandStreamEntry {
+    commandId: string;
+    command: string;
+    payload: string;
+    originPodId: string;
+    agentId: string;
+    deviceName: string;
+}
+/** Entry written to the device response stream */
+interface ResponseStreamEntry {
+    commandId: string;
+    success: string;
+    data?: string;
+    error?: string;
+}
+/** Entry written to the device trigger stream */
+interface TriggerStreamEntry {
+    triggerId: string;
+    agentId: string;
+    deviceName: string;
+    deviceId: string;
+    triggerName: string;
+    payload: string;
+    timestamp: string;
+}
+/** Data stored in the Valkey hash for a command's state */
+interface CommandHashData {
+    status: CommandState;
+    agentId: string;
+    deviceName: string;
+    originPodId: string;
+    timestamp: number;
+}
+/** Device definition as stored in Redis cache */
+interface CachedDeviceDefinition {
+    name: string;
+    description?: string;
+    group?: string;
+    commands: CachedDeviceCommand[];
+    triggers: CachedDeviceTrigger[];
+    /** Compressed (gzip + base64) compiled artifact containing trigger handlers */
+    artifact: string;
+    /** Environment variables for the device */
+    env: Record<string, string>;
+}
+interface CachedDeviceCommand {
+    name: string;
+    description: string;
+    inputSchema?: Record<string, any>;
+    retry?: {
+        maxAttempts: number;
+        backoffMs: number;
+    };
+    timeoutMs?: number;
+}
+interface CachedDeviceTrigger {
+    name: string;
+    description: string;
+    payloadSchema?: Record<string, any>;
+    hasExecute: boolean;
+}
+
+/**
+ * Shared type definitions for the model registry.
+ *
+ * Runtime data (provider configs, context windows, approved model list) lives
+ * exclusively in the MongoDB `approvedModels` collection. lua-core loads it at
+ * startup via initModelRegistry() in mastra/common/model-registry.ts.
+ */
+interface ApprovedModelDef {
+    provider: string;
+    /** Full user-facing model string, e.g. "zhipuai/glm-5". */
+    code: string;
+    /** Model ID portion for display, e.g. "glm-5". */
+    model: string;
+    description: string;
+    /** Advertised input token context window (raw, from provider docs). */
+    contextWindow?: number;
+    /** If set, route requests through a gateway instead of calling the provider directly. */
+    gateway?: {
+        via: string;
+        modelPrefix: string;
+    };
+}
+
+/**
+ * Build a default persona guide with the agent name filled in.
+ */
+declare function buildDefaultPersona(agentName: string): string;
+
+export { type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type ApprovedModelDef, type CachedDeviceCommand, type CachedDeviceDefinition, type CachedDeviceTrigger, type Channel, type CommandHashData, type CommandState, type CommandStreamEntry, type DeviceCommandMessage, type DeviceInfo, type DeviceResponseMessage, type DeviceStatus, type DeviceTriggerAckMessage, type DeviceTriggerMessage, REQUIRED_ENUMS, REQUIRED_NESTED_APIS, REQUIRED_PLATFORM_APIS, REQUIRED_PRIMITIVE_SHIMS, REQUIRED_UTILITIES, type ResponseStreamEntry, type TriggerStreamEntry, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified, buildDefaultPersona };

package/node_modules/@lua/shared-types/dist/index.d.ts

@@ -5,7 +5,7 @@ import { FinishReason, LanguageModelUsage, ReasoningOutput, CallWarning, UserCon
  * Represents the communication channel through which a request originated.
  * Known channels are typed as string literals, unrecognized channels are unknown.
  */
-type Channel = 'web' | 'whatsapp' | 'facebook' | 'instagram' | 'slack' | 'teams' | 'messagebird' | 'front' | 'api' | 'dev' | 'email' | 'rcs' | 'sms' | 'mms' | string;
+type Channel = 'web' | 'whatsapp' | 'facebook' | 'instagram' | 'slack' | 'teams' | 'messagebird' | 'front' | 'api' | 'dev' | 'email' | 'rcs' | 'sms' | 'mms' | 'device' | string;
 
 /**
  * MIME types supported by Unstructured.io for document text extraction.
@@ -89,4 +89,190 @@ interface AiGenerateOutput {
  */
 declare function aiGenerateInputFromSimplified(prompt: string, content?: UserContent): AiGenerateInput;
 
-export { type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type Channel, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified };
+/**
+ * Sandbox contract: defines what every sandbox MUST expose.
+ * Both lua-cli and lua-core test against this contract.
+ * Update this file when adding new globals or primitives.
+ */
+declare const REQUIRED_PRIMITIVE_SHIMS: readonly ["LuaTool", "LuaSkill", "LuaJob", "LuaWebhook", "PreProcessor", "LuaPreprocessor", "PostProcessor", "LuaPostprocessor", "LuaMCPServer", "defineTool", "defineSkill", "defineJob", "defineWebhook", "definePreProcessor", "definePostProcessor", "defineMCPServer"];
+declare const REQUIRED_PLATFORM_APIS: {
+    readonly User: readonly ["get", "getChatHistory"];
+    readonly Products: readonly ["get", "create", "delete", "search", "getById"];
+    readonly Baskets: readonly ["create", "get", "addItem", "removeItem", "clear", "updateStatus", "updateMetadata", "placeOrder", "getById"];
+    readonly Orders: readonly ["create", "updateStatus", "updateData", "get", "getById"];
+    readonly Data: readonly ["create", "get", "getEntry", "update", "search", "delete"];
+    readonly Jobs: readonly ["create", "getJob", "getAll"];
+    readonly AI: readonly ["generate"];
+    readonly CDN: readonly ["upload", "get"];
+};
+declare const REQUIRED_NESTED_APIS: {
+    readonly Templates: {
+        readonly whatsapp: readonly ["list", "get", "send"];
+    };
+    readonly Lua: {
+        readonly request: readonly ["channel"];
+    };
+};
+declare const REQUIRED_ENUMS: {
+    readonly BasketStatus: readonly ["ACTIVE", "CHECKED_OUT", "ABANDONED", "EXPIRED"];
+    readonly OrderStatus: readonly ["PENDING", "CONFIRMED", "FULFILLED", "CANCELLED"];
+};
+declare const REQUIRED_UTILITIES: readonly ["env"];
+
+/**
+ * Device Gateway Types
+ *
+ * Types for bidirectional communication between AI agents and external devices.
+ * Used across lua-api (gateway), lua-core (runtime), and lua-cli (compilation).
+ */
+/** Command message sent from the server to a device */
+interface DeviceCommandMessage {
+    /** Unique identifier for this command (UUID). Used for idempotency. */
+    commandId: string;
+    /** Command name (must match a command defined in defineDevice) */
+    command: string;
+    /** Command payload (validated against inputSchema if defined) */
+    payload: any;
+    /** Timeout in milliseconds (defaults to 30000) */
+    timeout?: number;
+}
+/** Response message sent from a device back to the server */
+interface DeviceResponseMessage {
+    /** Must match the commandId of the original command */
+    commandId: string;
+    /** Whether the command executed successfully on the device */
+    success: boolean;
+    /** Response data (present when success=true) */
+    data?: any;
+    /** Error message (present when success=false) */
+    error?: string;
+}
+/** Trigger message sent from a device to the server */
+interface DeviceTriggerMessage {
+    /** Trigger name (must match a trigger defined in defineDevice) */
+    triggerName: string;
+    /** Trigger payload (validated against payloadSchema if defined) */
+    payload: any;
+}
+/** Acknowledgment sent from the server back to the device after receiving a trigger */
+interface DeviceTriggerAckMessage {
+    /** Server-generated unique identifier for this trigger event */
+    triggerId: string;
+    /** Whether the trigger was received and queued for processing */
+    received: boolean;
+    /** Error details if the trigger was rejected */
+    error?: string;
+}
+/** Device connection status */
+type DeviceStatus = 'online' | 'offline' | 'registered' | 'disabled';
+/** State of a command in the Valkey state machine */
+type CommandState = 'PENDING' | 'SENT' | 'ACK' | 'COMPLETED' | 'FAILED' | 'TIMED_OUT';
+/** Device information returned by API endpoints */
+interface DeviceInfo {
+    /** Unique device name within the agent */
+    name: string;
+    /** Agent this device belongs to */
+    agentId: string;
+    /** Current connection status */
+    status: DeviceStatus;
+    /** Device group (optional, for fan-out commands) */
+    group?: string;
+    /** Device capabilities */
+    capabilities: string[];
+    /** Free-form device metadata */
+    metadata: Record<string, any>;
+    /** Last time the device was seen (heartbeat or connect) */
+    lastSeenAt: Date | null;
+}
+/** Entry written to the device command stream */
+interface CommandStreamEntry {
+    commandId: string;
+    command: string;
+    payload: string;
+    originPodId: string;
+    agentId: string;
+    deviceName: string;
+}
+/** Entry written to the device response stream */
+interface ResponseStreamEntry {
+    commandId: string;
+    success: string;
+    data?: string;
+    error?: string;
+}
+/** Entry written to the device trigger stream */
+interface TriggerStreamEntry {
+    triggerId: string;
+    agentId: string;
+    deviceName: string;
+    deviceId: string;
+    triggerName: string;
+    payload: string;
+    timestamp: string;
+}
+/** Data stored in the Valkey hash for a command's state */
+interface CommandHashData {
+    status: CommandState;
+    agentId: string;
+    deviceName: string;
+    originPodId: string;
+    timestamp: number;
+}
+/** Device definition as stored in Redis cache */
+interface CachedDeviceDefinition {
+    name: string;
+    description?: string;
+    group?: string;
+    commands: CachedDeviceCommand[];
+    triggers: CachedDeviceTrigger[];
+    /** Compressed (gzip + base64) compiled artifact containing trigger handlers */
+    artifact: string;
+    /** Environment variables for the device */
+    env: Record<string, string>;
+}
+interface CachedDeviceCommand {
+    name: string;
+    description: string;
+    inputSchema?: Record<string, any>;
+    retry?: {
+        maxAttempts: number;
+        backoffMs: number;
+    };
+    timeoutMs?: number;
+}
+interface CachedDeviceTrigger {
+    name: string;
+    description: string;
+    payloadSchema?: Record<string, any>;
+    hasExecute: boolean;
+}
+
+/**
+ * Shared type definitions for the model registry.
+ *
+ * Runtime data (provider configs, context windows, approved model list) lives
+ * exclusively in the MongoDB `approvedModels` collection. lua-core loads it at
+ * startup via initModelRegistry() in mastra/common/model-registry.ts.
+ */
+interface ApprovedModelDef {
+    provider: string;
+    /** Full user-facing model string, e.g. "zhipuai/glm-5". */
+    code: string;
+    /** Model ID portion for display, e.g. "glm-5". */
+    model: string;
+    description: string;
+    /** Advertised input token context window (raw, from provider docs). */
+    contextWindow?: number;
+    /** If set, route requests through a gateway instead of calling the provider directly. */
+    gateway?: {
+        via: string;
+        modelPrefix: string;
+    };
+}
+
+/**
+ * Build a default persona guide with the agent name filled in.
+ */
+declare function buildDefaultPersona(agentName: string): string;
+
+export { type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type ApprovedModelDef, type CachedDeviceCommand, type CachedDeviceDefinition, type CachedDeviceTrigger, type Channel, type CommandHashData, type CommandState, type CommandStreamEntry, type DeviceCommandMessage, type DeviceInfo, type DeviceResponseMessage, type DeviceStatus, type DeviceTriggerAckMessage, type DeviceTriggerMessage, REQUIRED_ENUMS, REQUIRED_NESTED_APIS, REQUIRED_PLATFORM_APIS, REQUIRED_PRIMITIVE_SHIMS, REQUIRED_UTILITIES, type ResponseStreamEntry, type TriggerStreamEntry, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified, buildDefaultPersona };