lua-cli 3.42.0 → 3.44.0

package/dist/api-exports.d.ts

@@ -809,9 +809,14 @@ export declare interface AgentsApi {
                 size?: number;
             }[];
         }>;
+        /**
+         * The file's text. A file that is not valid UTF-8 (an image, an archive) comes back base64 with
+         * `encoding: 'base64'` — never decoded as text. Absent `encoding` ⇒ `content` is the UTF-8 text.
+         */
         get(path: string): Promise<{
             path: string;
             content: string;
+            encoding?: 'base64';
         }>;
     };
     /** Environment variable NAMES only — values are never returned (`supervision:observe`). */
@@ -1251,6 +1256,27 @@ export declare interface AiApi {
      * ```
      */
     generate(options: AiGenerateInput): Promise<AiGenerateOutput>;
+    /**
+     * Generate ONE image from a prompt and return its hosted CDN url. The image sibling of `generate`:
+     * proxied to the API (server-side provider + CDN upload + org billing), not the agent chat pipeline.
+     * Returns a public `https://cdn.heylua.ai/…` url ready to embed (e.g. in a deck or a message).
+     *
+     * @example
+     * ```typescript
+     * const url = await AI.image('A sunrise over a calm sea, minimal, no text');
+     * const wide = await AI.image('A clean product hero shot', { size: '1536x1024', quality: 'high' });
+     * ```
+     */
+    image(prompt: string, options?: Omit<AiImageInput, 'prompt'>): Promise<string>;
+    /**
+     * Generate one image with full options. Returns the full `{ url, model, provider }`.
+     *
+     * @example
+     * ```typescript
+     * const { url, model } = await AI.image({ prompt: 'A minimal abstract cover', size: '1536x1024' });
+     * ```
+     */
+    image(options: AiImageInput): Promise<AiImageOutput>;
 }
 
 /**
@@ -1392,6 +1418,34 @@ export declare interface AiGenerateToolResult {
     isError?: boolean;
 }
 
+/**
+ * Wire-format types for sandbox `AI.image` / `POST developer/ai/:agentId/image` (JSON-serializable).
+ * The image sibling of `AI.generate`: generates ONE image from a prompt, hosts it on the CDN, bills the
+ * agent's org, and returns the public URL. Not the agent chat pipeline. DTOs live in `@lua/shared-dto`.
+ */
+declare interface AiImageInput {
+    /** Plain-language description of the image to draw (3–4000 chars). */
+    prompt: string;
+    /** Provider-prefixed image model, e.g. "openai/gpt-image-2". Defaults to the agent/platform image model. */
+    model?: string;
+    /** Image size, e.g. "1024x1024", "1536x1024", "1024x1536" (provider-dependent). */
+    size?: string;
+    /** Render quality. */
+    quality?: 'low' | 'medium' | 'high';
+    /** Output image format. */
+    outputFormat?: 'png' | 'jpeg' | 'webp';
+}
+
+/** Result from the image-generation surface. `url` is a public, hosted CDN link. */
+declare interface AiImageOutput {
+    /** Public CDN URL of the generated image. */
+    url: string;
+    /** The model that produced the image. */
+    model: string;
+    /** The provider that produced the image. */
+    provider: string;
+}
+
 export declare const and: (...args: LuaPredicate[]) => LuaPredicate;
 
 /**
@@ -3657,6 +3711,12 @@ declare abstract class HttpClient {
      * @private
      */
     private request;
