lua-cli 3.54.0 → 3.56.0

package/dist/api-exports.d.ts

@@ -2885,15 +2885,6 @@ export declare interface ChannelSendTarget {
     identity?: UserIdentityRef;
 }
 
-/**
- * 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.
  *
@@ -2964,6 +2955,8 @@ export declare interface ChatHistoryMessage {
     servedModel?: string;
     /** True when the turn reached that model through the Auto selector. */
     autoModelRequested?: boolean;
+    /** On an assistant message: the id the reply streamed under, which its usage and ledger rows carry. */
+    turnId?: string;
     author?: {
         userId: string;
     };
@@ -2973,6 +2966,8 @@ export declare interface ChatHistoryMessage {
     };
     /** On a user message: the id the client gave the turn when it sent it, so it can tell which of its sends arrived. */
     clientTurnId?: string;
+    /** Set on every message of a turn that has more than one version. */
+    replyVersion?: ReplyVersionInfo;
     /**
      * Permanent recording for a voice-note turn (Lua Desktop). Populated by the
      * admin threads history endpoint from the row's `content.metadata.audio` — a
@@ -3119,6 +3114,23 @@ export declare interface ConnectionRequestStatus {
  */
 export declare type ContainerArm = StepRef | [LuaMapConfig, StepRef];
 
+/** Why a `Threads.resetContext()` call changed nothing. Never an error: a reset is advisory. */
+export declare type ContextResetSkipReason = 
+/** The agent's `contextReset` feature is off, or the platform kill switch is on. */
+'disabled'
+/** Not called from a tool or processor of a 1:1 chat turn (a job, webhook, trigger, room or workflow step). */
+| 'not_chat_turn'
+/** The turn's thread is not the calling user's own thread with this agent. */
+| 'not_own_thread'
+/** The agent is not on thread-scoped observational memory. */
+| 'memory_off'
+/** Nothing older than the current turn is left to drop (first turn, or already reset this turn). */
+| 'nothing_to_reset'
+/** The thread's memory was being updated and the reset could not take its lock in time; the next one will. */
+| 'busy'
+/** No platform runtime (`lua test`, `lua dev`, an unwired runtime). */
+| 'unavailable';
+
 /** Teams: resource-specific permissions are granted per chat by whoever adds the app; file access is a tenant-wide grant. */
 declare interface ConversationAccess {
     /** False when only messages that mention the agent are delivered. */
@@ -3288,6 +3300,8 @@ declare interface CustomDataAPI {
         set?: Record<string, any>;
         unset?: string[];
         searchText?: string | null;
+        /** Refreshes the index declarations (same semantics as create's option). */
+        index?: Array<string | string[]>;
     }, options?: {
         ifVersion?: number;
     }): Promise<UpdateCustomDataResponse>;
