@ai-setting/roy-agent-core 1.5.92 → 1.5.94

package/dist/env/agent/index.js

@@ -2,13 +2,13 @@ import {
   AgentComponent,
   AgentComponentConfigSchema,
   SummaryAgent
-} from "../../shared/@ai-setting/roy-agent-core-mw9a595w.js";
+} from "../../shared/@ai-setting/roy-agent-core-6rx2yt78.js";
 import"../../shared/@ai-setting/roy-agent-core-j7jeqxhd.js";
-import"../../shared/@ai-setting/roy-agent-core-ptb4pkva.js";
+import"../../shared/@ai-setting/roy-agent-core-jhdv14ks.js";
 import"../../shared/@ai-setting/roy-agent-core-5h49ct1a.js";
 import"../../shared/@ai-setting/roy-agent-core-bdajt9cs.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-vady4w02.js";
+import"../../shared/@ai-setting/roy-agent-core-hfgqwf5w.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../../shared/@ai-setting/roy-agent-core-yfhgxh5a.js";

package/dist/env/event-source/index.js

@@ -8,7 +8,7 @@ import {
   getBuiltInHandler,
   larkCliHandler,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-5j649pb1.js";
+} from "../../shared/@ai-setting/roy-agent-core-8f37pvct.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -19,8 +19,8 @@ import {
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-ds5f75pg.js";
 import"../../shared/@ai-setting/roy-agent-core-wmkx79b1.js";
-import"../../shared/@ai-setting/roy-agent-core-svcr4gjw.js";
-import"../../shared/@ai-setting/roy-agent-core-97tjdb2r.js";
+import"../../shared/@ai-setting/roy-agent-core-mx9vq7b2.js";
+import"../../shared/@ai-setting/roy-agent-core-dj18eyyk.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-8wd3qwx5.js";
 import"../../shared/@ai-setting/roy-agent-core-4yq23m5g.js";

package/dist/env/index.js

@@ -5,7 +5,7 @@ import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-5j649pb1.js";
+} from "../shared/@ai-setting/roy-agent-core-8f37pvct.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -17,16 +17,16 @@ import"../shared/@ai-setting/roy-agent-core-wmkx79b1.js";
 import {
   PluginComponent
 } from "../shared/@ai-setting/roy-agent-core-ws76avbn.js";
-import"../shared/@ai-setting/roy-agent-core-svcr4gjw.js";
-import"../shared/@ai-setting/roy-agent-core-97tjdb2r.js";
+import"../shared/@ai-setting/roy-agent-core-mx9vq7b2.js";
+import"../shared/@ai-setting/roy-agent-core-dj18eyyk.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-vh8ncnzm.js";
+} from "../shared/@ai-setting/roy-agent-core-ac0bc4x0.js";
 import"../shared/@ai-setting/roy-agent-core-xgnpr28w.js";
-import"../shared/@ai-setting/roy-agent-core-snvsn60t.js";
-import"../shared/@ai-setting/roy-agent-core-w1s8yrm5.js";
+import"../shared/@ai-setting/roy-agent-core-b4sbnec8.js";
 import"../shared/@ai-setting/roy-agent-core-6atd905e.js";
+import"../shared/@ai-setting/roy-agent-core-phq62515.js";
 import"../shared/@ai-setting/roy-agent-core-q88vxmx5.js";
 import"../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"../shared/@ai-setting/roy-agent-core-hhrg314p.js";
@@ -42,20 +42,20 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-mw9a595w.js";
+} from "../shared/@ai-setting/roy-agent-core-6rx2yt78.js";
 import"../shared/@ai-setting/roy-agent-core-j7jeqxhd.js";
-import"../shared/@ai-setting/roy-agent-core-ptb4pkva.js";
+import"../shared/@ai-setting/roy-agent-core-jhdv14ks.js";
 import"../shared/@ai-setting/roy-agent-core-5h49ct1a.js";
 import"../shared/@ai-setting/roy-agent-core-bdajt9cs.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-b1vkkcbr.js";
+} from "../shared/@ai-setting/roy-agent-core-x65fyjaw.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-at05dk0z.js";
+import"../shared/@ai-setting/roy-agent-core-ss92p0r6.js";
 import"../shared/@ai-setting/roy-agent-core-hvdfgvfz.js";
 import"../shared/@ai-setting/roy-agent-core-9xby523m.js";
-import"../shared/@ai-setting/roy-agent-core-vady4w02.js";
+import"../shared/@ai-setting/roy-agent-core-hfgqwf5w.js";
 import {
   XDG_PATHS,
   getXDGPath,

package/dist/env/prompt/index.js

@@ -3,8 +3,8 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-7svhckhz.js";
-import"../../shared/@ai-setting/roy-agent-core-97tjdb2r.js";
+} from "../../shared/@ai-setting/roy-agent-core-mwb6918x.js";
+import"../../shared/@ai-setting/roy-agent-core-dj18eyyk.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
 import"../../shared/@ai-setting/roy-agent-core-pf1c360e.js";

package/dist/env/task/delegate/index.js

@@ -3,9 +3,9 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-at05dk0z.js";
+} from "../../../shared/@ai-setting/roy-agent-core-ss92p0r6.js";
 import"../../../shared/@ai-setting/roy-agent-core-hvdfgvfz.js";
-import"../../../shared/@ai-setting/roy-agent-core-vady4w02.js";
+import"../../../shared/@ai-setting/roy-agent-core-hfgqwf5w.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import"../../../shared/@ai-setting/roy-agent-core-gp872e7m.js";

package/dist/env/task/index.js

@@ -5,17 +5,17 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-b1vkkcbr.js";
+} from "../../shared/@ai-setting/roy-agent-core-x65fyjaw.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-at05dk0z.js";
+import"../../shared/@ai-setting/roy-agent-core-ss92p0r6.js";
 import"../../shared/@ai-setting/roy-agent-core-hvdfgvfz.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "../../shared/@ai-setting/roy-agent-core-9xby523m.js";