+    /**
+     * A backoff wait the caller's signal can cut short (BAC-1097): resolves at `ms` or on abort, whichever is
+     * first, and never leaves the timer or the listener behind. The caller re-checks `signal.aborted` afterwards.
+     * @private
+     */
+    private sleep;
     /**
      * Non-2xx classification shared by `request` and `httpStream` (WF-204): 401s become
      * `AuthenticationError` (ownership vs credential), 403s throw, everything else returns the
@@ -5799,14 +5859,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }, {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -5865,14 +5925,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }, {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -5931,14 +5991,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }, {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -6123,9 +6183,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6139,9 +6199,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6154,9 +6214,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6217,9 +6277,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6233,9 +6293,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6248,9 +6308,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6311,9 +6371,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6327,9 +6387,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6342,9 +6402,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6405,9 +6465,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6421,9 +6481,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6436,9 +6496,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6985,7 +7045,10 @@ export declare interface LuaWorkflowConfig {
      * marketplace template freezes from this schedule: `'installer'` (the default when absent — every install's
      * fires run as the person who installed, who gets the run card in their inbox) or `'system'` (the frozen copy
      * runs user-less and unwatched — no inbox card for its runs; the install response says so). On this agent the
-     * schedule runs as you either way.
+     * schedule runs as you, unless the platform has enabled author system schedules: then `'system'` makes this
+     * agent's own schedule run as the agent (`system:<agentId>`), like a template copy's, with you recorded as the
+     * deployer who scheduled it (the schedule stops if you lose access to the agent). A manual run ("Run now")
+     * always runs as the person who starts it.
      */
     schedule?: JobSchedule & {
         runAs?: 'installer' | 'system';
@@ -7208,6 +7271,13 @@ export declare type MCPTransport = 'sse' | 'streamable-http';
 
 declare type Message = TextMessage_2 | ImageMessage_2 | FileMessage_2;
 
+/**
+ * The text of a postprocessor's `message`, whichever shape it arrived in: a string as is,
+ * parts as their `text` parts joined with a newline (image and file parts are skipped).
+ * Anything else yields `''`.
+ */
+export declare function messageText(message: PostProcessorMessage | null | undefined): string;
+
 export declare const Metrics: MetricsApi;
 
 /**
@@ -7564,7 +7634,7 @@ declare class PostProcessor {
     getName(): string;
     getDescription(): string;
     getPriority(): number;
-    execute(user: UserDataInstance, message: string, response: string, channel: string): Promise<PostProcessorResponse>;
+    execute(user: UserDataInstance, message: PostProcessorMessage, response: string, channel: string): Promise<PostProcessorResponse>;
 }
 export { PostProcessor as LuaPostprocessor }
 export { PostProcessor }
@@ -7585,10 +7655,18 @@ export declare interface PostProcessorConfig {
     /**
      * Function that processes the agent's response before sending to user.
      * MUST return { modifiedResponse: string } - the formatted response text.
+     * `message` is the user's message: a string or its parts — read it with `messageText(message)`.
      */
-    execute: (user: UserDataInstance, message: string, response: string, channel: string) => Promise<PostProcessorResponse>;
+    execute: (user: UserDataInstance, message: PostProcessorMessage, response: string, channel: string) => Promise<PostProcessorResponse>;
 }
 
