lua-cli 3.15.0 → 3.15.2

package/dist/utils/build-manifest-from-disk.js

@@ -0,0 +1,111 @@
+/**
+ * buildManifestFromDisk
+ *
+ * Walk a project directory, hash every file we'd consider "source", and
+ * return a fresh BackupManifest. Replaces the broken
+ * `reconcileManifestWithDisk` (in backup-helpers.ts), which only re-hashed
+ * files already present in the compiled `manifest.json` — so files
+ * written by the Builder (or any out-of-band write that bypasses
+ * `lua compile`) never made it into the backup.
+ *
+ * Used by `runBackupPush({ fresh: true })` so auto-backup-push after every
+ * primitive push captures everything currently on disk, not just what
+ * the most recent compile happened to know about.
+ */
+import { readdirSync, readFileSync, statSync } from 'fs';
+import { join, sep } from 'path';
+import { hashContent, shouldSkipFile, shouldSkipDirectory } from '../compiler/utils/common.js';
+import { calculateProjectHash } from './backup-helpers.js';
+// Reuse the compiler's `shouldSkipFile` / `shouldSkipDirectory` helpers to
+// keep the fresh-from-disk file set identical to the compiled-manifest path.
+// Otherwise dotfiles (`.eslintrc`, `.vscode/`, `.prettierrc`), test files
+// (`*.test.ts`, `*.spec.ts`, `__tests__/`), `.d.ts`, `.map`, and lockfiles
+// would land in fresh manifests but not compiled ones, producing a different
+// projectHash for identical content and triggering false out-of-sync flags
+// every time the user toggled between the two modes.
+const MAX_FILE_BYTES = 256 * 1024;
+export function buildManifestFromDisk(projectPath, agentId) {
+    const files = [];
+    walk(projectPath, '', files);
+    files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+    // Use the SAME hash + projectHash function as the compiled-manifest path
+    // (`prepareFileRefs` + `calculateProjectHash` in backup-helpers.ts). Otherwise
+    // blob dedup breaks across paths — the same file content uploaded under a
+    // 16-char hash via the compiled path is invisible when looked up under a
+    // 64-char hash via the fresh path. Same goes for projectHash: switching
+    // between fresh and non-fresh modes must produce the same hash for
+    // identical content, otherwise `isBackupOutOfSync` flags every push.
+    const projectFiles = files.map((f) => ({ relativePath: f.relativePath, hash: f.hash }));
+    const totalSize = files.reduce((acc, f) => acc + f.size, 0);
+    return {
+        agentId,
+        // orgId is unknown at this layer; the caller (runBackupPush) supplies
+        // it when sending to the server. The disk-side manifest just needs the
+        // shape to satisfy the type.
+        orgId: '',
+        projectHash: calculateProjectHash(projectFiles),
+        fileCount: files.length,
+        totalSize,
+        createdBy: 'cli',
+        createdAt: new Date().toISOString(),
+        files,
+    };
+}
+function walk(root, relPrefix, out) {
+    const dir = relPrefix ? join(root, relPrefix) : root;
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            // Two-pass directory skip:
+            //   - shouldSkipDirectory covers the curated build/cache list
+            //     (node_modules / dist / dist-v2 / .git / .lua / .temp /
+            //      coverage / .next / .turbo)
+            //   - shouldSkipFile also rejects `__tests__/`, dotted dirs,
+            //     and any path containing `node_modules` / `__tests__` —
+            //     applying it to the directory NAME catches those branches
+            //     and keeps the compiled path's exclusion set in lockstep.
+            if (shouldSkipDirectory(entry.name))
+                continue;
+            if (shouldSkipFile(entry.name))
+                continue;
+            walk(root, relPrefix ? `${relPrefix}${sep}${entry.name}` : entry.name, out);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        // shouldSkipFile covers dotfiles, test files, .d.ts/.map, lockfiles,
+        // and node_modules paths — keeping the fresh manifest file set
+        // identical to the compiled path's so projectHash matches across modes.
+        if (shouldSkipFile(entry.name))
+            continue;
+        const rel = (relPrefix ? `${relPrefix}${sep}${entry.name}` : entry.name).split(sep).join('/');
+        const abs = join(root, rel);
+        const stat = statSync(abs);
+        if (stat.size > MAX_FILE_BYTES)
+            continue;
+        let content;
+        try {
+            content = readFileSync(abs);
+        }
+        catch {
+            continue;
+        }
+        const hash = hashContent(content.toString('utf-8'));
+        out.push({
+            relativePath: rel,
+            hash,
+            size: stat.size,
+            type: classifyFile(rel),
+        });
+    }
+}
+function classifyFile(relPath) {
+    if (relPath.endsWith('.ts') || relPath.endsWith('.tsx') || relPath.endsWith('.js') || relPath.endsWith('.jsx')) {
+        return 'source';
+    }
+    if (relPath.endsWith('.yaml') || relPath.endsWith('.yml') || relPath.endsWith('.json') || relPath.endsWith('.toml')) {
+        return 'config';
+    }
+    return 'other';
+}
+//# sourceMappingURL=build-manifest-from-disk.js.map

