Skip to content

CHANGELOG.md

Latest commit

 

History

History
436 lines (312 loc) · 19.9 KB

CHANGELOG.md

File metadata and controls

436 lines (312 loc) · 19.9 KB

Changelog

All notable changes to the Lua documentation will be documented in this file.

The format is based on Keep a Changelog.

[3.10.0] - 2026-04-16

Features

  • lua models command (LUA-268) — Manage your agent's LLM model directly from the CLI. lua models list shows all approved models grouped by provider, highlighting the current one. lua models set opens an interactive picker or accepts --model <code> for scripted use. lua models unset removes the model and reverts to the platform default. Changes are written to src/index.ts and synced to the server.

  • lua devices command — Full CLI for bidirectional agent-device communication. Supports list, status, enable, disable, remove, test, and test-trigger actions. Devices are a new first-class primitive type: define them in your project, push with lua push device, and use Device.sendCommand() / Device.listDevices() from within tools. Connect hardware or virtual devices using @lua/device-client.

  • Sync pull conflict guard — lua sync --accept (and --pull) now detects files you have modified locally since the last lua push backup and refuses to overwrite them. Use --force to bypass. After every successful lua push backup, a local cache of file hashes is stored so the guard can detect changes without requiring a server round-trip.

  • Persona guide template (LUA-271) — New agents created via lua init now receive a structured persona template with suggested sections (identity, tone, audience, capabilities, boundaries, guidelines) instead of the "Placeholder persona" placeholder.

Bug Fixes

  • Sync conflict detection was always triggering — The backup conflict detector used a different hash format (64-char) than the backup manifest (16-char), causing every file to appear as a conflict even when nothing had changed. Fixed: the detector now uses the same 16-char truncated hash as the manifest.

  • lua sync --pull failure was silently swallowed in CI — When a backup restore failed, the CLI printed "Sync complete" and exited 0. Likewise, when drift included source-bearing primitives but no backup was available, the missing count was never reported. Both paths now correctly propagate the failure so lua sync --accept exits non-zero in CI when it cannot fully restore.

Improvements

  • lua sync --force flag added to bypass the conflict guard when intentional overwrite is needed.

[3.9.3] - 2026-04-15

Features

  • Model selection in lua init (LUA-262) — Choose your agent's LLM model during lua init. Interactive mode shows a searchable, provider-grouped list with a skip option to use the server default. Non-interactive: lua init --model openai/gpt-4o. The model is written into your src/index.ts and synced to the server. Works across fresh init, re-init, backup restore, and agent-switch flows.

Bug Fixes

  • MCP sync pull now works — lua sync --accept and interactive pull for MCP servers were silently no-ops: servers missing locally were never written to YAML. Fixed — MCP servers created via the dashboard are now correctly added to local YAML on pull.
  • lua push mcp suggestion — The push suggestion shown during sync was lua push mcpServer (invalid command). Fixed to lua push mcp.

Improvements

  • lua init wording — "Use one of your existing agents" replaces "Extend one of your existing agents" for clarity. The parent question was also updated from "create" to "set up".

[3.9.0] - 2026-04-13

Improvements

  • CI/CD-friendly authentication (LUA-258) — keytar (OS keychain) removed. API keys now resolved from LUA_API_KEY env var, ~/.lua-cli/credentials file, or .env file. Works on headless Debian, Docker, and VMs without any system dependencies. Run lua auth configure once to re-authenticate.

[3.8.0] - 2026-04-08

Features

  • Webhook event subscriptions (BAC-131) — Subscribe webhooks to WhatsApp message lifecycle events (sent, delivered, read, failed, played). New commands: lua webhooks events list-events, subscribe, unsubscribe.
  • Generic multi-primitive deploy (BAC-137) — lua deploy now works for any primitive type: lua deploy skill|webhook|job|preprocessor|postprocessor|persona. Interactive type menu when no type is given. lua deploy all --force deploys latest versions of everything. Generic --name and --set-version flags replace the old --skill-name/--skill-version (deprecated aliases kept).

Bug Fixes

  • Jobs short flags (BAC-94) — lua jobs now accepts -i (--job-name) and -v (--job-version) short flags. Activate/deactivate list now shows live server status.
  • Active version display — Fixed incorrect active version comparison for jobs, preprocessors, and postprocessors in deploy and push workflows.
  • Webhook unsubscribe validation — Invalid event types now show a clear error instead of a misleading "not subscribed" message.

[3.7.5] - 2026-03-30

Features

  • Per-agent message batching (BAC-113) — Agents can have individual batching configuration for message debouncing. New --batch and --delay flags for lua chat to test batching behavior.