+/**
+ * The user's message as a postprocessor receives it (LUA-1075).
+ * lua-core passes the turn's user content unchanged: a plain string, or the message parts
+ * (`[{ type: 'text', text }, { type: 'image', ... }]`). Use {@link messageText} for its text.
+ */
+export declare type PostProcessorMessage = string | ChatMessage[];
+
 /**
  * PostProcessor override for sandbox testing.
  * Maps production postprocessor ID to sandbox version ID.
@@ -8252,13 +8330,19 @@ declare type RequestCredentialDescriptor = {
 declare type RequestCredentialInput = string | RequestCredential;
 
 /**
- * Optional per-request overrides (WF-202, 03 §3.7 client-deadline rule). Today only
- * `timeoutMs`: `WorkflowApi.startRun` long-polls with `waitSeconds ≤ 55` and raises
- * its deadline to `(waitSeconds + 10) s` so the 30 s default abort never races the
- * server. Every other call site is untouched (undefined ⇒ the 30 s default).
+ * Optional per-request overrides (WF-202, 03 §3.7 client-deadline rule).
+ * - `timeoutMs`: `WorkflowApi.startRun` long-polls with `waitSeconds ≤ 55` and raises
+ *   its deadline to `(waitSeconds + 10) s` so the 30 s default abort never races the
+ *   server. Every other call site is untouched (undefined ⇒ the 30 s default).
+ * - `signal` (BAC-1097): a caller's AbortSignal. It is linked to the request's own
+ *   AbortController (which still owns the `timeoutMs` deadline — one controller, no
+ *   double-cancel), so aborting closes the in-flight fetch, stops any retry / Core-drain
+ *   backoff, and answers the `REQUEST_ABORTED` envelope. `AgentsApiService.invoke` passes
+ *   `AgentInvocationInput.signal` here; the signal is never serialized.
  */
 declare interface RequestOverrides {
     timeoutMs?: number;
+    signal?: AbortSignal;
 }
 
 /**
@@ -8969,6 +9053,14 @@ declare interface SupervisionLogRow {
     logSource?: string;
     primitiveName?: string;
     toolName?: string;
+    /**
+     * LUA-1076 — the agent version that served the row (string form of the version number / id), when the writer
+     * stamped it. Lets a supervisor tell a staged version's errors from the live version's. Filter with
+     * `{ agentVersion }` on the `logs` op.
+     */
+    agentVersion?: string;
+    /** 'production' for the promoted (live) version; 'sandbox' for previews, practice and dev. Filter with `{ environment }`. */
+    environment?: string;
     /**
      * A non-identifying conversation key: the same value for every row of one conversation (thread) on this target,
      * never the thread id itself (which embeds the end user's id), and different on another target. Present on rows

package/dist/api-exports.js

@@ -11694,6 +11694,19 @@ var init_request_credential = __esm({
 
 // src/api/http.client.ts
 import { randomUUID as randomUUID2 } from "crypto";
+function abortedResponse() {
+  return {
+    success: false,
+    error: {
+      message: "Request aborted",
+      code: REQUEST_ABORTED_CODE,
+      statusCode: 0
+    }
+  };
+}
+function isAborted(signal) {
+  return !!signal && signal.aborted === true;
+}
 async function classifyErrorResponse(response) {
   let errorData;
   try {
@@ -11826,7 +11839,7 @@ function coreDrainApiRetryDelayMs(error) {
   const delayMs = retryAfterSeconds * 1e3;
   return Math.min(Math.max(0, delayMs), CORE_DRAINING_MAX_RETRY_MS);
 }
-var DEFAULT_REQUEST_TIMEOUT_MS, HttpClient;
+var DEFAULT_REQUEST_TIMEOUT_MS, REQUEST_ABORTED_CODE, HttpClient;
 var init_http_client = __esm({
   "src/api/http.client.ts"() {
     "use strict";
@@ -11837,6 +11850,9 @@ var init_http_client = __esm({
     init_lua_fetch();
     init_request_credential();
     DEFAULT_REQUEST_TIMEOUT_MS = 3e4;
+    REQUEST_ABORTED_CODE = "REQUEST_ABORTED";
+    __name(abortedResponse, "abortedResponse");
+    __name(isAborted, "isAborted");
     HttpClient = class {
       static {
         __name(this, "HttpClient");
@@ -11859,9 +11875,17 @@ var init_http_client = __esm({
       * @private
       */
       async request(url, options = {}, overrides) {
+        const callerSignal = overrides?.signal;
+        if (isAborted(callerSignal)) return abortedResponse();
         const controller = new AbortController();
         const timeoutMs = overrides?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
         const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        const onCallerAbort = /* @__PURE__ */ __name(() => controller.abort(), "onCallerAbort");
+        if (typeof callerSignal?.addEventListener === "function") {
+          callerSignal.addEventListener("abort", onCallerAbort, {
+            once: true
+          });
+        }
         try {
           const authorization = this.requestCredential ? `Bearer ${await bearerFor(this.requestCredential)}` : void 0;
           const response = await luaFetch(url, {
@@ -11883,6 +11907,7 @@ var init_http_client = __esm({
           try {
             data = await response.json();
           } catch (jsonError) {
+            if (isAborted(callerSignal)) throw jsonError;
             data = {};
           }
           if (typeof data === "object" && data !== null && "success" in data) {
@@ -11900,6 +11925,9 @@ var init_http_client = __esm({
           if (isAccessDeniedError(error)) {
             throw error;
           }
+          if (isAborted(callerSignal)) {
+            return abortedResponse();
+          }
           if (error instanceof DOMException && error.name === "AbortError") {
             return {
               success: false,
@@ -11916,9 +11944,36 @@ var init_http_client = __esm({
               statusCode: 0
             }
           };
+        } finally {
+          clearTimeout(timeoutId);
+          if (typeof callerSignal?.removeEventListener === "function") {
+            callerSignal.removeEventListener("abort", onCallerAbort);
+          }
         }
       }
       /**
+      * A backoff wait the caller's signal can cut short (BAC-1097): resolves at `ms` or on abort, whichever is
+      * first, and never leaves the timer or the listener behind. The caller re-checks `signal.aborted` afterwards.
+      * @private
+      */
+      sleep(ms, signal) {
+        if (isAborted(signal)) return Promise.resolve();
+        const listenable = typeof signal?.addEventListener === "function";
+        return new Promise((resolve3) => {
+          const onAbort = /* @__PURE__ */ __name(() => {
+            clearTimeout(timer);
+            resolve3();
+          }, "onAbort");
+          const timer = setTimeout(() => {
+            if (listenable) signal.removeEventListener("abort", onAbort);
+            resolve3();
+          }, ms);
+          if (listenable) signal.addEventListener("abort", onAbort, {
+            once: true
+          });
+        });
+      }
+      /**
       * Non-2xx classification shared by `request` and `httpStream` (WF-204): 401s become
       * `AuthenticationError` (ownership vs credential), 403s throw, everything else returns the
       * `{ success:false, error }` envelope with the server body spread in.
@@ -11986,19 +12041,22 @@ var init_http_client = __esm({
           }
         }
         let lastResult = null;
+        const signal = overrides?.signal;
         for (let attempt = 0; attempt <= maxRetries; attempt++) {
+          if (isAborted(signal)) return abortedResponse();
           try {
             const result = await this.request(url, options, overrides);
             if (result.success || !result.error || !this.isRetryableStatus(result.error.statusCode || 0)) {
               return result;
             }
+            if (isAborted(signal)) return result;
             lastResult = result;
           } catch (error) {
             throw error;
           }
           if (attempt < maxRetries) {
             const backoff = this.retryDelayMs(attempt, lastResult?.error, options.method);
-            await new Promise((resolve3) => setTimeout(resolve3, backoff));
+            await this.sleep(backoff, signal);
           }
         }
         return lastResult;
@@ -12047,7 +12105,8 @@ var init_http_client = __esm({
       async httpPostCoreDrainRetry(url, data, headers, overrides) {
         const first = await this.httpPostOnce(url, data, headers, overrides);
         if (!isCoreDrainApiError(first.error)) return first;
-        await new Promise((resolve3) => setTimeout(resolve3, coreDrainApiRetryDelayMs(first.error)));
+        await this.sleep(coreDrainApiRetryDelayMs(first.error), overrides?.signal);
+        if (isAborted(overrides?.signal)) return abortedResponse();
         return this.httpPostOnce(url, data, headers, overrides);
       }
       /**
@@ -20897,10 +20956,15 @@ var init_basket_api_service = __esm({
 });
 
 // src/instances/user.instance.ts
+function omit(source, key) {
+  const { [key]: _dropped, ...rest } = source;
+  return rest;
+}
 var UserDataInstance;
 var init_user_instance = __esm({
   "src/instances/user.instance.ts"() {
     "use strict";
+    __name(omit, "omit");
     UserDataInstance = class {
       static {
         __name(this, "UserDataInstance");
@@ -20916,7 +20980,12 @@ var init_user_instance = __esm({
       * @returns Proxied instance that allows direct access to data properties
       */
       constructor(api, data, profile) {
-        this.data = data && typeof data === "object" ? data : {};
+        Object.defineProperty(this, "data", {
+          value: data && typeof data === "object" ? data : {},
+          writable: true,
+          enumerable: false,
+          configurable: true
+        });
         Object.defineProperty(this, "userAPI", {
           value: api,
           writable: true,
@@ -21028,7 +21097,8 @@ var init_user_instance = __esm({
       */
       async update(data) {
         try {
-          const response = await this.userAPI.update(data);
+          const payload = data && data.data === this.data ? omit(data, "data") : data;
+          const response = await this.userAPI.update(payload);
           this.data = response;
           return this.data;
         } catch (error) {
@@ -22279,6 +22349,29 @@ var init_ai_api_service = __esm({
         }
         return result.data;
       }
+      async image(body) {
+        return this.httpPost(`/developer/ai/${this.agentId}/image`, body, {});
+      }
+      /**
+      * Handles the simplified-vs-full-options branching for `AI.image`.
+      * Simplified (`AI.image(prompt, options?)`) returns the hosted CDN url string; the options overload
+      * (`AI.image({ prompt, ... })`) returns the full `{ url, model, provider }`.
+      */
+      async imageForSandbox(promptOrOptions, options) {
+        const simplified = typeof promptOrOptions === "string";
+        const body = simplified ? {
+          prompt: promptOrOptions,
+          ...options
+        } : promptOrOptions;
+        const result = await this.image(body);
+        if (!result.success) {
+          throw new Error(result.error?.message || "AI image generation failed");
+        }
+        if (!result.data) {
+          throw new Error("AI image generation failed: empty response");
+        }
+        return simplified ? result.data.url : result.data;
+      }
     };
   }
 });
@@ -22389,6 +22482,12 @@ var init_integrations_api_service = __esm({
 });
 
 // src/api/agents.api.service.ts
+function isAborted2(signal) {
+  return !!signal && signal.aborted === true;
+}
+function abortReason(signal) {
+  return signal.reason ?? new DOMException("The operation was aborted", "AbortError");
+}
 function toInvocationOutput(data, callerThreadId) {
   const toolNames = /* @__PURE__ */ new Set();
   for (const step3 of Array.isArray(data.steps) ? data.steps : []) {
@@ -22474,9 +22573,15 @@ var init_agents_api_service = __esm({
         });
         if (body.identifier) query.set("identifier", body.identifier);
         const chatBody = this.toChatGenerateBody(body);
-        return this.httpPostCoreDrainRetry(`/chat/generate/${targetAgentId}?${query.toString()}`, chatBody, {}, typeof body.timeoutMs === "number" ? {
-          timeoutMs: body.timeoutMs
-        } : void 0);
+        const overrides = {
+          ...typeof body.timeoutMs === "number" ? {
+            timeoutMs: body.timeoutMs
+          } : {},
+          ...body.signal ? {
+            signal: body.signal
+          } : {}
+        };
+        return this.httpPostCoreDrainRetry(`/chat/generate/${targetAgentId}?${query.toString()}`, chatBody, {}, Object.keys(overrides).length > 0 ? overrides : void 0);
       }
       /**
       * Sandbox overload: mirrors the `AI.generate` pattern where the simplified
@@ -22487,8 +22592,10 @@ var init_agents_api_service = __esm({
         const input = typeof promptOrInput === "string" ? {
           prompt: promptOrInput
         } : promptOrInput;
+        if (isAborted2(input.signal)) throw abortReason(input.signal);
         const result = await this.invoke(targetAgentId, input);
         if (!result.success) {
+          if (isAborted2(input.signal)) throw abortReason(input.signal);
           throw new Error(result.error?.message || "Agent invocation failed");
         }
         if (!result.data) {
@@ -22734,6 +22841,8 @@ var init_agents_api_service = __esm({
         };
       }
     };
+    __name(isAborted2, "isAborted");
+    __name(abortReason, "abortReason");
     __name(toInvocationOutput, "toInvocationOutput");
     __name(runSummary, "runSummary");
     __name(supervisedCheck, "supervisedCheck");
@@ -25189,6 +25298,12 @@ var PreProcessor = class {
     return this.executeFunction(user, messages, channel);
   }
 };
+function messageText2(message) {
+  if (typeof message === "string") return message;
+  if (!Array.isArray(message)) return "";
+  return message.filter((p) => !!p && p.type === "text" && typeof p.text === "string").map((p) => p.text).join("\n");
+}
+__name(messageText2, "messageText");
 var PostProcessor = class {
   static {
     __name(this, "PostProcessor");
@@ -26291,6 +26406,11 @@ var AI = {
     const { getAiInstance: getAiInstance2 } = await Promise.resolve().then(() => (init_lazy_instances(), lazy_instances_exports));
     const ai = await getAiInstance2();
     return ai.generateForSandbox(promptOrOptions, content);
+  },
+  async image(promptOrOptions, options) {
+    const { getAiInstance: getAiInstance2 } = await Promise.resolve().then(() => (init_lazy_instances(), lazy_instances_exports));
+    const ai = await getAiInstance2();
+    return ai.imageForSandbox(promptOrOptions, options);
   }
 };
 var Integrations = {
@@ -26634,6 +26754,7 @@ export {
   log,
   lt2 as lt,
   lte2 as lte,
+  messageText2 as messageText,
   ne2 as ne,
   not2 as not,
   notExists2 as notExists,