Changelog

Push Error: Interval seconds must be at least 60

// Interval — seconds now correctly sent to server
schedule: { type: 'interval', seconds: 300 }

// Once — executeAt now correctly sent to server
schedule: { type: 'once', executeAt: new Date(Date.now() + 3600000) }

// Cron — was already working
schedule: { type: 'cron', expression: '0 9 * * *' }

import { LuaAgent } from 'lua-cli';

// Static model
export const agent = new LuaAgent({
  name: 'my-agent',
  persona: 'You are a helpful assistant.',
  model: 'openai/gpt-4o',
});

// Dynamic model based on channel
export const agent = new LuaAgent({
  name: 'my-agent',
  persona: 'You are a helpful assistant.',
  model: async (request) => {
    if (request.channel === 'whatsapp') return 'openai/gpt-4o-mini';
    return 'openai/gpt-4o';
  },
});

lua telemetry          # Show current status
lua telemetry on       # Enable telemetry
lua telemetry off      # Disable telemetry

import { User } from 'lua-cli';

// Look up by email
const user = await User.get({ email: '[email protected]' });

// Look up by phone (both formats work)
const user = await User.get({ phone: '+1234567890' });

// Handle not found (returns null, doesn't throw)
if (!user) {
  return { error: 'User not found' };
}

lua integrations              # Interactive mode
lua integrations connect      # Connect (OAuth or API token)
lua integrations list         # List connected accounts
lua integrations webhooks     # Manage webhook triggers
lua integrations mcp          # Manage MCP servers

# Connect with triggers (all selected by default in interactive mode)
lua integrations connect --integration linear --auth-method oauth --scopes all \
  --triggers task_task.created,task_task.updated

# Use custom webhook URL instead of agent trigger
lua integrations connect --integration linear --auth-method oauth --scopes all \
  --triggers task_task.created --custom-webhook --hook-url https://my-server.com/webhook

# Backup project sources
lua push backup

# Restore on new machine
lua init --agent-id abc123 --restore-sources

# In CI/CD pipelines
lua --ci push skill --name mySkill --set-version ${{ github.sha }} --force

# In local development (interactive prompts work normally)
lua push skill

lua update   # Force-fetch latest version and install

lua agents            # Formatted output
lua agents --json     # JSON output for scripting

const MY_SCHEDULE = { type: 'cron', expression: '0 9 * * *' };
const MY_TOOLS = [calculatorTool, weatherTool];
import { RETRY_CONFIG } from './config';

export const myJob = defineJob({
  schedule: MY_SCHEDULE,        // ✅ variable reference
  retry: RETRY_CONFIG,          // ✅ imported constant
  execute: async () => { ... }
});

lua push all --force                # All primitives + persona + backup
lua push all --force --auto-deploy  # Also deploys persona to production

lua logs --type mcp      # View MCP tool execution logs
lua logs --type mastra   # View Mastra AI runtime logs
lua logs --user-id user_123456  # Filter by user ID

lua configure --api-key YOUR_API_KEY              # Direct setup
lua configure --email [email protected]            # Request OTP
lua configure --email [email protected] --otp 123  # Verify OTP

lua persona sandbox view    # Print persona and exit
lua skills sandbox view     # List local skills and exit

# Old (no longer works)
lua push skill --name mySkill --version 1.0.5

# New (correct)
lua push skill --name mySkill --set-version 1.0.5

# Old behavior (sync ran by default)
lua compile             # Checked for drift

# New behavior (sync is opt-in)
lua compile             # No drift check (fast)
lua compile --sync      # Enable drift check

# Delete a skill from the server
lua skills delete --skill-name my-old-skill

# Delete a webhook
lua webhooks delete --webhook-name old-webhook

# Delete a job
lua jobs delete --job-name deprecated-job

const server = new LuaMCPServer({
  name: 'my-api',
  transport: 'streamable-http',  // New transport type
  url: 'https://mcp.example.com/mcp',
  headers: () => ({
    'Authorization': `Bearer ${env("API_KEY")}`
  })
});

# Entity management
lua skills view
lua skills versions --skill-name mySkill
lua skills deploy --skill-name mySkill --skill-version 1.0.3

# Init command
lua init --agent-id abc123
lua init --agent-name "My Bot" --org-id org1

# Sync command
lua sync --check    # CI drift detection
lua sync --accept   # Auto-sync from server