[3.7.4] - 2026-03-27

Bug Fixes

  • Keychain authentication reliability — Fixed several issues that could cause API key saves to silently fail on macOS. Auth flow now correctly reports errors and clears stale data on re-authentication.
  • Inline comment stripping — .env parsing now strips inline comments correctly.

[3.7.3] - 2026-03-24

Improvements

  • HTTP retry with exponential backoff — Automatic retries with backoff for transient server failures (429, 500–504). Max 3 retries, never retries client errors.
  • Reduced package size — Removed the lua dev web UI command and unused dependencies, significantly reducing install size.

Bug Fixes

  • Chat stream timeout — Chat sessions now have a 5-minute timeout instead of hanging indefinitely on unresponsive connections.

[3.7.2] - 2026-03-24

Features

  • Isolated AI text generation (AI.generate) (BAC-14) — New API for running text generation from within tools, aligned with Vercel AI SDK generateText. Two call patterns: simplified AI.generate(prompt, content?) returns plain text; full-options AI.generate({ model, system, prompt, ... }) returns a rich result with text, finishReason, usage, sources (Google Search grounding), reasoning, and more. Supports google/*, openai/*, and anthropic/* providers.

Improvements

  • Lazy keytar loading — Keytar loaded on demand and skipped when LUA_SKIP_KEYCHAIN is set, fixing MODULE_NOT_FOUND errors in WebContainers and browser sandboxes.

[3.7.0] - 2026-03-20

Features

  • Chat thread isolation - lua chat supports -t / --thread for scoped conversations; lua chat clear accepts --thread to clear one thread.
  • Auto-clear chat history - --clear and --clear-thread clear conversation history when the session ends (interactive and non-interactive).

Bug Fixes

  • Model cleared on push - Removing model from LuaAgent and pushing now clears the model on the server (BAC-87).
  • Features help - lua features help and examples use current feature names (e.g. inquiry instead of deprecated tickets).

[3.6.7] - 2026-03-15

Bug Fixes

  • MCP integrations - Default for hiding sensitive MCP fields is now off so agents receive full tool payloads; defer_tools is set correctly for Unified.to (BAC-83).
  • Skill compilation - Tool references in skills resolve more reliably for import tracking.

[3.6.6] - 2026-03-11

Features

  • Agent error filter in logs - Added lua logs --type agent_error to filter logs for execution errors in tools, webhooks, and jobs.

Bug Fixes

  • Cron timezone and logs - Fixed timezone handling for cron schedules and improved error logging for failed cron jobs.

[3.6.5] - 2026-03-10

Improvements

  • Internal URL resolution - Extended base URLs for internal service discovery.

[3.6.1] - 2026-03-02

Bug Fixes

  • Job schedule fields preserved - interval schedules now correctly send seconds and once schedules now correctly send executeAt to the server. Previously these fields were dropped during compilation, causing push to fail with a validation error.
  • Agent imports resolved correctly - Agents referencing imported primitives in config arrays now compile correctly.
  • CLI exits immediately - Removed ~1s exit delay after commands complete.

[3.6.0] - 2026-02-27

Updated - Documentation for lua-cli v3.6.0

New Features Documented

  • Agent Model Selection (BAC-49) - LuaAgent now supports a model property
    • Static model: model: 'openai/gpt-4o'
    • Dynamic resolver: model: async (request) => { ... }
    • Supported providers: google/*, openai/*, anthropic/*
  • Usage Telemetry (BAC-37) - lua telemetry command for managing usage data collection
    • lua telemetry on/off/status
    • LUA_TELEMETRY=false environment variable for opt-out
  • Agent as Primitive - LuaAgent compiled through standard plugin pipeline (internal change, no user action needed)

Improvements Documented

  • keytar as optional dependency - Fixes installation on CI/CD systems without native build tools

[3.5.0] - 2026-02-20

Updated - Documentation for lua-cli v3.5.0

New Features Documented

  • User Lookup by Email or Phone - User.get() now supports email/phone lookup
    • User.get({ email: 'customer@example.com' }) - Look up by email
    • User.get({ phone: '+1234567890' }) - Look up by phone
    • Returns null instead of throwing when user not found
  • Integrations Command - Connect 250+ third-party services via Unified.to
    • lua integrations connect - OAuth and API token authentication
    • lua integrations list - View connected accounts
    • lua integrations webhooks - Manage webhook triggers
    • lua integrations mcp - Manage MCP servers for connections
    • Server-side finalization for reliable connection setup
    • Auth URL redirect resolution for seamless OAuth flows
  • Webhook Triggers for Integrations - Event-driven triggers that wake up your agent
    • --triggers flag for specifying events
    • --custom-webhook and --hook-url flags for custom webhook URLs
    • Triggers pre-selected by default in interactive mode
  • Project Backup & Restore - lua push backup and lua init --restore-sources
    • Content-addressed deduplication, S3 direct upload (no size limits)
  • CI/CD Mode - --ci global flag fails loudly on missing required flags
  • lua agents Command - List all organizations and agents with --json output
  • lua update Command - Self-update from npm with background outdated version warning
  • Auto-Add dist-v2/ to .gitignore - Added on compile and init
  • Variable References in Primitive Config - Variables, imports, and expressions in config properties
  • Complete push all - Now includes persona and source backup
  • MCP and Mastra Log Types - --type mcp and --type mastra in logs command
  • User ID Filtering in Logs - --user-id option
  • Non-Interactive Configure - --api-key, --email, --otp options
  • Non-Interactive Sandbox Views - lua persona sandbox view, lua skills sandbox view
  • Post-Process Display - Post-processed responses shown in chat streaming

Performance Improvements

  • Parallel server sync during compilation (~3-6s → ~1s)
  • Batch version checks in lua push all
  • Lazy authentication (no upfront validation call)

Breaking Changes

  • Push flag renamed: --version → --set-version
  • Compile sync default changed: --no-sync (opt-out) → --sync (opt-in)
  • New compile flag: --verbose for detailed output

Bug Fixes

  • Job creation regression from new bundle format (BAC-40)
  • Backup "request entity too large" with S3 presigned uploads (BAC-39)
  • MCP server duplicate name race condition (BAC-44)
  • Email channel creation aligned with API schema (LUA-122)
  • Agent config arrays with variables no longer silently empty
  • Webhook headerSchema key mapping fixed
  • Tool condition regression fixed
  • MCP server push pipeline (3 bugs) fixed
  • Auth error handling improved (403, sync propagation)
  • Compile sync stale config fixed
  • Marketplace approved-only filtering
  • PreProcessor test object format handling

Interface Changes

  • Added UserLookupOptions, EmailChannelMode, MCPServerSource
  • Added CreateGeneratedEmailChannelResponse, CreateExistingEmailChannelResponse
  • Added 'mcp' and 'mastra' to log type enums
  • Updated User.get() return type to UserDataInstance | null

[3.4.0] - 2026-01-22

Updated - Documentation for lua-cli v3.4.0

New Features Documented

  • Non-Destructive Compile Sync - lua compile now warns about orphaned primitives instead of auto-deleting
    • Safer workflow: orphaned skills/webhooks/jobs/MCP servers show warnings
    • Only CLI-sourced skills trigger warnings (not marketplace or manual)
  • Delete Commands - New explicit commands for removing primitives
    • lua skills delete --skill-name <name>
    • lua webhooks delete --webhook-name <name>
    • lua jobs delete --job-name <name>
    • Interactive confirmation with --force flag for automation
  • Streamable HTTP MCP Transport - Modern MCP transport (spec 2025-03-26)
    • New transport: 'streamable-http' option for MCP servers
    • Recommended over legacy sse transport for new integrations
    • stdio transport removed (not supported yet in production)

Bug Fixes

  • Fixed crash when pushing primitives without version field (first push)

Interface Changes

  • Added MCPStreamableHttpServerConfig interface
  • Updated MCPTransport type to 'sse' | 'streamable-http'
  • Added SkillSource type for tracking skill origin

[3.3.0] - 2026-01-20

Updated - Documentation for lua-cli v3.3.0

New Features Documented

  • Non-Interactive Mode - Complete automation support for all CLI commands
    • Consistent option naming patterns (--<entity>-name, --<entity>-version)
    • --force flag for dangerous operations
    • --json flag for machine-readable output
    • Action arguments for entity management
  • User Message and Agent Response Logs - Filter logs by user_message and agent_response types
  • MCP Server Environment Resolution - Function-based env() API in MCP configs
  • Products.get() Filter Support - New filter options with backward compatibility

Improvements

  • Chat works without mandatory skills
  • Better error handling and visual feedback in CLI

Bug Fixes

  • Normalized action handling for case-insensitive commands

[3.2.0] - 2026-01-13

Updated - Documentation for lua-cli v3.2.0

New Features Documented

  • Sync Command - lua sync for drift detection between server and local code
  • Chat Clear Command - lua chat clear to clear conversation history
  • Lua Runtime API - Lua.request.channel for channel identification
  • Lua.request.webhook - Access raw webhook payloads in tool execute functions
  • Marketplace Pagination - Browse skills with page navigation

Improvements

  • Simplified agent creation flow
  • Better TypeScript path alias support

Bug Fixes

  • Fixed sync command drift detection issues
  • Fixed skill publishing
  • Fixed compilation for inline skill definitions

[3.0.0] - 2025-12-07

Updated - Documentation for lua-cli v3.1.0

New Features Documented

  • MCP Server Support - LuaMCPServer class, lua mcp command
  • Tool Conditions - Dynamic tool availability with condition() function
  • CDN API - File upload and retrieval
  • Jobs API Enhancements - Jobs.getAll(), job.activate(), job.deactivate(), job.trigger()
  • Evaluations Dashboard - lua evals command
  • Templates API - WhatsApp template messaging
  • Marketplace CLI - Discover, install, and publish skills
  • Enhanced Logs Command - Interactive filtering by primitive type
  • Immutable User Profile - user._luaProfile for read-only core data

Breaking Changes Documented

  • JobInstance restructured (uses activeVersion)
  • welcomeMessage removed from LuaAgent
  • Webhook execute function signature changed to event object
  • PreProcessor response redesigned with discriminated union

Improvements

  • Data API type safety (searchText, Record types)
  • PostProcessor simplified return type
  • Removed deprecated async field from PreProcessor

[2.0.0] - 2025-10-04

Added - Complete Documentation Rewrite

CLI Documentation (34 pages)

  • Getting Started Section

    • Quick start guide with 5-minute setup
    • Complete installation and authentication guide
    • Task management tutorial (first skill)

  • Core Concepts Section

    • Skills and tools architecture explained
    • Platform APIs overview (User, Data, Products, Baskets, Orders)
    • Environment variables and configuration management
    • Development workflows and best practices

  • CLI Commands Section

    • Complete command reference for all CLI commands
    • Authentication commands (configure, key, logout)
    • Skill management (init, compile, test, push, deploy)
    • Development mode with live reload
    • Comprehensive troubleshooting guide

  • API Reference Section

    • LuaSkill class complete API documentation
    • LuaTool interface implementation guide
    • User API for profile management
    • Data API with vector search capabilities
    • Products API for e-commerce
    • Baskets API for shopping carts
    • Orders API for order management
    • Environment utilities (env function)

  • Template & Examples Section

    • Template project overview (30+ tools)
    • Project structure and file organization
    • Building custom skills step-by-step
    • Multi-skill project patterns
    • Best practices and professional patterns
    • 7 detailed tool examples (Weather, User Data, Products, Baskets, Custom Data, Payment)

Chat Widget Documentation (12 pages)

  • Getting Started

    • LuaPop introduction with features and benefits
    • 2-minute quick start guide
    • Installation for CDN, NPM, and platforms (WordPress, Shopify, etc.)

  • Configuration

    • Complete configuration reference with all options
    • Styling and customization guide
    • Events API and callbacks

  • Integration

    • Framework integration (React, Vue, Angular, Next.js, Svelte)
    • Real-world industry examples (E-commerce, SaaS, Healthcare, Hotels)
    • Migration guides from Intercom, Zendesk, Drift, Tawk.to, LiveChat

  • Advanced Features

    • Voice chat capabilities and setup
    • Analytics integration (Google Analytics, Mixpanel, Segment)
    • Comprehensive troubleshooting

Changed

  • Simplified navigation from 4 tabs to 2 tabs (CLI, Chat Widget)
  • Moved API Reference and Template Guide into CLI tab
  • Updated brand colors to match Lua AI purple theme
  • Updated logo references to PNG format

Removed

  • Old Mintlify template files and directories
  • Example content from template (ai-tools, essentials, etc.)
  • Template images and assets
  • Generic placeholder content

[1.0.0] - Previous

Initial Mintlify Template

  • Generic Mintlify starter template
  • Placeholder content
  • Example pages for reference

Future Planned Changes

Upcoming

  • Interactive code playground
  • Video tutorials
  • Community-contributed examples
  • Multi-language support
  • API versioning documentation
  • Performance optimization guides
  • Advanced deployment strategies

Under Consideration

  • GraphQL API documentation (if added to platform)
  • Mobile SDK documentation (if developed)
  • Desktop app documentation (if developed)
  • Enterprise features documentation
  • White-label documentation

Contributing

See CONTRIBUTING.md for how to contribute to this documentation.

Questions?

  • Discord Community: Join our Discord - Chat with other builders, get help, discuss ideas, and stay updated with announcements
  • Pull Requests: For contributions
  • Email: support@heylua.ai for general questions