@@ -3485,7 +3499,7 @@ export declare const Data: {
      *
      * @param collectionName - Name of the collection
      * @param entryId - ID of the entry
-     * @param mutation - `{ set?, unset?, searchText? }` (`searchText: null` clears it)
+     * @param mutation - `{ set?, unset?, searchText?, index? }` (`searchText: null` clears it; `index` as create's option)
      * @param options - `{ ifVersion? }` for compare-and-swap
      * @returns Promise resolving to `{ status, message, version }` (`version` = the entry's new version)
      */
@@ -3493,6 +3507,8 @@ export declare const Data: {
         set?: Record<string, any>;
         unset?: string[];
         searchText?: string | null;
+        /** Refreshes the index declarations (same semantics as create's `index` option). */
+        index?: Array<string | string[]>;
     }, options?: PatchCustomDataOptions): Promise<UpdateCustomDataResponse>;
     /**
      * Atomically adds `by` (default 1; negative and fractional amounts allowed)
@@ -3557,7 +3573,9 @@ export declare const Data: {
      * - Readers may `collections`, `get`, `getEntry`, `search`; writers may also `create`, `update`, `patch`,
      *   `increment`, `delete` (a writer can read). Anything else rejects with `code === 'shared_data_forbidden'`
      *   (403) — also when the name does not exist or belongs to another org.
-     * - Same limits, filters, managed indexes, compare-and-swap and vector search as `Data`. Every write is audited
+     * - Same limits, filters, managed indexes, compare-and-swap and vector search as `Data`. A writer declares indexes
+     *   (`{ index }` on create/update/patch); they belong to the shared collection (5 across its sub-collections) and
+     *   `collections()` reports their status to every reader. Every write is audited
      *   (agent, collection, entry id; never the value).
      * - A test session may read but not write (`shared_data_test_session_write_refused`, 409).
      * - Deployed agents only: under `lua test` every call rejects with `code === 'shared_data_unavailable_offline'`.
@@ -3601,11 +3619,11 @@ export declare class DataEntryInstance {
     /**
      * Updates the custom data entry
      * @param data - The data fields to update (partial update supported)
-     * @param searchText - Optional new search text for semantic search indexing
+     * @param optionsOrSearchText - `{ searchText?, index? }` (as `Data.update`), or a bare string (legacy `searchText`)
      * @returns Promise resolving to the updated data
      * @throws Error if the update fails
      */
-    update(data: Record<string, any>, searchText?: string): Promise<Record<string, any>>;
+    update(data: Record<string, any>, optionsOrSearchText?: string | CreateCustomDataOptions): Promise<Record<string, any>>;
     /**
      * Atomically sets/unsets fields. `options.ifVersion` makes it a
      * compare-and-swap (pass `entry._version`); a stale version rejects with
@@ -3616,6 +3634,8 @@ export declare class DataEntryInstance {
         set?: Record<string, any>;
         unset?: string[];
         searchText?: string | null;
+        /** Refreshes the index declarations (same semantics as create's option). */
+        index?: Array<string | string[]>;
     }, options?: {
         ifVersion?: number;
     }): Promise<Record<string, any>>;
@@ -3628,11 +3648,11 @@ export declare class DataEntryInstance {
     delete(): Promise<boolean>;
     /**
      * Saves the data entry
-     * @param searchText - Optional search text for vector search indexing
+     * @param optionsOrSearchText - `{ searchText?, index? }` (as `Data.update`), or a bare string (legacy `searchText`)
      * @returns Promise resolving to true if saving was successful
      * @throws Error if the save operation fails
      */
-    save(searchText?: string): Promise<boolean>;
+    save(optionsOrSearchText?: string | CreateCustomDataOptions): Promise<boolean>;
 }
 
 export { DatasetRef }
@@ -4979,6 +4999,17 @@ export declare interface IntegrationPassthroughRequest {
      * server-side and cannot be overridden.
      */
     headers?: Record<string, string>;
+    /**
+     * BAC-2677 — ask for the provider body as bytes. With `'base64'`, a 2xx
+     * response body is read as raw bytes and returned base64-encoded in `data`
+     * (and `encoding: 'base64'` is set on the response), so binary files such as
+     * a Drive PDF (`drive/v3/files/<id>?alt=media`) survive intact. Bodies over
+     * {@link INTEGRATION_PASSTHROUGH_MAX_BASE64_RESPONSE_BYTES} are refused with
+     * {@link INTEGRATION_PASSTHROUGH_RESPONSE_TOO_LARGE_CODE}, never truncated.
+     * Provider error statuses keep the normal JSON/text body. Omit for the
+     * default JSON/text handling.
+     */
+    responseType?: 'base64';
 }
 
 /**
@@ -4994,8 +5025,16 @@ export declare interface IntegrationPassthroughResponse {
     /**
      * Provider response body: parsed JSON when the response is JSON, the raw
      * string otherwise (e.g. a `text/plain` unified diff round-trips intact).
+     * A base64 string when `encoding` is `'base64'`.
      */
     data: unknown;
+    /**
+     * BAC-2677 — `'base64'` when `data` is the provider body base64-encoded
+     * (the request asked for `responseType: 'base64'` and the provider answered
+     * 2xx). Absent means `data` took the normal JSON/text path, so a caller that
+     * asked for bytes can tell when it did not get them.
+     */
+    encoding?: 'base64';
 }
 
 export declare const Integrations: IntegrationsApi;