package/dist/utils/build-manifest-from-disk.js.map

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

package/node_modules/@lua/shared-types/dist/index.d.mts

@@ -216,6 +216,69 @@ interface AgentInvocationOutput {
     threadId?: string;
 }
 
+/**
+ * Wire-format types for `GET /chat/history/:agentId` and the VM-sandbox
+ * `User.getChatHistory()` API. Both paths return the same shape.
+ *
+ * Shared between lua-core (HTTP controller + VM devtools) and lua-cli
+ * (HTTP client typing for `lua test`). Also shared with lua-api's
+ * `thread.service.ts` (admin org-thread listing) so the parser never
+ * diverges across services.
+ */
+/**
+ * One content part of a chat-history message.
+ *
+ * `text` parts carry plain text. Media parts (`image` / `video` / `audio`
+ * / `file`) carry a URL or base64 payload in `data` (or `image` / `video`
+ * for legacy reasons) plus a `mediaType` MIME string.
+ */
+interface ChatHistoryContent {
+    type: 'text' | 'image' | 'video' | 'audio' | 'file';
+    text?: string;
+    image?: string;
+    video?: string;
+    data?: string;
+    mediaType?: string;
+    latitude?: number;
+    longitude?: number;
+}
+/**
+ * One message returned by chat-history endpoints.
+ *
+ * Only `user` and `assistant` roles surface — system / tool messages are
+ * filtered out before transport.
+ */
+interface ChatHistoryMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    /** ISO-8601 timestamp string. */
+    createdAt: string;
+    content: ChatHistoryContent[];
+}
+/**
+ * Strip `::: navigate …:::` blocks from a text string.
+ *
+ * Exposed because both lua-core's chat-history transform and any future
+ * external transform may need it independently.
+ */
+declare function removeNavigateBlock(input: string): string;
+/**
+ * Transform raw Mastra `MastraMessageContentV2.parts[]` into the
+ * `ChatHistoryContent[]` wire shape.
+ *
+ * Single source of truth for the conversion: used by lua-core's
+ * `toChatHistoryMessage` (HTTP + VM sandbox paths) and lua-api's
+ * `thread.service.ts` admin org-thread listing. Any future divergence
+ * starts here.
+ *
+ * Parts are deliberately typed `unknown` because callers may either pass
+ * Mastra v5 `MastraMessagePart` instances (lua-core, via `@mastra/core`)
+ * or raw JSON parsed from a SQL row (lua-api, reading `mastra_messages`
+ * directly). The function only inspects `.type`, `.text`, `.data`, and
+ * `.mimeType` via property access, so both shapes work.
+ */
+declare function transformChatHistoryContentParts(parts: unknown[] | undefined | null): ChatHistoryContent[];
+
 /**
  * Sandbox contract: defines what every sandbox MUST expose.
  * Both lua-cli and lua-core test against this contract.
@@ -471,6 +534,20 @@ interface BatchingConfig {
     debounceWindowMs?: number;
     /** Maximum messages collected in a single batch. */
     maxBatchMessages?: number;