-import"../../shared/@ai-setting/roy-agent-core-vady4w02.js";
+import"../../shared/@ai-setting/roy-agent-core-hfgqwf5w.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-0ye4q2jj.js";
 import"../../shared/@ai-setting/roy-agent-core-t94ktchq.js";

package/dist/env/task/plugins/index.js

@@ -7,8 +7,8 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-svcr4gjw.js";
-import"../../../shared/@ai-setting/roy-agent-core-97tjdb2r.js";
+} from "../../../shared/@ai-setting/roy-agent-core-mx9vq7b2.js";
+import"../../../shared/@ai-setting/roy-agent-core-dj18eyyk.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../../shared/@ai-setting/roy-agent-core-8wd3qwx5.js";
 import"../../../shared/@ai-setting/roy-agent-core-4yq23m5g.js";

package/dist/env/tool/built-in/index.js

@@ -8,7 +8,13 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../../shared/@ai-setting/roy-agent-core-spzb03na.js";
+} from "../../../shared/@ai-setting/roy-agent-core-09xaxtpf.js";
+import {
+  getUnderstandImageLLMProvider,
+  resetUnderstandImageLLMProvider,
+  setUnderstandImageLLMProvider,
+  understandImageTool
+} from "../../../shared/@ai-setting/roy-agent-core-t7rw68q8.js";
 import"../../../shared/@ai-setting/roy-agent-core-hvdfgvfz.js";
 import"../../../shared/@ai-setting/roy-agent-core-cg146hmg.js";
 import"../../../shared/@ai-setting/roy-agent-core-vyygk314.js";
@@ -17,9 +23,13 @@ import"../../../shared/@ai-setting/roy-agent-core-c6592r3c.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   writeFileTool,
+  understandImageTool,
+  setUnderstandImageLLMProvider,
+  resetUnderstandImageLLMProvider,
   readFileTool,
   grepTool,
   globTool,
+  getUnderstandImageLLMProvider,
   getBuiltInTool,
   getAllBuiltInTools,
   editFileTool,

package/dist/env/tool/index.js

@@ -1,4 +1,4 @@
-import"../../shared/@ai-setting/roy-agent-core-pt7as39r.js";
+import"../../shared/@ai-setting/roy-agent-core-wjmwwc4a.js";
 import {
   bashTool,
   echoTool,
@@ -9,14 +9,20 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../shared/@ai-setting/roy-agent-core-spzb03na.js";
+} from "../../shared/@ai-setting/roy-agent-core-09xaxtpf.js";
+import {
+  getUnderstandImageLLMProvider,
+  resetUnderstandImageLLMProvider,
+  setUnderstandImageLLMProvider,
+  understandImageTool
+} from "../../shared/@ai-setting/roy-agent-core-t7rw68q8.js";
 import {
   ToolComponent,
   ToolRegistry,
   ToolValidator,
   getMaxOutputSize,
   setToolConfigComponent
-} from "../../shared/@ai-setting/roy-agent-core-ptb4pkva.js";
+} from "../../shared/@ai-setting/roy-agent-core-jhdv14ks.js";
 import"../../shared/@ai-setting/roy-agent-core-5h49ct1a.js";
 import"../../shared/@ai-setting/roy-agent-core-bdajt9cs.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
@@ -34,10 +40,14 @@ import"../../shared/@ai-setting/roy-agent-core-c6592r3c.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   writeFileTool,
+  understandImageTool,
+  setUnderstandImageLLMProvider,
   setToolConfigComponent,
+  resetUnderstandImageLLMProvider,
   readFileTool,
   grepTool,
   globTool,
+  getUnderstandImageLLMProvider,
   getMaxOutputSize,
   getBuiltInTool,
   getAllBuiltInTools,

package/dist/env/workflow/engine/index.js

@@ -5,9 +5,9 @@ import {
   Scheduler,
   WorkflowEngine,
   init_engine
-} from "../../../shared/@ai-setting/roy-agent-core-snvsn60t.js";
-import"../../../shared/@ai-setting/roy-agent-core-w1s8yrm5.js";
+} from "../../../shared/@ai-setting/roy-agent-core-b4sbnec8.js";
 import"../../../shared/@ai-setting/roy-agent-core-6atd905e.js";
+import"../../../shared/@ai-setting/roy-agent-core-phq62515.js";
 import"../../../shared/@ai-setting/roy-agent-core-q88vxmx5.js";
 import"../../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"../../../shared/@ai-setting/roy-agent-core-g2mth323.js";

package/dist/env/workflow/index.js

@@ -1,10 +1,10 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-vh8ncnzm.js";
+} from "../../shared/@ai-setting/roy-agent-core-ac0bc4x0.js";
 import"../../shared/@ai-setting/roy-agent-core-xgnpr28w.js";
-import"../../shared/@ai-setting/roy-agent-core-snvsn60t.js";
-import"../../shared/@ai-setting/roy-agent-core-w1s8yrm5.js";
+import"../../shared/@ai-setting/roy-agent-core-b4sbnec8.js";
 import"../../shared/@ai-setting/roy-agent-core-6atd905e.js";
+import"../../shared/@ai-setting/roy-agent-core-phq62515.js";
 import"../../shared/@ai-setting/roy-agent-core-q88vxmx5.js";
 import"../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"../../shared/@ai-setting/roy-agent-core-hhrg314p.js";

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   PromptComponent,
   PromptStore
-} from "./shared/@ai-setting/roy-agent-core-7svhckhz.js";
+} from "./shared/@ai-setting/roy-agent-core-mwb6918x.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -16,7 +16,7 @@ import {
 import {
   CommandsComponent
 } from "./shared/@ai-setting/roy-agent-core-578qk38y.js";
