Changelog

🔒 Your message had a key in it (…6Hs1). We took it out before saving the
   message or showing it to Claude.

const result = await Apps.viewers.add([{ phone: '+447700900123', name: 'Sam' }, { email: '[email protected]' }]);
await Apps.viewers.remove([{ email: '[email protected]' }]);

lua build-session                      # chat with the current session, or pick an agent
lua build-session start --agent <agentId>
lua build-session send "Add a tool that looks up an order by id" --file spec.pdf
lua build-session try "Where is order 1234?"
lua build-session release --wait

lua build-session attach --json | jq 'select(.kind=="event")'

new LuaBrowser({ name: 'invoices', allowedDomains: ['billing.example.com'], maxDownloadMb: 10, allowedMimeTypes: ['application/pdf'] });

const file = await Browser.download({ selector: 'a.invoice', name: 'invoice.pdf', browser: 'invoices' });
const page = await Browser.pdf({ name: 'receipt.pdf', browser: 'invoices' });
await Browser.upload({ selector: 'input[type=file]', file: file.data.fileId, browser: 'invoices' });

lua browser run "Read my latest notifications" --login linkedin --start-url https://www.linkedin.com/

return { action: 'proceed', metadata: { turnContext: 'Checklist in progress: section 12 of 48.' } };

await Threads.resetContext(); // { status: 'reset' } or { status: 'skipped', reason }

import { lua } from '@lua-ai-global/app-client';

lua.pane.setContext(() => ({ ticketId: currentTicketId() }));
lua.pane.ask(`Summarise ticket ${id}`, { context: { ticketId: id } });
lua.pane.open();
lua.pane.close();

lua apps upgrade ops-dashboard --dry-run
lua apps upgrade ops-dashboard

label = { running: 'Creating a ticket for {subject}', done: 'Created a ticket for {subject}' };

lua apps upgrade ops-dashboard --dry-run
lua apps upgrade ops-dashboard

printf %s "$VALUE" | lua env production -k API_KEY --stdin
lua env production -k API_KEY --stdin < key.txt

npm install @lua-ai-global/app-chat @lua-ai-global/app-client@~0.0.3

<AgentPaneLayout context={() => ({ ticketId: currentTicketId() })} onTurnEnd={() => refetchTickets()}>
  <App />
</AgentPaneLayout>

lua apps dev ops-dashboard --chat-env production

lua apps preview ops-dashboard --ttl 2d
lua apps preview --effects p7k2m3xq
lua apps preview --close p7k2m3xq

const catalog = Data.shared('product_catalog');
await catalog.create('products', { sku: 'RX-1', name: 'Router X1' }, 'Router X1 dual-band Wi-Fi'); // a writer
const matches = await catalog.search('products', 'wifi router', 5); // a reader

'POST /approvals/:runId/:approvalId': route({
  handler: async ({ params, body }) =>
    Workflows.viewer.decideApproval(params.runId, params.approvalId, { decision: body.decision }),
}),

const { answers, model } = await Decisions.ask({
  state: { message },
  questions: { refund: Decisions.odds('Is the customer asking for a refund?') },
  model: 'liquid/d1',
});

lua decisions run triage --message "I was charged twice" --model liquid/d1

await Decisions.ask({ state, questions, model: 'gpt-6-luna' });  // runs on OpenAI

lua version status

lua logs --type decisions --execution-id <id>
lua logs --type decisions --run-id <id>

import { Browser } from 'lua-cli';

const page = await Browser.read('https://heylua.ai/pricing', { waitFor: 'networkidle', selector: 'main' });
page.title;   // 'Pricing'
page.status;  // 200
page.content; // the text of <main>

const result = await Browser.execute({
  task: 'Find the monthly price of the Pro plan',
  startUrl: 'https://heylua.ai/pricing',
  schema: { type: 'object', properties: { price: { type: 'string' } }, required: ['price'] },
  maxSteps: 10,
  maxCostUsd: 0.25,
});
result.status; // 'completed'
result.output; // { price: '...' }

lua browser read https://heylua.ai/pricing --wait-for networkidle
lua browser run "Find the monthly price of the Pro plan" --start-url https://heylua.ai/pricing

import { Decisions } from 'lua-cli';

