lua-cli 3.5.0-alpha.3 → 3.5.0-alpha.5

package/dist/utils/semver.d.ts

@@ -25,3 +25,15 @@ export declare function parseVersion(version: string): {
  *  - 0 if version1 === version2
  */
 export declare function compareVersions(version1: string, version2: string): number;
+/**
+ * Increments the patch version automatically (e.g., 1.0.0 → 1.0.1).
+ * Preserves pre-release tag if present.
+ *
+ * @param version - Current version string (or undefined/null for first version)
+ * @returns Incremented version string
+ */
+export declare function incrementPatchVersion(version: string | undefined | null): string;
+/**
+ * Returns the higher of two semantic version strings.
+ */
+export declare function maxSemver(a: string, b: string): string;

package/dist/utils/semver.js

@@ -73,4 +73,27 @@ export function compareVersions(version1, version2) {
     }
     return v1.preRelease.localeCompare(v2.preRelease);
 }
+/**
+ * Increments the patch version automatically (e.g., 1.0.0 → 1.0.1).
+ * Preserves pre-release tag if present.
+ *
+ * @param version - Current version string (or undefined/null for first version)
+ * @returns Incremented version string
+ */
+export function incrementPatchVersion(version) {
+    // Handle undefined/null version - return default starting version
+    if (!version) {
+        return '0.0.1';
+    }
+    const parsed = parseVersion(version);
+    const newPatch = parsed.patch + 1;
+    const preRelease = parsed.preRelease ? `-${parsed.preRelease}` : '';
+    return `${parsed.major}.${parsed.minor}.${newPatch}${preRelease}`;
+}
+/**
+ * Returns the higher of two semantic version strings.
+ */
+export function maxSemver(a, b) {
+    return compareVersions(a, b) >= 0 ? a : b;
+}
 //# sourceMappingURL=semver.js.map

package/dist/utils/semver.js.map