+    /**
+     * Strict sequential turn execution. When `true`, a new message arriving while a turn is
+     * in-flight does NOT abort the running turn — it waits in a batch until the current turn
+     * completes, then runs against the post-reply state. Trades latency for correctness:
+     * eliminates duplicate/contradictory replies and side-effect-then-no-reply failures from
+     * mid-tool aborts. No effect when `debounceWindowMs` is 0 (batching disabled).
+     *
+     * Most useful with the stream endpoint. Generate callers (e.g. lua-whatsapp, sync HTTP)
+     * may hit ingress / client timeouts on long waits regardless of backend serialization.
+     *
+     * Per-agent only — there is no platform-wide env var override (deliberate: a global
+     * switch would silently flip every batching-enabled agent at once). Default: `false`.
+     */
+    serializeProcessing?: boolean;
 }
 /**
  * Governance SDK configuration persisted on the SubAgent document.
@@ -526,4 +603,4 @@ interface ChatErrorChunk {
     timestamp: number;
 }
 
-export { AGENT_LOG_SOURCES, type AgentInvocationInput, type AgentInvocationOutput, type AgentLogMetadata, type AgentLogSource, type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type ApprovedModelDef, type BatchingConfig, CLIENT_TOOLS_MAX, CLIENT_TOOL_PREFIX, type CachedDeviceCommand, type CachedDeviceDefinition, type CachedDeviceTrigger, type CachedDeviceTriggerDefinition, type Channel, type ChatErrorChunk, type ClientToolDef, type CommandHashData, type CommandState, type CommandStreamEntry, type DeviceCommandDefinition, type DeviceCommandMessage, type DeviceInfo, type DeviceResponseMessage, type DeviceStatus, type DeviceTriggerAckMessage, type DeviceTriggerMessage, type GovernanceConfig, type PersonaText, REQUIRED_ENUMS, REQUIRED_NESTED_APIS, REQUIRED_PLATFORM_APIS, REQUIRED_PRIMITIVE_SHIMS, REQUIRED_UTILITIES, type ResponseStreamEntry, type SkillContextText, type TriggerStreamEntry, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified, buildDefaultPersona, flattenPersonaText, flattenPersonaTextAll, hasPersonaTextContent, isPersonaTextObject, personaToLiteral };
+export { AGENT_LOG_SOURCES, type AgentInvocationInput, type AgentInvocationOutput, type AgentLogMetadata, type AgentLogSource, type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type ApprovedModelDef, type BatchingConfig, CLIENT_TOOLS_MAX, CLIENT_TOOL_PREFIX, type CachedDeviceCommand, type CachedDeviceDefinition, type CachedDeviceTrigger, type CachedDeviceTriggerDefinition, type Channel, type ChatErrorChunk, type ChatHistoryContent, type ChatHistoryMessage, type ClientToolDef, type CommandHashData, type CommandState, type CommandStreamEntry, type DeviceCommandDefinition, type DeviceCommandMessage, type DeviceInfo, type DeviceResponseMessage, type DeviceStatus, type DeviceTriggerAckMessage, type DeviceTriggerMessage, type GovernanceConfig, type PersonaText, REQUIRED_ENUMS, REQUIRED_NESTED_APIS, REQUIRED_PLATFORM_APIS, REQUIRED_PRIMITIVE_SHIMS, REQUIRED_UTILITIES, type ResponseStreamEntry, type SkillContextText, type TriggerStreamEntry, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified, buildDefaultPersona, flattenPersonaText, flattenPersonaTextAll, hasPersonaTextContent, isPersonaTextObject, personaToLiteral, removeNavigateBlock, transformChatHistoryContentParts };

package/node_modules/@lua/shared-types/dist/index.d.ts

@@ -216,6 +216,69 @@ interface AgentInvocationOutput {
     threadId?: string;
 }
 
+/**
+ * Wire-format types for `GET /chat/history/:agentId` and the VM-sandbox
+ * `User.getChatHistory()` API. Both paths return the same shape.
+ *
+ * Shared between lua-core (HTTP controller + VM devtools) and lua-cli
+ * (HTTP client typing for `lua test`). Also shared with lua-api's
+ * `thread.service.ts` (admin org-thread listing) so the parser never
+ * diverges across services.
+ */
+/**
+ * One content part of a chat-history message.
+ *
+ * `text` parts carry plain text. Media parts (`image` / `video` / `audio`
+ * / `file`) carry a URL or base64 payload in `data` (or `image` / `video`
+ * for legacy reasons) plus a `mediaType` MIME string.
+ */
+interface ChatHistoryContent {
+    type: 'text' | 'image' | 'video' | 'audio' | 'file';
+    text?: string;
+    image?: string;
+    video?: string;
+    data?: string;
+    mediaType?: string;
+    latitude?: number;
+    longitude?: number;
+}
+/**
+ * One message returned by chat-history endpoints.
+ *
+ * Only `user` and `assistant` roles surface — system / tool messages are
+ * filtered out before transport.
+ */
+interface ChatHistoryMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    /** ISO-8601 timestamp string. */
+    createdAt: string;
+    content: ChatHistoryContent[];
+}
+/**
+ * Strip `::: navigate …:::` blocks from a text string.
+ *
+ * Exposed because both lua-core's chat-history transform and any future
+ * external transform may need it independently.
+ */
+declare function removeNavigateBlock(input: string): string;
+/**
+ * Transform raw Mastra `MastraMessageContentV2.parts[]` into the
+ * `ChatHistoryContent[]` wire shape.
+ *
+ * Single source of truth for the conversion: used by lua-core's
+ * `toChatHistoryMessage` (HTTP + VM sandbox paths) and lua-api's
+ * `thread.service.ts` admin org-thread listing. Any future divergence
+ * starts here.
+ *
+ * Parts are deliberately typed `unknown` because callers may either pass
+ * Mastra v5 `MastraMessagePart` instances (lua-core, via `@mastra/core`)
+ * or raw JSON parsed from a SQL row (lua-api, reading `mastra_messages`
+ * directly). The function only inspects `.type`, `.text`, `.data`, and
+ * `.mimeType` via property access, so both shapes work.
+ */
+declare function transformChatHistoryContentParts(parts: unknown[] | undefined | null): ChatHistoryContent[];
+
 /**
  * Sandbox contract: defines what every sandbox MUST expose.
  * Both lua-cli and lua-core test against this contract.
@@ -471,6 +534,20 @@ interface BatchingConfig {
     debounceWindowMs?: number;
     /** Maximum messages collected in a single batch. */
     maxBatchMessages?: number;