const r = await Decisions.ask({
  state: { message: input.text },
  questions: {
    refund: Decisions.odds('Is the customer asking for a refund?'),
    team: Decisions.choice('Which team should handle this?', {
      billing: 'Charges, invoices, refunds',
      tech: 'Bugs, outages, login problems',
    }),
  },
});
const { refund, team } = r.answers;
if (refund.type === 'odds') refund.odds;    // 0.93
if (team.type === 'choice') team.choice;    // 'billing'

lua decisions
lua decisions versions triage
lua decisions run triage --message 'I want a refund'
lua decisions publish triage 1.0.1

lua logs --type decisions

lua logs --type decisions

const technician = await User.get({ phone: '+254700000000' });
await technician?.setWorkItems([
  { id: 'MNT-00123', title: 'MNT-00123 · Fryer not heating', group: 'Assigned to you', updatedAt: new Date(), action: 'Show MNT-00123' },
]);

lua mcp list

import { Data, defineWebApp, route } from 'lua-cli';
import { z } from 'zod';

export default defineWebApp({
  name: 'ops-dashboard',
  pages: { root: './web', nav: [{ path: '/', label: 'Tickets' }] },
  routes: {
    'POST /tickets': route({
      body: z.object({ title: z.string().min(1) }),
      handler: async ({ body, auth }) => Data.create('tickets', { title: body.title, createdBy: auth.userId }),
    }),
  },
});

lua apps new ops-dashboard
cd src/apps/ops-dashboard/web && npm install && cd -
lua apps dev ops-dashboard

lua test webapp --name ops-dashboard --route 'GET /tickets?status=open'
lua push webapp --name ops-dashboard --force
lua version create -m "Add the ops dashboard"
lua version promote <n>

lua webhooks subscribe --webhook-name <name> --event user.merged
lua webhooks subscribe --webhook-name <name> --event user.unmerged

lua devices credential --device-name pico-sensor --operations commands,triggers --out ../pico/.env.device

lua devices test --device-name bench-sensor --command read_temperature --ci
lua devices test-trigger --device-name bench-sensor --trigger temperature_alert --payload '{"temperature":41}' --ci

// Short form — returns the hosted URL
const url = await AI.image('A clean, modern landscape hero image, no text');

// With options
const wide = await AI.image('A minimal abstract product shot', { size: '1536x1024', quality: 'high' });

// Full result
const { url: coverUrl, model, provider } = await AI.image({
  prompt: 'A deep indigo to orange gradient cover, no text',
  size: '1536x1024',
  quality: 'high',
});

lua version create --persona-version 7

// Reply in a thread, from a tool, a job, a webhook or a workflow code step
await Channels.send({ channel: 'slack', to: { conversationId: 'C0123ABCDEF:1712345678.000100' }, text: 'The overnight load finished.' });

// DM a workspace member by email
await Channels.send({ channel: 'slack', to: { email: '[email protected]' }, text: 'Your report is ready.' });

curl -sS -X POST "https://api.heylua.ai/admin/orgs/<<YOUR_ORG_ID>>/supervision-grants" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" -H "Content-Type: application/json" \
  -d '{"supervisorAgentId":"<supervisor>","targetAgentIds":["<target>"],"actions":["observe"],"dataCollections":["tickets"]}'

health: { maxSilenceMinutes: 30, alertAfterConsecutiveFailures: 3, notify: 'emailApp' }

lua deploy persona --set-version latest --force --ci

lua logs export --since 24h --include-content --yes --out ./export

import { log } from 'lua-cli';

log.error('Ticket lookup failed: upstream timeout', {
  tenant: 'acme',
  ticket_id: 48219,
  retried: true,
  tags: ['billing', 'urgent'],
});

"attributes": {
  "lua.source": "skill",
  "lua.log.structured": true,
  "app.tenant": "acme",
  "app.ticket_id": 48219,
  "app.tags": "billing,urgent",
  "app.tags.count": 2
}

lua logs export --since 7d --out ./export
lua logs export --since 30d --type skill,job
lua logs export --since 24h --no-wait --json

lua drains create --name archive --type s3 --bucket acme-logs --region eu-west-1 \
  --prefix lua/logs --credentials-from-env AWS_KEY_ID=AWS_SECRET
lua drains verify drn_...
lua drains confirm drn_... --token <token>

lua drains deliveries prod-siem --kind batch
lua drains replay drn_9f31a7c04b2e615d8a03cc71 01JBWA5X8M0Q2F7C4H1J9B6N3D