@@ -6649,10 +6688,7 @@ export declare interface LuaTool<TInput extends ZodType = ZodType> {
      * while the tool runs. Each text is a string literal (or a const holding one)
      * of at most 80 characters; `lua compile` ignores a computed label.
      */
-    label?: string | {
-        running: string;
-        done: string;
-    };
+    label?: ToolLabel;
     /** Zod schema for input validation */
     inputSchema: TInput;
     /**
@@ -6918,15 +6954,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     }, {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"plugin">;
         provider: z.ZodEnum<["deepgram", "elevenlabs"]>;
@@ -6939,15 +6975,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
-    }, {
+        provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+    }, {
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -6960,12 +6996,12 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     }, {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     }>]>;
     stt: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -6984,15 +7020,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     }, {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"plugin">;
         provider: z.ZodEnum<["deepgram", "elevenlabs"]>;
@@ -7005,15 +7041,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
-    }, {
+        provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+    }, {
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -7026,12 +7062,12 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     }, {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     }>]>>;
     tts: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -7050,15 +7086,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     }, {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"plugin">;
         provider: z.ZodEnum<["deepgram", "elevenlabs"]>;
@@ -7071,15 +7107,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
-    }, {
+        provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+    }, {
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -7092,12 +7128,12 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     }, {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     }>]>>;
     vad: z.ZodOptional<z.ZodString>;
     vadOptions: z.ZodOptional<z.ZodObject<{
@@ -7256,52 +7292,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     llm: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -7350,52 +7386,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools?: string[] | undefined;
 }, {
     llm: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -7444,52 +7480,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools?: string[] | undefined;
 }>, {
     llm: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -7538,52 +7574,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools?: string[] | undefined;
 }, {
     llm: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        model: string;
         kind: "inference";
-        voice?: string | undefined;
+        model: string;
         options?: Record<string, unknown> | undefined;
+        voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
-        provider: "deepgram" | "elevenlabs";
         kind: "plugin";
+        provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
-        provider: "openai" | "google" | "xai";
         kind: "realtime";
+        provider: "openai" | "google" | "xai";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -7677,6 +7713,7 @@ export declare class LuaVoiceTool<TInput extends ZodType = ZodType> implements L
     readonly inputSchema: TInput;
     readonly execute: (input: any, ctx?: LuaVoiceToolCtx) => Promise<any>;
     readonly condition?: () => Promise<boolean>;
+    readonly label?: ToolLabel;
     readonly voice?: {
         flags?: ToolFlag[];
     };
@@ -7695,6 +7732,8 @@ export declare interface LuaVoiceToolConfig<TInput extends ZodType = ZodType> {
     execute: (input: any, ctx?: LuaVoiceToolCtx) => Promise<any>;
     condition?: () => Promise<boolean>;
     flags?: ToolFlag[];
+    /** What a step shows while the tool runs and when it is done, as on `LuaTool`. */
+    label?: ToolLabel;
 }
 
 /**
@@ -8904,13 +8943,28 @@ export declare interface PreProcessorOverride {
     sandboxId: string;
 }
 
+/** Metadata a proceeding preprocessor may return. */
+export declare type PreProcessorProceedMetadata = Record<string, any> & {
+    /**
+     * A short note for the model on THIS turn only, e.g. state read from your own data. It is
+     * added after the conversation as context labelled system-provided (the user did not write
+     * it), and is never stored, never in chat history and never shown to the user. Notes from
+     * several preprocessors are joined in run order and capped at 2,000 characters in total
+     * (longer text is truncated). Strings only; anything else is ignored.
+     *
+     * The model is told the note is data, not instructions: it may quote text users wrote, so do
+     * not rely on it to steer the agent's behaviour. Put rules in the persona or a skill instead.
+     */
+    turnContext?: string;
+};
+
 export declare type PreProcessorProceedResponse = {
     /** Proceed to next preprocessor or agent */
     action: 'proceed';
     /** Optional modified message (if not provided, uses original/current message) */
     modifiedMessage?: ChatMessage[];
     /** Optional metadata to pass along */
-    metadata?: Record<string, any>;
+    metadata?: PreProcessorProceedMetadata;
 };
 
 /**
@@ -9438,6 +9492,22 @@ export declare interface RefusedAnswer {
 
 export declare type ReplyChannel = 'whatsapp' | 'sms' | 'email' | 'webchat' | 'slack';
 
+/**
+ * Reply versions on a stored conversation. A version is a block: one user row and the
+ * rows after it up to the next user row. A re-run of the latest turn hides the current
+ * block (`metadata.inactiveVersion`) and stamps `metadata.replyVersion` on the user row
+ * of every block of the turn. Readers fold rich parts first, then call
+ * `applyReplyVersions`, so a hidden reply's citations leave with it.
+ */
+declare interface ReplyVersionInfo {
+    group: string;
+    /** 1-based. */
+    index: number;
+    total: number;
+    /** The version the agent reads; the others are hidden from it. */
+    active: boolean;
+}
+
 declare interface RequestCredential {
     readonly descriptor: RequestCredentialDescriptor;
     bearer(): Promise<string>;
@@ -10471,7 +10541,7 @@ export declare const Templates: {
 };
 
 /** Recorded effect kinds (DOC2 §7 seam table; `fetch` is sandbox egress record mode, §9.1). */
-declare const TEST_EFFECT_KINDS: readonly ["channel.send", "whatsapp.template", "whatsapp.reaction", "whatsapp.phone_request", "email.send", "inbox.push", "voice.call", "passthrough", "mcp.tool", "supervision.write", "user.update_name", "browser.action", "jobs.create", "fetch", "refused", "metrics.record", "threads.open", "threads.follow_up", "secrets.request", "connection_request.create", "connection_request.reconnect", "connection_request.cancel", "ai.generate", "decisions.ask"];
+declare const TEST_EFFECT_KINDS: readonly ["channel.send", "whatsapp.template", "whatsapp.reaction", "whatsapp.phone_request", "email.send", "inbox.push", "voice.call", "passthrough", "mcp.tool", "supervision.write", "user.update_name", "browser.action", "jobs.create", "fetch", "refused", "metrics.record", "threads.open", "threads.follow_up", "threads.reset_context", "secrets.request", "connection_request.create", "connection_request.reconnect", "connection_request.cancel", "ai.generate", "decisions.ask"];
 
 declare type TestEffectKind = (typeof TEST_EFFECT_KINDS)[number];
 
@@ -10564,6 +10634,13 @@ declare type TextMessage_2 = {
     text: string;
 };
 
+export declare type ThreadContextResetReceipt = {
+    status: 'reset';
+} | {
+    status: 'skipped';
+    reason: ContextResetSkipReason;
+};
+
 /**
  * `Threads.followUp(threadId, input)`: exactly one of `prompt` (a BACKGROUND agent turn on the thread,
  * like the workflow callback loopback) or `message` (post the text as the agent, no model turn).
@@ -10644,6 +10721,17 @@ export declare interface ThreadsApi {
      * fails mid-delivery. Without a key every call delivers.
      */
     followUp(threadId: string, input: ThreadFollowUpInput): Promise<ThreadFollowUpReceipt>;
+    /**
+     * Start the agent's context afresh from the current turn (LUA-1538). Call it from a tool at a natural break — a
+     * checklist section recorded, a task started. From the NEXT turn on, the agent reads this turn and what follows,
+     * not the earlier messages or the observation log built from them. The person still sees the whole conversation;
+     * nothing is deleted. Give the agent what it still needs (where the person is in a task) from your own data, for
+     * example in a preprocessor.
+     *
+     * Never throws. Answers `{ status: 'reset' }`, or `{ status: 'skipped', reason }` when the agent's `contextReset`
+     * feature is off, outside a 1:1 chat turn, with observational memory off, when nothing older is left, or offline.
+     */
+    resetContext(): Promise<ThreadContextResetReceipt>;
 }
 
 /**
@@ -10713,6 +10801,12 @@ export declare enum ToolFlag {
     DISALLOW_INTERRUPTION = "disallow_interruption"
 }
 
+/** A tool's `label`: one text for both moments, or one while it runs and one when it is done. `{arg}` fills from the call. */
+declare type ToolLabel = string | {
+    running: string;
+    done: string;
+};
+
 export declare interface ToolStepOptions {
     input?: LuaMapConfig;
     timeoutSeconds?: number;