Changelog

lua integrations              # Interactive mode
lua integrations connect      # Connect a new account
lua integrations list         # List connected accounts
lua integrations webhooks     # Manage webhook subscriptions
lua integrations mcp          # Manage MCP servers for connections

lua logs --type mcp      # View MCP tool execution logs
lua logs --type mastra   # View Mastra AI runtime logs

lua logs --user-id user_123456

# Direct API key setup (for dashboard users or CI/CD)
lua configure --api-key YOUR_API_KEY

# Request OTP via email (step 1)
lua configure --email [email protected]

# Verify OTP and generate API key (step 2)
lua configure --email [email protected] --otp 123456

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' });
const user = await User.get({ phone: '1234567890' });

// Handle not found
if (!user) {
  return { error: 'User not found' };
}

# 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;
  }
});