# Test command
lua test skill --name get_weather --input '{"city": "London"}'

# Logs command
lua logs --type skill --name mySkill --limit 10 --json

lua logs --type user_message --limit 20
lua logs --type agent_response --limit 20

const mcpServer = new LuaMCPServer({
  name: 'mongo-mcp',
  transport: 'stdio',
  command: 'npx',
  args: ['-y', '@mongodb/mcp-server'],
  env: () => ({
    MDB_CONNECTION_STRING: env("MDB_CONNECTION_STRING")
  })
});

// Backward compatible
const products = await Products.get(1, 10);

// New approach with filters
const products = await Products.get({
  page: 1,
  limit: 10,
  filter: {
    category: 'electronics',
    inStock: true
  }
});

lua sync

# Clear all conversation history
lua chat clear

# Clear history for a specific user
lua chat clear --user [email protected]

import { Lua } from 'lua-cli';

// Access channel information
const channel = Lua.request.channel; // 'dev', 'webchat', 'whatsapp', etc.

import { Lua } from 'lua-cli';

// Access raw webhook payload when triggered by webhook
const webhookPayload = Lua.request.webhook;

import { LuaMCPServer, LuaAgent } from 'lua-cli';

const docsServer = new LuaMCPServer({
  name: 'lua-docs',
  transport: 'sse',
  url: 'https://docs.heylua.ai/mcp/sse'
});

export const agent = new LuaAgent({
  mcpServers: [docsServer]
});

const adminTool = new LuaTool({
  name: 'admin-tool',
  condition: async () => {
    const user = await User.get();
    return user.data?.isAdmin === true;
  },
  execute: async (input) => { return 'admin action completed'; }
});

import { CDN } from 'lua-cli';

// Upload a file
const file = new File([buffer], 'image.png', { type: 'image/png' });
const fileId = await CDN.upload(file);

// Get file
const file = await CDN.get(fileId);

// Get all jobs
const jobs = await Jobs.getAll();

// Activate/deactivate job scheduling
await job.activate();
await job.deactivate();

// Manually trigger execution
await job.trigger();

lua evals

import { Templates } from 'lua-cli';

// List templates
const result = await Templates.whatsapp.list(channelId);

// Send template message
await Templates.whatsapp.send(channelId, templateId, {
  phoneNumbers: ['+447551166594'],
  values: { body: { name: 'John' } }
});

const userId = user._luaProfile.userId;        // ✅ Recommended
const fullName = user._luaProfile.fullName;
const emails = user._luaProfile.emailAddresses;

// user.userId still works but is deprecated

// Before
const schedule = job.schedule;
const id = job.jobId;

// After
const schedule = job.activeVersion.schedule;
const id = job.id;
await job.trigger(); // New method

// Before
execute: async (query, headers, body) => {
  // handle webhook
}

// After
execute: async (event) => {
  const { query, headers, body, timestamp } = event;
  // handle webhook
}

// Block response
return { action: 'block', response: 'Blocked' };

// Proceed response
return { 
  action: 'proceed', 
  modifiedMessage: [{ type: 'text', text: '...' }] 
};

lua compile --debug
# or
LUA_DEBUG=true lua compile

// ✅ Now works perfectly
import { MyService } from "../services/MyService";
// ✅ Also works
import { MyService } from "@/services/MyService";

export const skill1 = new LuaSkill({ name: 'skill1', tools: [] });
export const skill2 = new LuaSkill({ name: 'skill2', tools: [] });
export const webhook1 = new LuaWebhook({ name: 'webhook1', execute: async () => 'ok' });

export const agent = new LuaAgent({
  name: 'my-assistant',
  persona: 'You are a helpful AI assistant...',
  skills: [skill1, skill2],
  webhooks: [webhook1],
  jobs: [job1],
  preProcessors: [processor1],
  postProcessors: [processor2]
});

lua chat

# Push all with auto-versioning
lua push all --force

# Push and deploy to production
lua push all --force --auto-deploy

export LUA_API_KEY=your-key
lua push all --force --auto-deploy

export const skill1 = new LuaSkill({ name: 'skill1', tools: [] });
export const skill2 = new LuaSkill({ name: 'skill2', tools: [] });

export const agent = new LuaAgent({
  skills: [skill1, skill2]
});

await Jobs.create({
  metadata: { userId: input.userId },
  execute: async (job) => {
    const userId = job.metadata.userId;
  }
});