+    /**
+     * Strict sequential turn execution. When `true`, a new message arriving while a turn is
+     * in-flight does NOT abort the running turn — it waits in a batch until the current turn
+     * completes, then runs against the post-reply state. Trades latency for correctness:
+     * eliminates duplicate/contradictory replies and side-effect-then-no-reply failures from
+     * mid-tool aborts. No effect when `debounceWindowMs` is 0 (batching disabled).
+     *
+     * Most useful with the stream endpoint. Generate callers (e.g. lua-whatsapp, sync HTTP)
+     * may hit ingress / client timeouts on long waits regardless of backend serialization.
+     *
+     * Per-agent only — there is no platform-wide env var override (deliberate: a global
+     * switch would silently flip every batching-enabled agent at once). Default: `false`.
+     */
+    serializeProcessing?: boolean;
 }
 /**
  * Governance SDK configuration persisted on the SubAgent document.
@@ -526,4 +603,4 @@ interface ChatErrorChunk {
     timestamp: number;
 }
 
-export { AGENT_LOG_SOURCES, type AgentInvocationInput, type AgentInvocationOutput, type AgentLogMetadata, type AgentLogSource, type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type ApprovedModelDef, type BatchingConfig, CLIENT_TOOLS_MAX, CLIENT_TOOL_PREFIX, type CachedDeviceCommand, type CachedDeviceDefinition, type CachedDeviceTrigger, type CachedDeviceTriggerDefinition, type Channel, type ChatErrorChunk, type ClientToolDef, type CommandHashData, type CommandState, type CommandStreamEntry, type DeviceCommandDefinition, type DeviceCommandMessage, type DeviceInfo, type DeviceResponseMessage, type DeviceStatus, type DeviceTriggerAckMessage, type DeviceTriggerMessage, type GovernanceConfig, type PersonaText, REQUIRED_ENUMS, REQUIRED_NESTED_APIS, REQUIRED_PLATFORM_APIS, REQUIRED_PRIMITIVE_SHIMS, REQUIRED_UTILITIES, type ResponseStreamEntry, type SkillContextText, type TriggerStreamEntry, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified, buildDefaultPersona, flattenPersonaText, flattenPersonaTextAll, hasPersonaTextContent, isPersonaTextObject, personaToLiteral };
+export { AGENT_LOG_SOURCES, type AgentInvocationInput, type AgentInvocationOutput, type AgentLogMetadata, type AgentLogSource, type AiGenerateInput, type AiGenerateOutput, type AiGenerateSource, type AiGenerateToolCall, type AiGenerateToolResult, type ApprovedModelDef, type BatchingConfig, CLIENT_TOOLS_MAX, CLIENT_TOOL_PREFIX, type CachedDeviceCommand, type CachedDeviceDefinition, type CachedDeviceTrigger, type CachedDeviceTriggerDefinition, type Channel, type ChatErrorChunk, type ChatHistoryContent, type ChatHistoryMessage, type ClientToolDef, type CommandHashData, type CommandState, type CommandStreamEntry, type DeviceCommandDefinition, type DeviceCommandMessage, type DeviceInfo, type DeviceResponseMessage, type DeviceStatus, type DeviceTriggerAckMessage, type DeviceTriggerMessage, type GovernanceConfig, type PersonaText, REQUIRED_ENUMS, REQUIRED_NESTED_APIS, REQUIRED_PLATFORM_APIS, REQUIRED_PRIMITIVE_SHIMS, REQUIRED_UTILITIES, type ResponseStreamEntry, type SkillContextText, type TriggerStreamEntry, UNSTRUCTURED_SUPPORTED_MEDIA_TYPES, aiGenerateInputFromSimplified, buildDefaultPersona, flattenPersonaText, flattenPersonaTextAll, hasPersonaTextContent, isPersonaTextObject, personaToLiteral, removeNavigateBlock, transformChatHistoryContentParts };

package/node_modules/@lua/shared-types/dist/index.js

@@ -35,7 +35,9 @@ __export(index_exports, {
   flattenPersonaTextAll: () => flattenPersonaTextAll,
   hasPersonaTextContent: () => hasPersonaTextContent,
   isPersonaTextObject: () => isPersonaTextObject,
-  personaToLiteral: () => personaToLiteral
+  personaToLiteral: () => personaToLiteral,
+  removeNavigateBlock: () => removeNavigateBlock,
+  transformChatHistoryContentParts: () => transformChatHistoryContentParts
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -165,6 +167,74 @@ function aiGenerateInputFromSimplified(prompt, content) {
 }
 __name(aiGenerateInputFromSimplified, "aiGenerateInputFromSimplified");
 
+// src/chat-history.types.ts
+function removeNavigateBlock(input) {
+  return input.replace(/::: navigate[\s\S]*?:::/g, "").trim();
+}
+__name(removeNavigateBlock, "removeNavigateBlock");
+function transformChatHistoryContentParts(parts) {
+  const content = [];
+  for (const rawPart of parts ?? []) {
+    const part = rawPart;
+    if (part?.type !== "text" && part?.type !== "file") continue;
+    if (part.type === "text" && typeof part.text === "string") {
+      const rawText = part.text || "";
+      if (rawText.includes("::: hide")) continue;
+      const audioMatch = rawText.match(/::: audio\s*!\[(.*?)\]\((.*?)\)\s*:::/);
+      const videoMatch = rawText.match(/::: video\s*!\[(.*?)\]\((.*?)\)\s*:::/);
+      if (audioMatch) {
+        content.push({
+          type: "audio",
+          data: audioMatch[2],
+          mediaType: audioMatch[1]
+        });
+      } else if (videoMatch) {
+        content.push({
+          type: "video",
+          video: videoMatch[2],
+          mediaType: videoMatch[1]
+        });
+      } else {
+        let text = rawText.replace(/\\\\\\n/g, "\n");
+        text = removeNavigateBlock(text);
+        content.push({
+          type: "text",
+          text
+        });
+      }
+    } else if (part.type === "file") {
+      const mediaType = part.mimeType || "";
+      if (mediaType.startsWith("image/")) {
+        content.push({
+          type: "image",
+          image: part.data,
+          mediaType
+        });
+      } else if (mediaType.startsWith("video/")) {
+        content.push({
+          type: "video",
+          video: part.data,
+          mediaType
+        });
+      } else if (mediaType.startsWith("audio/")) {
+        content.push({
+          type: "audio",
+          data: part.data,
+          mediaType
+        });
+      } else {
+        content.push({
+          type: "file",
+          data: part.data,
+          mediaType
+        });
+      }
+    }
+  }
+  return content;
+}
+__name(transformChatHistoryContentParts, "transformChatHistoryContentParts");
+
 // src/sandbox-contract.ts
 var REQUIRED_PRIMITIVE_SHIMS = [
   // Class-based
@@ -359,5 +429,7 @@ var AGENT_LOG_SOURCES = [
   flattenPersonaTextAll,
   hasPersonaTextContent,
   isPersonaTextObject,
-  personaToLiteral
+  personaToLiteral,
+  removeNavigateBlock,
+  transformChatHistoryContentParts
 });

package/node_modules/@lua/shared-types/dist/index.mjs

@@ -127,6 +127,74 @@ function aiGenerateInputFromSimplified(prompt, content) {
 }
 __name(aiGenerateInputFromSimplified, "aiGenerateInputFromSimplified");
 
+// src/chat-history.types.ts
+function removeNavigateBlock(input) {
+  return input.replace(/::: navigate[\s\S]*?:::/g, "").trim();
+}
+__name(removeNavigateBlock, "removeNavigateBlock");
+function transformChatHistoryContentParts(parts) {
+  const content = [];
+  for (const rawPart of parts ?? []) {
+    const part = rawPart;
+    if (part?.type !== "text" && part?.type !== "file") continue;
+    if (part.type === "text" && typeof part.text === "string") {
+      const rawText = part.text || "";
+      if (rawText.includes("::: hide")) continue;
+      const audioMatch = rawText.match(/::: audio\s*!\[(.*?)\]\((.*?)\)\s*:::/);
+      const videoMatch = rawText.match(/::: video\s*!\[(.*?)\]\((.*?)\)\s*:::/);
+      if (audioMatch) {
+        content.push({
+          type: "audio",
+          data: audioMatch[2],
+          mediaType: audioMatch[1]
+        });
+      } else if (videoMatch) {
+        content.push({
+          type: "video",
+          video: videoMatch[2],
+          mediaType: videoMatch[1]
+        });
+      } else {
+        let text = rawText.replace(/\\\\\\n/g, "\n");
+        text = removeNavigateBlock(text);
+        content.push({
+          type: "text",
+          text
+        });
+      }
+    } else if (part.type === "file") {
+      const mediaType = part.mimeType || "";
+      if (mediaType.startsWith("image/")) {
+        content.push({
+          type: "image",
+          image: part.data,
+          mediaType
+        });
+      } else if (mediaType.startsWith("video/")) {
+        content.push({
+          type: "video",
+          video: part.data,
+          mediaType
+        });
+      } else if (mediaType.startsWith("audio/")) {
+        content.push({
+          type: "audio",
+          data: part.data,
+          mediaType
+        });
+      } else {
+        content.push({
+          type: "file",
+          data: part.data,
+          mediaType
+        });
+      }
+    }
+  }
+  return content;
+}
+__name(transformChatHistoryContentParts, "transformChatHistoryContentParts");
+
 // src/sandbox-contract.ts
 var REQUIRED_PRIMITIVE_SHIMS = [
   // Class-based
@@ -320,5 +388,7 @@ export {
   flattenPersonaTextAll,
   hasPersonaTextContent,
   isPersonaTextObject,
-  personaToLiteral
+  personaToLiteral,
+  removeNavigateBlock,
+  transformChatHistoryContentParts
 };

package/node_modules/@lua/shared-types/src/agent-config.types.ts

@@ -9,6 +9,20 @@ export interface BatchingConfig {
   debounceWindowMs?: number;
   /** Maximum messages collected in a single batch. */
   maxBatchMessages?: number;