-import"./shared/@ai-setting/roy-agent-core-pt7as39r.js";
+import"./shared/@ai-setting/roy-agent-core-wjmwwc4a.js";
 import {
   bashTool,
   editFileTool,
@@ -26,7 +26,17 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "./shared/@ai-setting/roy-agent-core-spzb03na.js";
+} from "./shared/@ai-setting/roy-agent-core-09xaxtpf.js";
+import {
+  ATTACH_FILE_MAX_BYTES,
+  getUnderstandImageLLMProvider,
+  isMediaType,
+  parseImageInput,
+  resetUnderstandImageLLMProvider,
+  setUnderstandImageLLMProvider,
+  sniffMimeType,
+  understandImageTool
+} from "./shared/@ai-setting/roy-agent-core-t7rw68q8.js";
 import {
   closeDatabase
 } from "./shared/@ai-setting/roy-agent-core-jexyz11d.js";
@@ -62,7 +72,7 @@ import {
   getBuiltInHandler,
   larkCliHandler,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-5j649pb1.js";
+} from "./shared/@ai-setting/roy-agent-core-8f37pvct.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -81,24 +91,24 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-ws76avbn.js";
 import {
   TaskTagPlugin
-} from "./shared/@ai-setting/roy-agent-core-svcr4gjw.js";
+} from "./shared/@ai-setting/roy-agent-core-mx9vq7b2.js";
 import {
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-97tjdb2r.js";
+} from "./shared/@ai-setting/roy-agent-core-dj18eyyk.js";
 import {
   BasePlugin
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "./shared/@ai-setting/roy-agent-core-vh8ncnzm.js";
+} from "./shared/@ai-setting/roy-agent-core-ac0bc4x0.js";
 import {
   init_node_registry_helper,
   registerDecoratorNodeType
 } from "./shared/@ai-setting/roy-agent-core-xgnpr28w.js";
-import"./shared/@ai-setting/roy-agent-core-snvsn60t.js";
-import"./shared/@ai-setting/roy-agent-core-w1s8yrm5.js";
+import"./shared/@ai-setting/roy-agent-core-b4sbnec8.js";
 import"./shared/@ai-setting/roy-agent-core-6atd905e.js";
+import"./shared/@ai-setting/roy-agent-core-phq62515.js";
 import"./shared/@ai-setting/roy-agent-core-q88vxmx5.js";
 import"./shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"./shared/@ai-setting/roy-agent-core-hhrg314p.js";
