lua-cli 3.9.3 → 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.9.3. 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.9.3. 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.9.3. 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

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.
@@ -119,6 +119,134 @@ declare const REQUIRED_ENUMS: {
 };
 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.
  *
@@ -142,4 +270,9 @@ interface ApprovedModelDef {
     };
 }
 
-export { type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type ApprovedModelDef, type Channel, REQUIRED_ENUMS, REQUIRED_NESTED_APIS, REQUIRED_PLATFORM_APIS, REQUIRED_PRIMITIVE_SHIMS, REQUIRED_UTILITIES, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified };
+/**
+ * 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.
@@ -119,6 +119,134 @@ declare const REQUIRED_ENUMS: {
 };
 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.
  *
@@ -142,4 +270,9 @@ interface ApprovedModelDef {
     };
 }
 
-export { type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type ApprovedModelDef, type Channel, REQUIRED_ENUMS, REQUIRED_NESTED_APIS, REQUIRED_PLATFORM_APIS, REQUIRED_PRIMITIVE_SHIMS, REQUIRED_UTILITIES, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified };
+/**
+ * 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.js

@@ -26,7 +26,8 @@ __export(index_exports, {
   REQUIRED_PRIMITIVE_SHIMS: () => REQUIRED_PRIMITIVE_SHIMS,
   REQUIRED_UTILITIES: () => REQUIRED_UTILITIES,
   UNSTRUCTURED_SUPPORTED_MEDIA_TYPES: () => UNSTRUCTURED_SUPPORTED_MEDIA_TYPES,
-  aiGenerateInputFromSimplified: () => aiGenerateInputFromSimplified
+  aiGenerateInputFromSimplified: () => aiGenerateInputFromSimplified,
+  buildDefaultPersona: () => buildDefaultPersona
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -206,6 +207,59 @@ var REQUIRED_ENUMS = {
 var REQUIRED_UTILITIES = [
   "env"
 ];
+
+// src/persona-defaults.ts
+var AGENT_NAME_TOKEN = "[Your Agent Name]";
+var DEFAULT_PERSONA_GUIDE = `# ${AGENT_NAME_TOKEN} - Persona
+
+This is a starting template to help you think about your agent's persona.
+Use it as-is, rearrange it, or replace it entirely with your own format \u2014 whatever works best for your use case.
+The sections below are suggestions, not requirements.
+
+## Identity & Role
+Who is your agent? What's their name and core purpose?
+- Give it a name and a clear one-line role
+- e.g. a customer support rep, a shopping assistant, an internal ops copilot, a scheduling bot
+
+## Business Context
+What company, product, or service does the agent represent? What does the business do?
+- Describe the business in a sentence or two so the agent understands the world it operates in
+- Include industry, value proposition, and anything the agent should "know" about the brand
+
+## Tone & Communication Style
+How should the agent sound?
+- Formal or casual? Concise or detailed? Empathetic or matter-of-fact?
+- Should it match a specific brand voice or adapt to the user's tone?
+- Any language or cultural considerations (e.g. greetings, local expressions)?
+
+## Target Audience
+Who will the agent be talking to?
+- Describe the typical user: consumers, business customers, internal team members, etc.
+- What do they usually need help with? What matters most to them?
+
+## Capabilities
+What can the agent help with? List the main things it should handle.
+- e.g. answering product questions, placing orders, looking up account info, scheduling meetings
+- Be specific \u2014 this shapes which skills and tools the agent will use
+
+## Boundaries
+What should the agent NOT do? When should it escalate to a human?
+- e.g. cannot process refunds, should not give medical/legal advice
+- Define when to hand off: frustrated user, request outside scope, sensitive data
+
+## Guidelines
+Any rules for how the agent behaves?
+- Response length limits (e.g. keep messages under 300 words)
+- Formatting preferences (e.g. use bullet points, avoid jargon)
+- Things to always or never do (e.g. always confirm before changes, never share internal IDs)
+
+---
+Feel free to add, remove, or rename sections. Your persona can be a single paragraph or a detailed playbook \u2014 whatever gives your agent the context it needs.
+`;
+function buildDefaultPersona(agentName) {
+  return DEFAULT_PERSONA_GUIDE.replace(AGENT_NAME_TOKEN, () => agentName || "My Agent");
+}
+__name(buildDefaultPersona, "buildDefaultPersona");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   REQUIRED_ENUMS,
@@ -214,5 +268,6 @@ var REQUIRED_UTILITIES = [
   REQUIRED_PRIMITIVE_SHIMS,
   REQUIRED_UTILITIES,
   UNSTRUCTURED_SUPPORTED_MEDIA_TYPES,
-  aiGenerateInputFromSimplified
+  aiGenerateInputFromSimplified,
+  buildDefaultPersona
 });

package/node_modules/@lua/shared-types/dist/index.mjs

@@ -177,6 +177,59 @@ var REQUIRED_ENUMS = {
 var REQUIRED_UTILITIES = [
   "env"
 ];
+
+// src/persona-defaults.ts
+var AGENT_NAME_TOKEN = "[Your Agent Name]";
+var DEFAULT_PERSONA_GUIDE = `# ${AGENT_NAME_TOKEN} - Persona
+
+This is a starting template to help you think about your agent's persona.
+Use it as-is, rearrange it, or replace it entirely with your own format \u2014 whatever works best for your use case.
+The sections below are suggestions, not requirements.
+
+## Identity & Role
+Who is your agent? What's their name and core purpose?
+- Give it a name and a clear one-line role
+- e.g. a customer support rep, a shopping assistant, an internal ops copilot, a scheduling bot
+
+## Business Context
+What company, product, or service does the agent represent? What does the business do?
+- Describe the business in a sentence or two so the agent understands the world it operates in
+- Include industry, value proposition, and anything the agent should "know" about the brand
+
+## Tone & Communication Style
+How should the agent sound?
+- Formal or casual? Concise or detailed? Empathetic or matter-of-fact?
+- Should it match a specific brand voice or adapt to the user's tone?
+- Any language or cultural considerations (e.g. greetings, local expressions)?
+
+## Target Audience
+Who will the agent be talking to?
+- Describe the typical user: consumers, business customers, internal team members, etc.
+- What do they usually need help with? What matters most to them?
+
+## Capabilities
+What can the agent help with? List the main things it should handle.
+- e.g. answering product questions, placing orders, looking up account info, scheduling meetings
+- Be specific \u2014 this shapes which skills and tools the agent will use
+
+## Boundaries
+What should the agent NOT do? When should it escalate to a human?
+- e.g. cannot process refunds, should not give medical/legal advice
+- Define when to hand off: frustrated user, request outside scope, sensitive data
+
+## Guidelines
+Any rules for how the agent behaves?
+- Response length limits (e.g. keep messages under 300 words)
+- Formatting preferences (e.g. use bullet points, avoid jargon)
+- Things to always or never do (e.g. always confirm before changes, never share internal IDs)
+
+---
+Feel free to add, remove, or rename sections. Your persona can be a single paragraph or a detailed playbook \u2014 whatever gives your agent the context it needs.
+`;
+function buildDefaultPersona(agentName) {
+  return DEFAULT_PERSONA_GUIDE.replace(AGENT_NAME_TOKEN, () => agentName || "My Agent");
+}
+__name(buildDefaultPersona, "buildDefaultPersona");
 export {
   REQUIRED_ENUMS,
   REQUIRED_NESTED_APIS,
@@ -184,5 +237,6 @@ export {
   REQUIRED_PRIMITIVE_SHIMS,
   REQUIRED_UTILITIES,
   UNSTRUCTURED_SUPPORTED_MEDIA_TYPES,
-  aiGenerateInputFromSimplified
+  aiGenerateInputFromSimplified,
+  buildDefaultPersona
 };

package/node_modules/@lua/shared-types/src/channel.type.ts

@@ -18,4 +18,5 @@ export type Channel =
   | 'rcs' // RCS (Rich Communication Services) integration
   | 'sms' // SMS via Vonage Messages API
   | 'mms' // MMS via Vonage Messages API
+  | 'device' // Device trigger execution context
   | string;