+  /**
+   * Strict sequential turn execution. When `true`, a new message arriving while a turn is
+   * in-flight does NOT abort the running turn — it waits in a batch until the current turn
+   * completes, then runs against the post-reply state. Trades latency for correctness:
+   * eliminates duplicate/contradictory replies and side-effect-then-no-reply failures from
+   * mid-tool aborts. No effect when `debounceWindowMs` is 0 (batching disabled).
+   *
+   * Most useful with the stream endpoint. Generate callers (e.g. lua-whatsapp, sync HTTP)
+   * may hit ingress / client timeouts on long waits regardless of backend serialization.
+   *
+   * Per-agent only — there is no platform-wide env var override (deliberate: a global
+   * switch would silently flip every batching-enabled agent at once). Default: `false`.
+   */
+  serializeProcessing?: boolean;
 }
 
 /**

package/node_modules/@lua/shared-types/src/chat-history.types.ts

@@ -0,0 +1,112 @@
+/**
+ * Wire-format types for `GET /chat/history/:agentId` and the VM-sandbox
+ * `User.getChatHistory()` API. Both paths return the same shape.
+ *
+ * Shared between lua-core (HTTP controller + VM devtools) and lua-cli
+ * (HTTP client typing for `lua test`). Also shared with lua-api's
+ * `thread.service.ts` (admin org-thread listing) so the parser never
+ * diverges across services.
+ */
+
+/**
+ * One content part of a chat-history message.
+ *
+ * `text` parts carry plain text. Media parts (`image` / `video` / `audio`
+ * / `file`) carry a URL or base64 payload in `data` (or `image` / `video`
+ * for legacy reasons) plus a `mediaType` MIME string.
+ */
+export interface ChatHistoryContent {
+  type: 'text' | 'image' | 'video' | 'audio' | 'file';
+  text?: string;
+  image?: string;
+  video?: string;
+  data?: string;
+  mediaType?: string;
+  latitude?: number;
+  longitude?: number;
+}
+
+/**
+ * One message returned by chat-history endpoints.
+ *
+ * Only `user` and `assistant` roles surface — system / tool messages are
+ * filtered out before transport.
+ */
+export interface ChatHistoryMessage {
+  id: string;
+  role: 'user' | 'assistant';
+  /** ISO-8601 timestamp string. */
+  createdAt: string;
+  content: ChatHistoryContent[];
+}
+
+/**
+ * Strip `::: navigate …:::` blocks from a text string.
+ *
+ * Exposed because both lua-core's chat-history transform and any future
+ * external transform may need it independently.
+ */
+export function removeNavigateBlock(input: string): string {
+  return input.replace(/::: navigate[\s\S]*?:::/g, '').trim();
+}
+
+/**
+ * Transform raw Mastra `MastraMessageContentV2.parts[]` into the
+ * `ChatHistoryContent[]` wire shape.
+ *
+ * Single source of truth for the conversion: used by lua-core's
+ * `toChatHistoryMessage` (HTTP + VM sandbox paths) and lua-api's
+ * `thread.service.ts` admin org-thread listing. Any future divergence
+ * starts here.
+ *
+ * Parts are deliberately typed `unknown` because callers may either pass
+ * Mastra v5 `MastraMessagePart` instances (lua-core, via `@mastra/core`)
+ * or raw JSON parsed from a SQL row (lua-api, reading `mastra_messages`
+ * directly). The function only inspects `.type`, `.text`, `.data`, and
+ * `.mimeType` via property access, so both shapes work.
+ */
+export function transformChatHistoryContentParts(parts: unknown[] | undefined | null): ChatHistoryContent[] {
+  const content: ChatHistoryContent[] = [];
+
+  for (const rawPart of parts ?? []) {
+    const part = rawPart as { type?: string; text?: string; data?: string; mimeType?: string };
+    if (part?.type !== 'text' && part?.type !== 'file') continue;
+
+    if (part.type === 'text' && typeof part.text === 'string') {
+      const rawText = part.text || '';
+
+      // Filter out hidden text
+      if (rawText.includes('::: hide')) continue;
+
+      // Check for audio/video markdown patterns and surface as native
+      // audio/video parts (matches the ChatHistoryContent type contract).
+      const audioMatch = rawText.match(/::: audio\s*!\[(.*?)\]\((.*?)\)\s*:::/);
+      const videoMatch = rawText.match(/::: video\s*!\[(.*?)\]\((.*?)\)\s*:::/);
+
+      if (audioMatch) {
+        content.push({ type: 'audio', data: audioMatch[2], mediaType: audioMatch[1] });
+      } else if (videoMatch) {
+        content.push({ type: 'video', video: videoMatch[2], mediaType: videoMatch[1] });
+      } else {
+        // Cleanup text: de-escape \\\\\\n and strip navigate blocks
+        let text = rawText.replace(/\\\\\\n/g, '\n');
+        text = removeNavigateBlock(text);
+        content.push({ type: 'text', text });
+      }
+    } else if (part.type === 'file') {
+      const mediaType = part.mimeType || '';
+
+      if (mediaType.startsWith('image/')) {
+        content.push({ type: 'image', image: part.data, mediaType });
+      } else if (mediaType.startsWith('video/')) {
+        content.push({ type: 'video', video: part.data, mediaType });
+      } else if (mediaType.startsWith('audio/')) {
+        content.push({ type: 'audio', data: part.data, mediaType });
+      } else {
+        content.push({ type: 'file', data: part.data, mediaType });
+      }
+    }
+  }
+
+  return content;
+}

package/node_modules/@lua/shared-types/src/index.ts

@@ -4,6 +4,7 @@ export * from './unstructured-types';
 export * from './ai-generate.types';
 export * from './ai-generate.utils';
 export * from './agent-invocation.types';
+export * from './chat-history.types';
 export * from './sandbox-contract';
 export * from './device.types';
 export * from './client-tools.types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.15.0",
+  "version": "3.15.2",
   "description": "Build, test, and deploy AI agents with custom tools, webhooks, and scheduled jobs. Features LuaAgent unified configuration, streaming chat, and batch deployment.",
   "readmeFilename": "README.md",
   "main": "dist/api-exports.js",

package/template/package.json

@@ -20,7 +20,7 @@
     "inquirer": "^12.9.6",
     "stripe": "^17.5.0",
     "js-yaml": "^4.1.0",
-    "lua-cli": "^3.15.0",
+    "lua-cli": "^3.15.2",
     "openai": "^5.23.0",
     "uuid": "^13.0.0",
     "zod": "^3.24.1"