@@ -120,7 +130,7 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-mw9a595w.js";
+} from "./shared/@ai-setting/roy-agent-core-6rx2yt78.js";
 import {
   createInvokeConfig,
   invoke,
@@ -131,7 +141,7 @@ import {
   ToolComponent,
   ToolRegistry,
   ToolValidator
-} from "./shared/@ai-setting/roy-agent-core-ptb4pkva.js";
+} from "./shared/@ai-setting/roy-agent-core-jhdv14ks.js";
 import"./shared/@ai-setting/roy-agent-core-5h49ct1a.js";
 import {
   createAutoTaskPlugin
@@ -142,9 +152,9 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-b1vkkcbr.js";
+} from "./shared/@ai-setting/roy-agent-core-x65fyjaw.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-at05dk0z.js";
+import"./shared/@ai-setting/roy-agent-core-ss92p0r6.js";
 import"./shared/@ai-setting/roy-agent-core-hvdfgvfz.js";
 import {
   SQLiteTaskStore,
@@ -152,7 +162,7 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-9xby523m.js";
 import {
   AgentRegistry
-} from "./shared/@ai-setting/roy-agent-core-vady4w02.js";
+} from "./shared/@ai-setting/roy-agent-core-hfgqwf5w.js";
 import {
   XDG_PATHS,
   getXDGPath,
@@ -234,103 +244,6 @@ import {
   SQLiteSpanStorage
 } from "./shared/@ai-setting/roy-agent-core-c6592r3c.js";
 import"./shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
-// src/utils/media.ts
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-var ATTACH_FILE_MAX_BYTES = 10 * 1024 * 1024;
-function startsWith(buf, sig) {
-  if (buf.length < sig.length)
-    return false;
-  for (let i = 0;i < sig.length; i++) {
-    if (buf[i] !== sig[i])
-      return false;
-  }
-  return true;
-}
-function sniffMimeType(buffer, fallbackName) {
-  if (startsWith(buffer, [137, 80, 78, 71, 13, 10, 26, 10])) {
-    return "image/png";
-  }
-  if (startsWith(buffer, [255, 216, 255])) {
-    return "image/jpeg";
-  }
-  if (startsWith(buffer, [71, 73, 70, 56])) {
-    return "image/gif";
-  }
-  if (startsWith(buffer, [66, 77])) {
-    return "image/bmp";
-  }
-  if (startsWith(buffer, [37, 80, 68, 70, 45])) {
-    return "application/pdf";
-  }
-  if (startsWith(buffer, [82, 73, 70, 70]) && startsWith(buffer.subarray(8), [87, 69, 66, 80])) {
-    return "image/webp";
-  }
-  if (fallbackName) {
-    const ext = path.extname(fallbackName).toLowerCase();
-    const extMap = {
-      ".png": "image/png",
-      ".jpg": "image/jpeg",
-      ".jpeg": "image/jpeg",
-      ".gif": "image/gif",
-      ".webp": "image/webp",
-      ".bmp": "image/bmp",
-      ".pdf": "application/pdf",
-      ".mp3": "audio/mpeg",
-      ".wav": "audio/wav",
-      ".ogg": "audio/ogg",
-      ".m4a": "audio/mp4",
-      ".mp4": "video/mp4",
-      ".mov": "video/quicktime",
-      ".webm": "video/webm"
-    };
-    const mapped = extMap[ext];
-    if (mapped)
-      return mapped;
-  }
-  return "application/octet-stream";
-}
-function isMediaType(mime) {
-  if (typeof mime !== "string")
-    return false;
-  const m = mime.toLowerCase();
-  return m.startsWith("image/") || m.startsWith("audio/") || m.startsWith("video/") || m === "application/pdf";
-}
-var HTTP_URL_RE = /^https?:\/\//i;
-var DATA_URL_RE = /^data:([^;,]+)(;base64)?,(.*)$/s;
-async function parseImageInput(input) {
-  if (!input || typeof input !== "string" || input.trim().length === 0) {
-    throw new Error("parseImageInput: input is empty");
-  }
-  const trimmed = input.trim();
-  if (HTTP_URL_RE.test(trimmed)) {
-    return { type: "image", image: trimmed };
-  }
-  if (DATA_URL_RE.test(trimmed)) {
-    return { type: "image", image: trimmed };
-  }
-  return await parseLocalImagePath(trimmed);
-}
-async function parseLocalImagePath(filePath) {
-  let stat2;
-  try {
-    stat2 = await fs.stat(filePath);
-  } catch (err) {
-    throw new Error(`parseImageInput: cannot stat file '${filePath}': ${err.message}`);
-  }
-  if (!stat2.isFile()) {
-    throw new Error(`parseImageInput: not a regular file: ${filePath}`);
-  }
-  if (stat2.size > ATTACH_FILE_MAX_BYTES) {
-    throw new Error(`parseImageInput: file '${filePath}' exceeds 10 MiB limit ` + `(${stat2.size} bytes > ${ATTACH_FILE_MAX_BYTES} bytes)`);
-  }
-  const buffer = await fs.readFile(filePath);
-  const mime = sniffMimeType(buffer, filePath);
-  if (!mime.startsWith("image/")) {
-    throw new Error(`parseImageInput: file '${filePath}' is not an image (detected ${mime}). ` + `Use ContentPart type 'file' for non-image attachments.`);
-  }
-  return { type: "image", image: buffer };
-}
 // src/env/memory/tools/memory-agent-tools.ts
 import { z } from "zod";
 var SearchSessionsSchema = z.object({
@@ -455,11 +368,14 @@ export {
   writeFileTool,
   wrapFunction,
   validateEventSourceConfig,
+  understandImageTool,
   timerHandler,
   sniffMimeType,
+  setUnderstandImageLLMProvider,
   setQuietMode,
   setConfigComponent as setLoggerConfigComponent,
   setLogDirOverride,
+  resetUnderstandImageLLMProvider,
   resetTracerProvider,
   registerDecoratorNodeType,
   readFileTool,
@@ -479,6 +395,7 @@ export {
   globTool,
   getXDGPaths,
   getXDGPath,
+  getUnderstandImageLLMProvider,
   getTracerProvider,
   getLogLevels,
   getLogLevel,

package/dist/shared/@ai-setting/{roy-agent-core-spzb03na.js → roy-agent-core-09xaxtpf.js}

@@ -1,3 +1,6 @@
+import {
+  understandImageTool
+} from "./roy-agent-core-t7rw68q8.js";
 import {
   getCurrentProcessRegistry,
   killProcessTree
@@ -907,7 +910,6 @@ var grepTool = {
     }
   }
 };
-
 // src/env/tool/built-in/index.ts
 function getAllBuiltInTools() {
   return [
@@ -917,7 +919,8 @@ function getAllBuiltInTools() {
     readFileTool,
     writeFileTool,
     editFileTool,
-    grepTool
+    grepTool,
+    understandImageTool
   ];
 }
 function getBuiltInTool(name) {

package/dist/shared/@ai-setting/{roy-agent-core-mw9a595w.js → roy-agent-core-6rx2yt78.js}

@@ -3,14 +3,14 @@ import {
 } from "./roy-agent-core-j7jeqxhd.js";
 import {
   truncateOutputInline
-} from "./roy-agent-core-ptb4pkva.js";
+} from "./roy-agent-core-jhdv14ks.js";
 import {
   AskUserError,
   init_workflow_hil
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-vady4w02.js";
+} from "./roy-agent-core-hfgqwf5w.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";
@@ -47,7 +47,8 @@ import {
   init_logger
 } from "./roy-agent-core-vyygk314.js";
 import {
-  __legacyDecorateClassTS
+  __legacyDecorateClassTS,
+  __require
 } from "./roy-agent-core-fs0mn2jk.js";
 
 // src/env/agent/agent-component.ts
@@ -416,12 +417,32 @@ class AgentComponent extends BaseComponent {
     this.setStatus("stopped");
     logger.info("[AgentComponent] Cleanup completed");
   }
-  refreshDependencies() {
+  async refreshDependencies() {
     if (this.env) {
       const llm = this.env.getComponent("llm");
       const tool = this.env.getComponent("tool");
       this.llmComponent = llm ? llm : null;
       this.toolComponent = tool ? tool : null;
+      if (this.llmComponent) {
+        try {
+          const mod = await import("./roy-agent-core-cy8azvpb.js");
+          mod.setUnderstandImageLLMProvider(async (messages) => {
+            const result = await this.llmComponent.invoke({
+              messages,
+              tools: [],
+              skipThresholdCheck: true,
+              context: {
+                sessionId: undefined,
+                messageId: `understand_image-${Date.now()}`
+              }
+            });
+            return result.output?.content ?? "";
+          });
+          logger.debug("[refreshDependencies] understand_image LLM provider injected");
+        } catch (err) {
+          logger.warn(`[refreshDependencies] failed to inject understand_image provider: ${err.message}`);
+        }
+      }
       logger.debug("[refreshDependencies] AgentComponent refreshed", {
         hasLLM: !!this.llmComponent,
         hasTool: !!this.toolComponent
@@ -574,7 +595,7 @@ class AgentComponent extends BaseComponent {
     this.notifyMessageAdded(message);
   }
   async _run(agentName, query, context) {
-    this.refreshDependencies();
+    await this.refreshDependencies();
     const agent = this.getAgent(agentName);
     if (!agent) {
       throw new Error(`Agent not found: ${agentName}`);
@@ -633,7 +654,10 @@ class AgentComponent extends BaseComponent {
       context: effectiveContext
     };
     let historyMessageCount = 0;
-    if (effectiveContext.sessionId) {
+    if (effectiveContext.messages && effectiveContext.messages.length > 0) {
+      hookCtx.messages = effectiveContext.messages;
+      historyMessageCount = hookCtx.messages.length;
+    } else if (effectiveContext.sessionId) {
       try {
         const sessionComponent = this.env.getComponent("session");
         if (sessionComponent) {
@@ -1105,7 +1129,8 @@ ${additionInfo}`
             messageId: ctx.context.messageId
           },
           abortSignal: ctx.context.abort,
-          skipThresholdCheck: ctx.context.agentType === "sub"
+          skipThresholdCheck: ctx.context.agentType === "sub",
+          ...ctx.context.toolChoice ? { toolChoice: ctx.context.toolChoice } : {}
         });
         const result = await withTimeout(llmPromise, 300000, "LLM invocation timeout after 300s");
         logger.debug("[invokeLLM] LLMComponent.invoke returned successfully");

package/dist/shared/@ai-setting/{roy-agent-core-q7ffkt1e.js → roy-agent-core-81j8yhsw.js}

@@ -1,7 +1,7 @@
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-w1s8yrm5.js";
+} from "./roy-agent-core-phq62515.js";
 import"./roy-agent-core-1db4vpc6.js";
 import"./roy-agent-core-e25xkv53.js";
 import"./roy-agent-core-gp872e7m.js";

package/dist/shared/@ai-setting/{roy-agent-core-5j649pb1.js → roy-agent-core-8f37pvct.js}

@@ -1,7 +1,7 @@
 import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook
-} from "./roy-agent-core-svcr4gjw.js";
+} from "./roy-agent-core-mx9vq7b2.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-qxhq8ven.js";

package/dist/shared/@ai-setting/{roy-agent-core-vh8ncnzm.js → roy-agent-core-ac0bc4x0.js}

@@ -6,7 +6,7 @@ import {
   WorkflowEngine,
   exports_engine,
   init_engine
-} from "./roy-agent-core-snvsn60t.js";
+} from "./roy-agent-core-b4sbnec8.js";
 import {
   askUserTool,
   createRunWorkflowTool,
@@ -141,7 +141,7 @@ class WorkflowComponent extends BaseComponent {
     if (!agentRunner && this._workflowEnv) {
       const agentComponent = this._workflowEnv.getComponent("agent");
       if (agentComponent) {
-        const { AgentComponentAdapter } = await import("./roy-agent-core-q7ffkt1e.js");
+        const { AgentComponentAdapter } = await import("./roy-agent-core-81j8yhsw.js");
         agentRunner = new AgentComponentAdapter(agentComponent, {}, this.sessionComponent);
       }
     }

package/dist/shared/@ai-setting/{roy-agent-core-snvsn60t.js → roy-agent-core-b4sbnec8.js}

@@ -1,13 +1,13 @@
-import {
-  AgentComponentAdapter,
-  init_agent_component_adapter
-} from "./roy-agent-core-w1s8yrm5.js";
 import {
   buildWorkflowNodeMetadata,
   getWorkflowNodeIdFromMetadata,
   init_workflow_message_metadata,
   patchAgentSessionIdOnMessage
 } from "./roy-agent-core-6atd905e.js";
+import {
+  AgentComponentAdapter,
+  init_agent_component_adapter
+} from "./roy-agent-core-phq62515.js";
 import {
   TemplateResolver,
   init_template_resolver
@@ -892,6 +892,32 @@ var init_extract_agent_json_output = __esm(() => {
 });
 
 // src/env/workflow/utils/build-agent-node-output.ts
+function extractSchemaFieldNames(schema) {
+  if (!schema)
+    return [];
+  const props = schema.properties;
+  if (!props || typeof props !== "object")
+    return [];
+  return Object.keys(props);
+}
+function defaultValueForField(fieldName) {
+  const lower = fieldName.toLowerCase();
+  if (lower === "score" || lower.endsWith("_score"))
+    return 0;
+  if (lower === "findings" || lower.endsWith("_list") || lower.endsWith("s"))
+    return [];
+  if (lower.includes("count") || lower.includes("total"))
+    return 0;
+  if (lower === "dimension")
+    return "unknown";
+  if (lower === "verdict")
+    return "unknown";
+  if (lower.includes("summary") || lower.includes("description") || lower.includes("report"))
+    return "";
+  if (lower.includes("markdown"))
+    return "";
+  return "";
+}
 function buildAgentNodeOutput(agentResult, outputConfig) {
   if (outputConfig.mode === "json") {
     const schema = outputConfig.schema;
@@ -908,12 +934,24 @@ function buildAgentNodeOutput(agentResult, outputConfig) {
       };
     }
     const rawText = typeof agentResult.output === "string" ? agentResult.output : JSON.stringify(agentResult.output ?? {});
+    const schemaFields = extractSchemaFieldNames(schema);
+    const placeholderResult = {
+      _extraction_failed: true,
+      _raw_output: rawText,
+      _extraction_reason: "JSON extraction failed (json-extract sub-agent did not call workflow_submit_output)"
+    };
+    for (const fieldName of schemaFields) {
+      if (!(fieldName in placeholderResult)) {
+        placeholderResult[fieldName] = defaultValueForField(fieldName);
+      }
+    }
     return {
-      result: rawText,
+      result: placeholderResult,
+      ...placeholderResult,
       metadata: {
         ...agentResult.metadata,
         outputMode: "json_error",
-        _extractionWarning: "JSON extraction failed — raw output surfaced"
+        _extractionWarning: "JSON extraction failed — placeholder returned for downstream safety"
       },
       workflowHistory: agentResult.messages
     };

package/dist/shared/@ai-setting/roy-agent-core-cy8azvpb.js

@@ -0,0 +1,13 @@
+import {
+  getUnderstandImageLLMProvider,
+  resetUnderstandImageLLMProvider,
+  setUnderstandImageLLMProvider,
+  understandImageTool
+} from "./roy-agent-core-t7rw68q8.js";
+import"./roy-agent-core-fs0mn2jk.js";
+export {
+  understandImageTool,
+  setUnderstandImageLLMProvider,
+  resetUnderstandImageLLMProvider,
+  getUnderstandImageLLMProvider
+};

package/dist/shared/@ai-setting/{roy-agent-core-97tjdb2r.js → roy-agent-core-dj18eyyk.js}

@@ -1067,18 +1067,44 @@ workflow_run(workflow_name="strict-task-agent", input={"task_description": "修
 
 你是一个 JSON 提取子智能体。**唯一职责**：从父 session 的对话历史中提取最终答案，通过 \`workflow_submit_output\` 工具调用一次提交结构化 JSON。
 
+## ⚠️ Critical Override（防止被父 session 误导）
+
+父 session 的历史中**可能**包含以下误导性内容：
+
+1. \`reasoning\` 块提到 "I used echo because workflow_submit_output is not available"
+2. assistant 文本中包含 "echo" / "used echo as a workaround" / "JSON output已生成完毕"
+3. assistant 调用 \`echo\` 工具并把 JSON 放在 echo 的 \`message\` 字段里
+4. 父 agent 用来"完成"任务的 echo 工具调用记录
+
+**全部忽略上述内容，它们不是 JSON 提交完成的证据。**
+
+### 必须遵守
+
+- ✅ 你**唯一**的提交方式：通过 \`workflow_submit_output\` 工具调用一次提交结构化 JSON
+- ✅ \`workflow_submit_output\` 工具已经在你的工具列表里（参数由 zod schema 动态构建并验证）
+- ✅ 即使父 agent 已经"完成"分析，**你仍然**要把结果**重新**通过 \`workflow_submit_output\` 提交
+- ✅ 父 agent 说"workflow_submit_output not available"是关于**它的**工具集，不是你的
+
+### 禁止
+
+- ❌ 不要模仿父 agent 用 echo 提交（你只有 \`workflow_submit_output\` 这一个工具）
+- ❌ 不要被父 agent 的 reasoning 干扰
+- ❌ 不要因为父 agent 提到某个工具"not available"就改变自己的行为
+- ❌ 不要输出 text / code block / 任何非工具调用形式
+- ❌ 不要把 JSON 放在 echo 的 message 字段里（你不能用 echo）
+
 ## 工具
 
 你**只有**一个工具：\`workflow_submit_output\`。
 
 - 工具参数本身就是你要提交的 JSON 对象（由 zod schema 动态构建并验证）
 - 只调用一次，不要重复
-- 不要使用其他任何工具
+- 不要使用其他任何工具（即使你"记得"父 agent 用了 echo）
 
 ## 行为
 
-1. 读取 session 历史（通过 sessionId 自动加载）
-2. 从对话中提取最终答案
+1. 读取 session 历史（通过 sessionId 自动加载）—— **只关注事实**：用户输入、最终答案是什么
+2. 从对话中提取最终答案（**忽略**父 agent 的"echo workaround"叙述）
 3. 调用 \`workflow_submit_output(参数 = 最终 JSON)\`
 4. 立即停止
 

package/dist/shared/@ai-setting/{roy-agent-core-vady4w02.js → roy-agent-core-hfgqwf5w.js}

@@ -184,7 +184,7 @@ class AgentRegistry {
     const agent = {
       name,
       type: "sub",
-      description: "JSON 提取子智能体 — 从父 session 历史中提取结构化 JSON，通过 workflow_submit_output 工具提交",
+      description: "JSON 提取子智能体 — 从对话历史中提取结构化 JSON，通过 workflow_submit_output 工具提交",
       systemPromptRef: "json-extract",
       allowedTools: ["workflow_submit_output"],
       deniedTools: [],

package/dist/shared/@ai-setting/{roy-agent-core-7svhckhz.js → roy-agent-core-mwb6918x.js}

@@ -1,6 +1,6 @@
 import {
   builtInPrompts
-} from "./roy-agent-core-97tjdb2r.js";
+} from "./roy-agent-core-dj18eyyk.js";
 import {
   getXDGPath
 } from "./roy-agent-core-qxnbvgwe.js";

package/dist/shared/@ai-setting/{roy-agent-core-svcr4gjw.js → roy-agent-core-mx9vq7b2.js}

@@ -1,6 +1,6 @@
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-97tjdb2r.js";
+} from "./roy-agent-core-dj18eyyk.js";
 import {
   BasePlugin
 } from "./roy-agent-core-az13yzmc.js";

package/dist/shared/@ai-setting/{roy-agent-core-w1s8yrm5.js → roy-agent-core-phq62515.js}

@@ -25,6 +25,28 @@ import {
 } from "./roy-agent-core-fs0mn2jk.js";
 
 // src/env/workflow/plugins/workflow-json-output-plugin.ts
+function extractLastAssistantText(messages) {
+  if (!messages || messages.length === 0) {
+    return;
+  }
+  for (let i = messages.length - 1;i >= 0; i--) {
+    const msg = messages[i];
+    if (msg.role !== "assistant") {
+      continue;
+    }
+    const content = msg.content;
+    if (typeof content === "string") {
+      return content.trim() || undefined;
+    }
+    if (Array.isArray(content)) {
+      const textParts = content.filter((p) => typeof p === "object" && p !== null && p.type === "text").map((p) => p.text);
+      const combined = textParts.join(`
+`).trim();
+      return combined || undefined;
+    }
+  }
+  return;
+}
 function registerWorkflowJsonOutputPlugin(options = undefined) {
   if (registered) {
     return;
@@ -61,34 +83,52 @@ async function runWorkflowJsonOutputExtraction(hookCtx) {
     logger.warn("Workflow JSON extraction: agentComponent not registered. " + "Plugin cannot invoke json-extract sub-agent. " + "Ensure registerWorkflowJsonOutputPlugin({ agentComponent }) was called.");
     return;
   }
-  const sessionId = hookCtx.context.sessionId;
-  if (!sessionId) {
-    logger.warn("Workflow JSON extraction: no sessionId in hookCtx.context. " + "Cannot reuse main session history for json-extract sub-agent.");
+  const assistantText = extractLastAssistantText(hookCtx.messages);
+  if (!assistantText) {
+    logger.warn("Workflow JSON extraction: no assistant text found in main agent output. " + "The agent must produce a final text response (plain or markdown).");
     return;
   }
+  const submitTool = createSubmitJsonOutputTool(schema, hookCtx);
+  const submitToolAsExtra = {
+    name: submitTool.name,
+    description: submitTool.description ?? "",
+    parameters: submitTool.parameters,
+    execute: submitTool.execute
+  };
+  const userQuery = [
+    "The main agent has produced the following final response.",
+    "Extract the structured JSON from it and submit via workflow_submit_output.",
+    "",
+    "--- START of main agent response ---",
+    assistantText,
+    "--- END of main agent response ---",
+    "",
+    "Your ONLY job: call workflow_submit_output with the extracted JSON.",
+    "Do NOT output any text — just call the tool."
+  ].join(`
+`);
+  const messagesOverride = [
+    {
+      role: "user",
+      content: userQuery
+    }
+  ];
+  const extractContext = {
+    messages: messagesOverride,
+    extraTools: [submitToolAsExtra],
+    persistSession: false,
+    abort: hookCtx.context.abort
+  };
   try {
-    const submitTool = createSubmitJsonOutputTool(schema, hookCtx);
-    const submitToolAsExtra = {
-      name: submitTool.name,
-      description: submitTool.description ?? "",
-      parameters: submitTool.parameters,
-      execute: submitTool.execute
-    };
-    const extractContext = {
-      sessionId,
-      extraTools: [submitToolAsExtra],
-      persistSession: false,
-      abort: hookCtx.context.abort
-    };
     const result = await agentComponentRef.run("json-extract", "", extractContext);
     if (result.error) {
       logger.warn(`Workflow JSON extraction: json-extract sub-agent returned error: ${result.error}`);
       return;
     }
     if (hookCtx.structuredOutputExtracted) {
-      logger.info("Workflow JSON output extracted via json-extract sub-agent " + `(iterations=${result.iterations}, toolCalls=${result.toolCalls?.length ?? 0})`);
+      logger.info("Workflow JSON output extracted via json-extract sub-agent (clean override) " + `(iterations=${result.iterations}, toolCalls=${result.toolCalls?.length ?? 0})`);
     } else {
-      logger.warn("Workflow JSON extraction: json-extract sub-agent did not call workflow_submit_output. " + "Check that the model supports tool calls.");
+      logger.warn("Workflow JSON extraction: json-extract sub-agent did not call workflow_submit_output. " + "toolChoice=required failed to force tool call — investigate provider support.");
     }
   } catch (error) {
     logger.error(`Workflow JSON extraction: json-extract sub-agent threw: ${error instanceof Error ? error.message : String(error)}`);

package/dist/shared/@ai-setting/{roy-agent-core-at05dk0z.js → roy-agent-core-ss92p0r6.js}

@@ -4,7 +4,7 @@ import {
 } from "./roy-agent-core-hvdfgvfz.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
-} from "./roy-agent-core-vady4w02.js";
+} from "./roy-agent-core-hfgqwf5w.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-92z6t4he.js";

package/dist/shared/@ai-setting/roy-agent-core-t7rw68q8.js

@@ -0,0 +1,185 @@
+// src/env/tool/built-in/understand-image.ts
+import { z } from "zod";
+
+// src/utils/media.ts
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+var ATTACH_FILE_MAX_BYTES = 10 * 1024 * 1024;
+function startsWith(buf, sig) {
+  if (buf.length < sig.length)
+    return false;
+  for (let i = 0;i < sig.length; i++) {
+    if (buf[i] !== sig[i])
+      return false;
+  }
+  return true;
+}
+function sniffMimeType(buffer, fallbackName) {
+  if (startsWith(buffer, [137, 80, 78, 71, 13, 10, 26, 10])) {
+    return "image/png";
+  }
+  if (startsWith(buffer, [255, 216, 255])) {
+    return "image/jpeg";
+  }
+  if (startsWith(buffer, [71, 73, 70, 56])) {
+    return "image/gif";
+  }
+  if (startsWith(buffer, [66, 77])) {
+    return "image/bmp";
+  }
+  if (startsWith(buffer, [37, 80, 68, 70, 45])) {
+    return "application/pdf";
+  }
+  if (startsWith(buffer, [82, 73, 70, 70]) && startsWith(buffer.subarray(8), [87, 69, 66, 80])) {
+    return "image/webp";
+  }
+  if (fallbackName) {
+    const ext = path.extname(fallbackName).toLowerCase();
+    const extMap = {
+      ".png": "image/png",
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".gif": "image/gif",
+      ".webp": "image/webp",
+      ".bmp": "image/bmp",
+      ".pdf": "application/pdf",
+      ".mp3": "audio/mpeg",
+      ".wav": "audio/wav",
+      ".ogg": "audio/ogg",
+      ".m4a": "audio/mp4",
+      ".mp4": "video/mp4",
+      ".mov": "video/quicktime",
+      ".webm": "video/webm"
+    };
+    const mapped = extMap[ext];
+    if (mapped)
+      return mapped;
+  }
+  return "application/octet-stream";
+}
+function isMediaType(mime) {
+  if (typeof mime !== "string")
+    return false;
+  const m = mime.toLowerCase();
+  return m.startsWith("image/") || m.startsWith("audio/") || m.startsWith("video/") || m === "application/pdf";
+}
+var HTTP_URL_RE = /^https?:\/\//i;
+var DATA_URL_RE = /^data:([^;,]+)(;base64)?,(.*)$/s;
+async function parseImageInput(input) {
+  if (!input || typeof input !== "string" || input.trim().length === 0) {
+    throw new Error("parseImageInput: input is empty");
+  }
+  const trimmed = input.trim();
+  if (HTTP_URL_RE.test(trimmed)) {
+    return { type: "image", image: trimmed };
+  }
+  if (DATA_URL_RE.test(trimmed)) {
+    return { type: "image", image: trimmed };
+  }
+  return await parseLocalImagePath(trimmed);
+}
+async function parseLocalImagePath(filePath) {
+  let stat2;
+  try {
+    stat2 = await fs.stat(filePath);
+  } catch (err) {
+    throw new Error(`parseImageInput: cannot stat file '${filePath}': ${err.message}`);
+  }
+  if (!stat2.isFile()) {
+    throw new Error(`parseImageInput: not a regular file: ${filePath}`);
+  }
+  if (stat2.size > ATTACH_FILE_MAX_BYTES) {
+    throw new Error(`parseImageInput: file '${filePath}' exceeds 10 MiB limit ` + `(${stat2.size} bytes > ${ATTACH_FILE_MAX_BYTES} bytes)`);
+  }
+  const buffer = await fs.readFile(filePath);
+  const mime = sniffMimeType(buffer, filePath);
+  if (!mime.startsWith("image/")) {
+    throw new Error(`parseImageInput: file '${filePath}' is not an image (detected ${mime}). ` + `Use ContentPart type 'file' for non-image attachments.`);
+  }
+  return { type: "image", image: buffer };
+}
+
+// src/env/tool/built-in/understand-image.ts
+var injectedProvider = null;
+function setUnderstandImageLLMProvider(provider) {
+  injectedProvider = provider;
+}
+function getUnderstandImageLLMProvider() {
+  return injectedProvider;
+}
+async function resetUnderstandImageLLMProvider() {
+  injectedProvider = null;
+}
+function normalizeImageSource(raw) {
+  if (typeof raw !== "string")
+    return raw;
+  return raw.startsWith("@") ? raw.slice(1) : raw;
+}
+var understandImageTool = {
+  name: "understand_image",
+  description: "Analyze or describe the contents of an image using a multimodal LLM. " + "Provide a prompt describing what you want to extract or understand " + "(e.g. 'Describe this image in detail', 'Read the text in the receipt', " + "'What color is the car?'). The image_source can be an HTTP(S) URL, a " + "data:base64 URL, or a local file path (optionally prefixed with '@').",
+  parameters: z.object({
+    prompt: z.string().min(1).describe("A text prompt describing what you want to analyze or extract from the image."),
+    image_source: z.string().min(1).describe("The location of the image to analyze. Accepts HTTP(S) URL, data:base64 URL, or local file path. Optional '@' prefix is stripped.")
+  }),
+  metadata: {
+    category: "ai",
+    tags: ["multimodal", "vision", "image", "llm", "ocr"],
+    version: "1.0.0"
+  },
+  permission: {
+    level: "safe"
+  },
+  execute: async (args, _ctx) => {
+    const startTime = Date.now();
+    const { prompt, image_source } = args;
+    if (!injectedProvider) {
+      return {
+        success: false,
+        output: "",
+        error: "understand_image is not initialized: no LLM provider has been " + "registered. AgentComponent should call setUnderstandImageLLMProvider() " + "at agent startup.",
+        metadata: { execution_time_ms: Date.now() - startTime }
+      };
+    }
+    let imagePart;
+    try {
+      imagePart = await parseImageInput(normalizeImageSource(image_source));
+    } catch (err) {
+      return {
+        success: false,
+        output: "",
+        error: `failed to read image: ${err.message}`,
+        metadata: { execution_time_ms: Date.now() - startTime }
+      };
+    }
+    const messages = [
+      {
+        role: "user",
+        content: [
+          { type: "text", text: prompt },
+          imagePart
+        ]
+      }
+    ];
+    let responseText;
+    try {
+      responseText = await injectedProvider(messages);
+    } catch (err) {
+      return {
+        success: false,
+        output: "",
+        error: `LLM invocation failed: ${err.message}`,
+        metadata: { execution_time_ms: Date.now() - startTime }
+      };
+    }
+    return {
+      success: true,
+      output: responseText,
+      metadata: {
+        execution_time_ms: Date.now() - startTime
+      }
+    };
+  }
+};
+
+export { ATTACH_FILE_MAX_BYTES, sniffMimeType, isMediaType, parseImageInput, setUnderstandImageLLMProvider, getUnderstandImageLLMProvider, resetUnderstandImageLLMProvider, understandImageTool };

package/dist/shared/@ai-setting/{roy-agent-core-b1vkkcbr.js → roy-agent-core-x65fyjaw.js}

@@ -5,7 +5,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-at05dk0z.js";
+} from "./roy-agent-core-ss92p0r6.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.5.92",
+  "version": "1.5.94",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",