lua logs --channel whatsapp --since 2h
lua logs --channel integration:lua_crm --json

export class OrderCreatedTrigger extends LuaTrigger {
  name = 'order-created';
  description = 'Wakes the agent when the shop reports a new order';
  verify(ctx: TriggerContext) { return ctx.headers['x-shop-token'] === env('SHOP_WEBHOOK_TOKEN'); }
  filter(ctx: TriggerContext) { return ctx.body.type === 'order.created'; }
  transform(ctx: TriggerContext) { return `New order ${ctx.body.data.orderNumber}.`; }
}

lua chat -e production -m "order 1042 status?" -t drain-probe --ci
lua logs --environment production --since 10m --json

Webhook must have an execute function
Job must have an execute function

❌ Skill execution failed

WORKFLOW_MODULE_EVALUATION_FAILED

lua drains create --name "Datadog prod" --type datadog --site datadoghq.eu --header DD-API-KEY
lua drains verify <id>
lua drains status

lua drains create --ci --json \
  --name "Datadog prod" --type datadog --site datadoghq.eu \
  --header-from-env DD-API-KEY=DATADOG_API_KEY \
  --sources agent_error,skill --min-severity warn --environments production

lua drains update <id> --include-content --yes
lua drains update <id> --no-include-content

lua logs --type skill --name tickets --follow
lua logs --type agent_error --environment production --since 1h --limit 100 --json

Page 3 (10000+ total logs — count capped; page with --json nextCursor)

curl -sS "https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/logs?logSource=agent_error&limit=100" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>"

import { Lua, Channels } from 'lua-cli';

const conversation = Lua.request.conversation;
if (conversation?.kind === 'group' && conversation.externalId) {
  const speaker = conversation.participants.find((p) => p.isCurrentSpeaker);
  await Channels.send({
    channel: 'teams',
    to: { conversationId: conversation.externalId },
    text: `On it, ${speaker?.displayName ?? 'there'}.`,
  });
}

.agentStep('summarize', {
  taskClass: 'draft',
  model: 'class/balanced',
  requires: ['structured'],
  effort: 'medium',
  modelReason: 'Long inputs, structured output, no deep reasoning needed.',
  prompt: '...',
})

lua push workflow --apply-effort

lua workflows policy models get
lua workflows policy models set --compose on --max-class strong --consent-actions 60 --pins class-only
lua workflows policy models set --class-map judge=strong,draft=balanced

lua workflows policy autonomy get
lua workflows policy autonomy set --enabled on --max-credits 40 --max-steps 20 --max-duration 86400
lua workflows policy autonomy set --forms graph,static --max-runs-per-hour 20
lua workflows policy autonomy set --clear max-credits,forms

lua models list --workflows

lua workflows deploy <name> -v <previous version>

import { Lua } from 'lua-cli';

// inside a tool, preprocessor, or postprocessor
const context = Lua.request.runtimeContext;
const timezone = Lua.request.timezone;

return { action: 'block' };

${initData.modelPlanning}
${initData.modelPlanning|anthropic/claude-sonnet-4-5}

✅ Deployed order-triage v3
  ⚠ This workflow uses the Job tier, which is not enabled for your organization

lua auth logout          # this device
lua auth logout --all    # every device and app

lua auth sessions
lua auth sessions revoke <id>

lua marketplace template publish --template-id <id> --skip-auto-apply   # publish without updating installs

HUBSPOT_TOKEN:
  description: HubSpot private app token
  showIf: { param: LEADS_SOURCE, equals: [hubspot] }

✖ auth: Your Lua CLI session was signed out.
  Run `lua auth configure` to sign in again.

createWorkflow({
  name: 'ticket-to-pr',
  connections: [{ key: 'github', integrationType: 'github', required: true }],
  workspace: { kind: 'git', repo: template('input.repo'), ref: 'main', credentialsRef: 'github' },
})

Step       Kind   Status  Attempt  Error
implement  agent  failed  2        MODEL_ERROR (provider_error)
✖ implement: provider_error · HTTP 529 · model claude-sonnet-4-5 · turn 14 — API Error: 529 overloaded_error

const sent = await Channels.send({ channel: 'whatsapp', to: { userId }, text: 'Your order shipped.' });
const delivery = await Channels.getStatus(sent.deliveryId);
// delivery.status === 'failed' && delivery.error.category === 'window_closed'