lua-cli 3.55.0 → 3.56.0

package/dist/api-exports.d.ts

@@ -3114,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. */
@@ -6958,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>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
-    }, {
         class: "LLM" | "STT" | "STTv2" | "TTS";
+    }, {
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -7024,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>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
-    }, {
         class: "LLM" | "STT" | "STTv2" | "TTS";
+    }, {
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -7090,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>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
-    }, {
         class: "LLM" | "STT" | "STTv2" | "TTS";
+    }, {
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -7280,10 +7297,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7297,10 +7314,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7313,10 +7330,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7374,10 +7391,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7391,10 +7408,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7407,10 +7424,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7468,10 +7485,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7485,10 +7502,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7501,10 +7518,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7562,10 +7579,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7579,10 +7596,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -7595,10 +7612,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
     } | {
-        class: "LLM" | "STT" | "STTv2" | "TTS";
         options: Record<string, unknown>;
         kind: "plugin";
         provider: "deepgram" | "elevenlabs";
+        class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
         options: Record<string, unknown>;
         kind: "realtime";
@@ -8926,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;
 };
 
 /**
@@ -10509,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];
 
@@ -10602,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).
@@ -10682,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>;
 }
 
 /**

package/dist/api-exports.js

@@ -30213,7 +30213,11 @@ function createOfflineThreadsApi() {
     }, "open"),
     followUp: /* @__PURE__ */ __name(async () => {
       throw unavailable("followUp");
-    }, "followUp")
+    }, "followUp"),
+    resetContext: /* @__PURE__ */ __name(async () => ({
+      status: "skipped",
+      reason: "unavailable"
+    }), "resetContext")
   };
 }
 __name(createOfflineThreadsApi, "createOfflineThreadsApi");