@@ -1 +1 @@
-{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../src/utils/semver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../src/utils/semver.ts"],"names":[],"mappings":"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"}

package/dist/utils/sync-display.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Sync Display — Presentation layer for drift detection.
+ * Displays colored diffs, warnings, and comparison output.
+ */
+import type { PersonaDrift } from './sync-fetch.js';
+export declare function showColoredDiff(oldText: string, newText: string, oldLabel?: string, newLabel?: string): void;
+export declare function showPersonaDiff(serverPersona: string | null, localPersona: string): void;
+export declare function showDriftWarning(drift: PersonaDrift): void;
+export declare function showNameDiff(serverName: string | null, localName: string): void;

package/dist/utils/sync-display.js

@@ -0,0 +1,67 @@
+/**
+ * Sync Display — Presentation layer for drift detection.
+ * Displays colored diffs, warnings, and comparison output.
+ */
+import { diffLines } from 'diff';
+const colors = {
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    gray: '\x1b[90m',
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+};
+export function showColoredDiff(oldText, newText, oldLabel = 'Server', newLabel = 'Local') {
+    if (!oldText && !newText) {
+        console.log(colors.gray + '(both empty)' + colors.reset);
+        return;
+    }
+    if (!oldText) {
+        console.log(colors.green + `+ (${newLabel} only - no ${oldLabel} content)` + colors.reset);
+        return;
+    }
+    if (!newText) {
+        console.log(colors.red + `- (${oldLabel} only - no ${newLabel} content)` + colors.reset);
+        return;
+    }
+    const diff = diffLines(oldText, newText);
+    diff.forEach(part => {
+        if (part.added) {
+            part.value.split('\n').filter(l => l).forEach(line => console.log(colors.green + '+ ' + line + colors.reset));
+        }
+        else if (part.removed) {
+            part.value.split('\n').filter(l => l).forEach(line => console.log(colors.red + '- ' + line + colors.reset));
+        }
+        else {
+            const lines = part.value.split('\n').filter(l => l);
+            if (lines.length <= 6) {
+                lines.forEach(line => console.log(colors.gray + '  ' + line + colors.reset));
+            }
+            else {
+                lines.slice(0, 3).forEach(line => console.log(colors.gray + '  ' + line + colors.reset));
+                console.log(colors.gray + `  ... (${lines.length - 6} unchanged lines) ...` + colors.reset);
+                lines.slice(-3).forEach(line => console.log(colors.gray + '  ' + line + colors.reset));
+            }
+        }
+    });
+}
+export function showPersonaDiff(serverPersona, localPersona) {
+    console.log('\n' + '='.repeat(60));
+    console.log(colors.bold + 'PERSONA DIFF' + colors.reset);
+    console.log(colors.red + '- Server (deployed)' + colors.reset + '  ' + colors.green + '+ Local (code)' + colors.reset);
+    console.log('='.repeat(60) + '\n');
+    showColoredDiff(serverPersona || '', localPersona, 'Server', 'Local');
+    console.log('\n' + '='.repeat(60) + '\n');
+}
+export function showDriftWarning(drift) {
+    console.log('\n⚠️  Persona drift detected!');
+    console.log(`   Server version ${drift.serverVersion || 'unknown'} differs from local code.`);
+}
+export function showNameDiff(serverName, localName) {
+    console.log('\n' + '='.repeat(60));
+    console.log(colors.bold + 'NAME DIFF' + colors.reset);
+    console.log('='.repeat(60));
+    console.log(colors.red + `- Server: "${serverName || '(none)'}"` + colors.reset);
+    console.log(colors.green + `+ Local:  "${localName || '(none)'}"` + colors.reset);
+    console.log('='.repeat(60) + '\n');
+}
+//# sourceMappingURL=sync-display.js.map

package/dist/utils/sync-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-display.js","sourceRoot":"","sources":["../../src/utils/sync-display.ts"],"names":[],"mappings":"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"}

package/dist/utils/sync-fetch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Sync Fetch — Data fetching layer for drift detection.
+ * Fetches server state (persona, name) and compares with local code.
+ */
+export interface PersonaDrift {
+    hasDrift: boolean;
+    serverPersona: string | null;
+    localPersona: string;
+    serverVersion?: number;
+}
+export interface NameDrift {
+    hasDrift: boolean;
+    serverName: string | null;
+    localName: string;
+}
+export declare function comparePersona(serverPersona: string | null, localPersona: string): boolean;
+export declare function fetchServerPersona(apiKey: string, agentId: string): Promise<{
+    persona: string;
+    version: number;
+} | null>;
+export declare function checkPersonaDrift(apiKey: string, agentId: string): Promise<PersonaDrift | null>;
+export declare function fetchServerName(apiKey: string, agentId: string): Promise<string | null>;
+export declare function checkNameDrift(apiKey: string, agentId: string): Promise<NameDrift | null>;

package/dist/utils/sync-fetch.js

@@ -0,0 +1,64 @@
+/**
+ * Sync Fetch — Data fetching layer for drift detection.
+ * Fetches server state (persona, name) and compares with local code.
+ */
+import { BASE_URLS } from '../config/constants.js';
+import { getAgentName, getAgentPersona } from './artifact-loader.js';
+import PersonaApi from '../api/persona.api.service.js';
+import AgentApi from '../api/agent.api.service.js';
+function normalizeForComparison(str) {
+    return str
+        .trim()
+        .replace(/\\'/g, "'")
+        .replace(/\\"/g, '"')
+        .replace(/\\\\/g, '\\')
+        .replace(/\r\n/g, '\n')
+        .replace(/\r/g, '\n');
+}
+export function comparePersona(serverPersona, localPersona) {
+    if (serverPersona === null)
+        return false;
+    return normalizeForComparison(serverPersona) !== normalizeForComparison(localPersona);
+}
+export async function fetchServerPersona(apiKey, agentId) {
+    try {
+        const personaApi = new PersonaApi(BASE_URLS.API, apiKey, agentId);
+        const latestPublished = await personaApi.getLatestPublishedVersion();
+        if (latestPublished?.persona) {
+            return { persona: latestPublished.persona, version: latestPublished.version };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function checkPersonaDrift(apiKey, agentId) {
+    const localPersona = getAgentPersona() ?? '';
+    const serverData = await fetchServerPersona(apiKey, agentId);
+    const hasDrift = comparePersona(serverData?.persona || null, localPersona);
+    if (!hasDrift)
+        return null;
+    return { hasDrift: true, serverPersona: serverData?.persona || null, localPersona, serverVersion: serverData?.version };
+}
+export async function fetchServerName(apiKey, agentId) {
+    try {
+        const agentApi = new AgentApi(BASE_URLS.API, apiKey);
+        const response = await agentApi.getAgent(agentId);
+        return response.success && response.data?.name ? response.data.name : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function checkNameDrift(apiKey, agentId) {
+    const localName = getAgentName() ?? '';
+    const serverName = await fetchServerName(apiKey, agentId);
+    if (serverName === null)
+        return null;
+    const hasDrift = normalizeForComparison(serverName) !== normalizeForComparison(localName);
+    if (!hasDrift)
+        return null;
+    return { hasDrift: true, serverName, localName };
+}
+//# sourceMappingURL=sync-fetch.js.map

package/dist/utils/sync-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-fetch.js","sourceRoot":"","sources":["../../src/utils/sync-fetch.ts"],"names":[],"mappings":"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"}

package/dist/utils/sync-helpers.d.ts

@@ -1,61 +1,6 @@
 /**
- * Sync Helpers
- * Utilities for detecting drift between server state and local code
+ * Sync Helpers — barrel re-export for backward compatibility.
+ * Data fetching lives in sync-fetch.ts, display logic in sync-display.ts.
  */
-export interface PersonaDrift {
-    hasDrift: boolean;
-    serverPersona: string | null;
-    localPersona: string;
-    serverVersion?: number;
-}
-export interface NameDrift {
-    hasDrift: boolean;
-    serverName: string | null;
-    localName: string;
-}
-/**
- * Fetch the latest published persona version from the server.
- * Returns null if no persona is published or on error.
- *
- * Note: This returns the most recently published version, NOT the current/active one.
- * The current version might be an older rollback, but code should match the latest push.
- * Drafts are excluded since they haven't been deployed yet.
- */
-export declare function fetchServerPersona(apiKey: string, agentId: string): Promise<{
-    persona: string;
-    version: number;
-} | null>;
-/**
- * Compare server persona with local persona.
- * Returns true if they differ (drift detected).
- */
-export declare function comparePersona(serverPersona: string | null, localPersona: string): boolean;
-/**
- * Check for persona drift between server and local code.
- * Returns drift info if drift detected, null otherwise.
- */
-export declare function checkPersonaDrift(apiKey: string, agentId: string): Promise<PersonaDrift | null>;
-/**
- * Display a colored diff between two strings.
- */
-export declare function showColoredDiff(oldText: string, newText: string, oldLabel?: string, newLabel?: string): void;
-/**
- * Display a diff between server and local persona.
- */
-export declare function showPersonaDiff(serverPersona: string | null, localPersona: string): void;
-/**
- * Display a compact drift warning for compile flow.
- */
-export declare function showDriftWarning(drift: PersonaDrift): void;
-/**
- * Fetch the agent name from the server.
- */
-export declare function fetchServerName(apiKey: string, agentId: string): Promise<string | null>;
-/**
- * Check for name drift between server and local code.
- */
-export declare function checkNameDrift(apiKey: string, agentId: string): Promise<NameDrift | null>;
-/**
- * Display name drift info.
- */
-export declare function showNameDiff(serverName: string | null, localName: string): void;
+export { fetchServerPersona, fetchServerName, checkPersonaDrift, checkNameDrift, comparePersona, type PersonaDrift, type NameDrift, } from './sync-fetch.js';
+export { showColoredDiff, showPersonaDiff, showNameDiff, showDriftWarning, } from './sync-display.js';

package/dist/utils/sync-helpers.js

@@ -1,209 +1,7 @@
 /**
- * Sync Helpers
- * Utilities for detecting drift between server state and local code
+ * Sync Helpers — barrel re-export for backward compatibility.
+ * Data fetching lives in sync-fetch.ts, display logic in sync-display.ts.
  */
-import { diffLines } from 'diff';
-import { BASE_URLS } from '../config/constants.js';
-import { loadPersonaFromCode, loadNameFromCode } from './agent-code-utils.js';
-import PersonaApi from '../api/persona.api.service.js';
-import AgentApi from '../api/agent.api.service.js';
-// ANSI color codes
-const colors = {
-    red: '\x1b[31m',
-    green: '\x1b[32m',
-    gray: '\x1b[90m',
-    reset: '\x1b[0m',
-    bold: '\x1b[1m',
-};
-/**
- * Fetch the latest published persona version from the server.
- * Returns null if no persona is published or on error.
- *
- * Note: This returns the most recently published version, NOT the current/active one.
- * The current version might be an older rollback, but code should match the latest push.
- * Drafts are excluded since they haven't been deployed yet.
- */
-export async function fetchServerPersona(apiKey, agentId) {
-    try {
-        const personaApi = new PersonaApi(BASE_URLS.API, apiKey, agentId);
-        const latestPublished = await personaApi.getLatestPublishedVersion();
-        if (latestPublished && latestPublished.persona) {
-            return {
-                persona: latestPublished.persona,
-                version: latestPublished.version,
-            };
-        }
-        return null;
-    }
-    catch (error) {
-        // Silently fail - network issues shouldn't block compilation
-        return null;
-    }
-}
-/**
- * Normalize a string for comparison by handling escape sequences.
- * This ensures that semantically identical strings compare as equal
- * even if they have different escape representations.
- */
-function normalizeForComparison(str) {
-    return str
-        .trim()
-        // Normalize escaped quotes to unescaped
-        .replace(/\\'/g, "'")
-        .replace(/\\"/g, '"')
-        // Normalize escaped backslashes
-        .replace(/\\\\/g, '\\')
-        // Normalize line endings
-        .replace(/\r\n/g, '\n')
-        .replace(/\r/g, '\n');
-}
-/**
- * Compare server persona with local persona.
- * Returns true if they differ (drift detected).
- */
-export function comparePersona(serverPersona, localPersona) {
-    if (serverPersona === null) {
-        return false; // No server state to compare against
-    }
-    // Normalize both strings for comparison (handles escape sequence differences)
-    const normalizedServer = normalizeForComparison(serverPersona);
-    const normalizedLocal = normalizeForComparison(localPersona);
-    return normalizedServer !== normalizedLocal;
-}
-/**
- * Check for persona drift between server and local code.
- * Returns drift info if drift detected, null otherwise.
- */
-export async function checkPersonaDrift(apiKey, agentId) {
-    const localPersona = loadPersonaFromCode();
-    const serverData = await fetchServerPersona(apiKey, agentId);
-    const hasDrift = comparePersona(serverData?.persona || null, localPersona);
-    if (!hasDrift) {
-        return null;
-    }
-    return {
-        hasDrift: true,
-        serverPersona: serverData?.persona || null,
-        localPersona,
-        serverVersion: serverData?.version,
-    };
-}
-/**
- * Display a colored diff between two strings.
- */
-export function showColoredDiff(oldText, newText, oldLabel = 'Server', newLabel = 'Local') {
-    if (!oldText && !newText) {
-        console.log(colors.gray + '(both empty)' + colors.reset);
-        return;
-    }
-    if (!oldText) {
-        console.log(colors.green + `+ (${newLabel} only - no ${oldLabel} content)` + colors.reset);
-        return;
-    }
-    if (!newText) {
-        console.log(colors.red + `- (${oldLabel} only - no ${newLabel} content)` + colors.reset);
-        return;
-    }
-    const diff = diffLines(oldText, newText);
-    diff.forEach(part => {
-        if (part.added) {
-            // Added in local (green)
-            const lines = part.value.split('\n').filter(l => l);
-            lines.forEach(line => {
-                console.log(colors.green + '+ ' + line + colors.reset);
-            });
-        }
-        else if (part.removed) {
-            // Removed from server (red)
-            const lines = part.value.split('\n').filter(l => l);
-            lines.forEach(line => {
-                console.log(colors.red + '- ' + line + colors.reset);
-            });
-        }
-        else {
-            // Unchanged - show abbreviated context
-            const lines = part.value.split('\n').filter(l => l);
-            if (lines.length <= 6) {
-                lines.forEach(line => {
-                    console.log(colors.gray + '  ' + line + colors.reset);
-                });
-            }
-            else {
-                // Show first 3 and last 3 lines
-                lines.slice(0, 3).forEach(line => {
-                    console.log(colors.gray + '  ' + line + colors.reset);
-                });
-                console.log(colors.gray + `  ... (${lines.length - 6} unchanged lines) ...` + colors.reset);
-                lines.slice(-3).forEach(line => {
-                    console.log(colors.gray + '  ' + line + colors.reset);
-                });
-            }
-        }
-    });
-}
-/**
- * Display a diff between server and local persona.
- */
-export function showPersonaDiff(serverPersona, localPersona) {
-    console.log('\n' + '='.repeat(60));
-    console.log(colors.bold + 'PERSONA DIFF' + colors.reset);
-    console.log(colors.red + '- Server (deployed)' + colors.reset + '  ' + colors.green + '+ Local (code)' + colors.reset);
-    console.log('='.repeat(60) + '\n');
-    showColoredDiff(serverPersona || '', localPersona, 'Server', 'Local');
-    console.log('\n' + '='.repeat(60) + '\n');
-}
-/**
- * Display a compact drift warning for compile flow.
- */
-export function showDriftWarning(drift) {
-    console.log('\n⚠️  Persona drift detected!');
-    console.log(`   Server version ${drift.serverVersion || 'unknown'} differs from local code.`);
-}
-/**
- * Fetch the agent name from the server.
- */
-export async function fetchServerName(apiKey, agentId) {
-    try {
-        const agentApi = new AgentApi(BASE_URLS.API, apiKey);
-        const response = await agentApi.getAgent(agentId);
-        if (response.success && response.data?.name) {
-            return response.data.name;
-        }
-        return null;
-    }
-    catch (error) {
-        return null;
-    }
-}
-/**
- * Check for name drift between server and local code.
- */
-export async function checkNameDrift(apiKey, agentId) {
-    const localName = loadNameFromCode();
-    const serverName = await fetchServerName(apiKey, agentId);
-    if (serverName === null) {
-        return null; // No server state to compare against
-    }
-    // Use same normalization as persona comparison
-    const hasDrift = normalizeForComparison(serverName) !== normalizeForComparison(localName);
-    if (!hasDrift) {
-        return null;
-    }
-    return {
-        hasDrift: true,
-        serverName,
-        localName,
-    };
-}
-/**
- * Display name drift info.
- */
-export function showNameDiff(serverName, localName) {
-    console.log('\n' + '='.repeat(60));
-    console.log(colors.bold + 'NAME DIFF' + colors.reset);
-    console.log('='.repeat(60));
-    console.log(colors.red + `- Server: "${serverName || '(none)'}"` + colors.reset);
-    console.log(colors.green + `+ Local:  "${localName || '(none)'}"` + colors.reset);
-    console.log('='.repeat(60) + '\n');
-}
+export { fetchServerPersona, fetchServerName, checkPersonaDrift, checkNameDrift, comparePersona, } from './sync-fetch.js';
+export { showColoredDiff, showPersonaDiff, showNameDiff, showDriftWarning, } from './sync-display.js';
 //# sourceMappingURL=sync-helpers.js.map

package/dist/utils/sync-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync-helpers.js","sourceRoot":"","sources":["../../src/utils/sync-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync-helpers.js","sourceRoot":"","sources":["../../src/utils/sync-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,GAGf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/docs/API_INDEX.md

@@ -0,0 +1,100 @@
+# Complete API Index
+
+Quick reference for all lua-cli APIs and exports.
+
+## Core Classes
+
+| Class | Purpose | Import |
+|-------|---------|--------|
+| [LuaAgent](./api/LuaAgent.md) | Unified agent configuration | `import { LuaAgent } from 'lua-cli'` |
+| [LuaSkill](./api/LuaSkill.md) | Tool collection | `import { LuaSkill } from 'lua-cli'` |
+| [LuaTool](./api/LuaTool.md) | Individual tool interface | `import { LuaTool } from 'lua-cli/skill'` |
+| [LuaWebhook](./api/LuaWebhook.md) | HTTP webhook handler | `import { LuaWebhook } from 'lua-cli'` |
+| [LuaJob](./api/LuaJob.md) | Scheduled task | `import { LuaJob } from 'lua-cli'` |
+| [PreProcessor](./api/PreProcessor.md) | Message preprocessor | `import { PreProcessor } from 'lua-cli'` |
+| [PostProcessor](./api/PostProcessor.md) | Response postprocessor | `import { PostProcessor } from 'lua-cli'` |
+| LuaMCPServer | MCP server integration | `import { LuaMCPServer } from 'lua-cli'` |
+
+## Runtime APIs
+
+| API | Purpose | Methods |
+|-----|---------|---------|
+| [AI](./api/AI.md) | AI text generation | `generate()` |
+| [User](./api/User.md) | User data management | `get()`, `getChatHistory()` |
+| [Products](./api/Products.md) | Product catalog | `get()`, `search()`, `getById()`, `create()`, `update()`, `delete()` |
+| [Baskets](./api/Baskets.md) | Shopping carts | `get()`, `create()`, `getById()`, `addItem()`, `clear()`, `placeOrder()` |
+| [Orders](./api/Orders.md) | Order management | `get()`, `getById()`, `create()`, `updateStatus()`, `updateData()` |
+| [Data](./api/Data.md) | Custom data storage | `get()`, `getEntry()`, `search()`, `create()`, `update()`, `delete()` |
+| [Jobs](./api/Jobs.md) | Dynamic job creation | `create()`, `getJob()`, `getAll()` |
+| [Templates](./api/Templates.md) | WhatsApp templates | `Templates.whatsapp.list()`, `.get()`, `.send()` |
+| [CDN](./api/CDN.md) | File upload/download | `upload()`, `get()` |
+| Lua | Runtime context | `Lua.request.channel`, `Lua.request.webhook` |
+
+## Instance Classes
+
+| Instance | Description | Key Methods |
+|----------|-------------|-------------|
+| UserDataInstance | User data with proxy access | `update()`, `send()`, `clear()`, `save()`, `getChatHistory()` |
+| ProductInstance | Product with CRUD methods | `update()`, `delete()`, `save()` |
+| BasketInstance | Shopping cart with operations | `addItem()`, `removeItem()`, `clear()`, `placeOrder()` |
+| OrderInstance | Order with status management | `updateStatus()`, `updateData()`, `save()` |
+| DataEntryInstance | Custom data entry | `update()`, `delete()`, `save()` |
+| JobInstance | Job with metadata access | `user()`, `updateMetadata()`, `delete()` |
+
+## Enums
+
+| Enum | Values | Usage |
+|------|--------|-------|
+| BasketStatus | `ACTIVE`, `CHECKED_OUT`, `ABANDONED`, `EXPIRED` | Basket state management |
+| OrderStatus | `PENDING`, `CONFIRMED`, `FULFILLED`, `CANCELLED` | Order state tracking |
+
+## Utilities
+
+| Function | Purpose | Example |
+|----------|---------|---------|
+| [env()](./api/env.md) | Access environment variables | `env('API_KEY')` |
+
+## Type Definitions
+
+| Type | Description | File |
+|------|-------------|------|
+| ChatMessage | Message format for user communication | See [User API](./api/User.md) |
+| JobSchedule | Job scheduling configuration | See [Jobs API](./api/Jobs.md) |
+| Product | Product data structure | See [Products API](./api/Products.md) |
+| Basket | Basket data structure | See [Baskets API](./api/Baskets.md) |
+| Order | Order data structure | See [Orders API](./api/Orders.md) |
+
+## Quick Links by Use Case
+
+### Building an Agent
+1. [LuaAgent](./api/LuaAgent.md) - Configure your agent
+2. [LuaSkill](./api/LuaSkill.md) - Organize tools
+3. [LuaTool](./api/LuaTool.md) - Create tools
+
+### E-commerce
+1. [Products API](./api/Products.md) - Manage catalog
+2. [Baskets API](./api/Baskets.md) - Shopping carts
+3. [Orders API](./api/Orders.md) - Process orders
+4. [CDN API](./api/CDN.md) - Product images/files
+
+### Automation
+1. [LuaJob](./api/LuaJob.md) - Scheduled tasks (cron, intervals)
+2. [Jobs API](./api/Jobs.md) - Dynamic job creation from tools
+3. [LuaWebhook](./api/LuaWebhook.md) - External HTTP triggers
+4. [PreProcessor](./api/PreProcessor.md) - Filter incoming messages
+5. [PostProcessor](./api/PostProcessor.md) - Format responses
+
+### Data Management
+1. [User API](./api/User.md) - User data
+2. [Data API](./api/Data.md) - Custom collections
+3. [CDN API](./api/CDN.md) - File storage
+4. env() - Environment config
+
+### Communication
+1. [User API](./api/User.md) - Send messages to users
+2. [Templates API](./api/Templates.md) - WhatsApp template messages
+3. [AI API](./api/AI.md) - Generate AI responses
+
+---
+
+**See [README](./README.md) for complete documentation navigation**