@ai-setting/roy-agent-core 1.7.3 → 1.7.4

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

@@ -1,6 +1,8 @@
 import {
-  EnvSource
-} from "./roy-agent-core-y3g3ar7a.js";
+  EnvSource,
+  parseJSONCWithEnv,
+  parseJSONCWithProtocols
+} from "./roy-agent-core-adg9ghbt.js";
 import {
   XDG_PATHS
 } from "./roy-agent-core-qxnbvgwe.js";
@@ -11,114 +13,6 @@ import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";
 
-// src/config/config-parser.ts
-import { parse as parseJSONCInternal, ParseErrorCode } from "jsonc-parser";
-function parseJSONC(content) {
-  const errors = [];
-  const result = parseJSONCInternal(content, errors, {
-    allowTrailingComma: true,
-    disallowComments: false
-  });
-  if (errors.length > 0) {
-    const hasOnlyValueExpected = result === undefined && errors.length === 1 && errors[0].error === ParseErrorCode.ValueExpected;
-    if (!hasOnlyValueExpected) {
-      const error = errors[0];
-      const offset = error.offset;
-      const lines = content.substring(0, offset).split(`
-`);
-      const line = lines.length;
-      const col = lines[lines.length - 1].length + 1;
-      const errorMessages = {
-        [ParseErrorCode.UnexpectedEndOfString]: "Unexpected end of string",
-        [ParseErrorCode.InvalidCharacter]: "Invalid character",
-        [ParseErrorCode.PropertyNameExpected]: "Property name expected",
-        [ParseErrorCode.ValueExpected]: "Value expected",
-        [ParseErrorCode.ColonExpected]: "Colon expected",
-        [ParseErrorCode.CommaExpected]: "Comma expected",
-        [ParseErrorCode.CloseBraceExpected]: "Close brace expected",
-        [ParseErrorCode.CloseBracketExpected]: "Close bracket expected",
-        [ParseErrorCode.EndOfFileExpected]: "Unexpected end of input",
-        [ParseErrorCode.InvalidSymbol]: "Invalid symbol"
-      };
-      throw new Error(`JSONC parse error at line ${line}, col ${col}: ${errorMessages[error.error] || "Unknown error"}`);
-    }
-  }
-  if (result === undefined || result === null) {
-    return {};
-  }
-  return result;
-}
-function substituteEnvVars(value) {
-  if (typeof value === "string") {
-    return value.replace(/\$\{([^}]+)\}/g, (match, varExpr) => {
-      const [varName, defaultValue] = varExpr.split(":-");
-      const envValue = process.env[varName.trim()];
-      if (envValue !== undefined) {
-        return envValue;
-      }
-      if (defaultValue !== undefined) {
-        return defaultValue;
-      }
-      return "";
-    });
-  }
-  if (Array.isArray(value)) {
-    return value.map((item) => substituteEnvVars(item));
-  }
-  if (value !== null && typeof value === "object") {
-    const result = {};
-    for (const [key, val] of Object.entries(value)) {
-      result[key] = substituteEnvVars(val);
-    }
-    return result;
-  }
-  return value;
-}
-function parseJSONCWithEnv(content) {
-  const parsed = parseJSONC(content);
-  return substituteEnvVars(parsed);
-}
-var PROTOCOL_REF_PATTERN = /^\$\{([^:]+):\/\/[^}]+\}$/;
-var PROTOCOL_REF_WITH_DEFAULT_PATTERN = /^\$\{([^:]+):\/\/([^:#]+)(?:#([^:-]+))?(?::-(.*))?\}$/;
-function isProtocolRefString(value) {
-  return PROTOCOL_REF_PATTERN.test(value);
-}
-function extractDefaultValue(ref) {
-  const match = ref.match(PROTOCOL_REF_WITH_DEFAULT_PATTERN);
-  return match ? match[4] : undefined;
-}
-function substituteProtocolRefs(value, resolver) {
-  if (typeof value === "string") {
-    if (isProtocolRefString(value)) {
-      const result = resolver.resolve(value);
-      if (result !== null) {
-        return result.value;
-      }
-      const defaultValue = extractDefaultValue(value);
-      if (defaultValue !== undefined) {
-        return defaultValue;
-      }
-    }
-    return value;
-  }
-  if (Array.isArray(value)) {
-    return value.map((item) => substituteProtocolRefs(item, resolver));
-  }
-  if (value !== null && typeof value === "object") {
-    const result = {};
-    for (const [key, val] of Object.entries(value)) {
-      result[key] = substituteProtocolRefs(val, resolver);
-    }
-    return result;
-  }
-  return value;
-}
-function parseJSONCWithProtocols(content, resolver) {
-  const parsed = parseJSONC(content);
-  const withProtocols = substituteProtocolRefs(parsed, resolver);
-  return substituteEnvVars(withProtocols);
-}
-
 // src/config/file-source.ts
 import * as fsSync from "fs";
 import * as fsPromises from "fs/promises";
@@ -1054,4 +948,4 @@ class ConfigComponent extends BaseComponent {
   }
 }
 
-export { parseJSONC, substituteEnvVars, parseJSONCWithEnv, substituteProtocolRefs, parseJSONCWithProtocols, FileSource, ConfigSourceNotFoundError, ConfigFileNotFoundError, MemorySource, ConfigComponent };
+export { FileSource, ConfigSourceNotFoundError, ConfigFileNotFoundError, MemorySource, ConfigComponent };

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

@@ -3,7 +3,8 @@ import {
   resetUnderstandImageLLMProvider,
   setUnderstandImageLLMProvider,
   understandImageTool
-} from "./roy-agent-core-t7rw68q8.js";
+} from "./roy-agent-core-xwm8zavb.js";
+import"./roy-agent-core-zjdzk1gg.js";
 import"./roy-agent-core-fs0mn2jk.js";
 export {
   understandImageTool,

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

@@ -1,6 +1,6 @@
 import {
   understandImageTool
-} from "./roy-agent-core-t7rw68q8.js";
+} from "./roy-agent-core-xwm8zavb.js";
 import {
   queryBackgroundProcessTool
 } from "./roy-agent-core-amkqnyzy.js";

package/dist/shared/@ai-setting/{roy-agent-core-3dwcwgn5.js → roy-agent-core-q6mq7gmc.js}

@@ -1,22 +1,12 @@
 import {
   truncateOutputInline
-} from "./roy-agent-core-h28gcd77.js";
-import {
-  enqueueToAddFakeUserMessage
-} from "./roy-agent-core-t3yqzgse.js";
-import {
-  AskUserError,
-  init_workflow_hil
-} from "./roy-agent-core-e25xkv53.js";
+} from "./roy-agent-core-71wde8ce.js";
 import {
   AgentRegistry
 } from "./roy-agent-core-x0yztmm6.js";
 import {
-  getCurrentBgTaskId
-} from "./roy-agent-core-c1v263jn.js";
-import {
-  ContextError
-} from "./roy-agent-core-ctdhjv68.js";
+  enqueueToAddFakeUserMessage
+} from "./roy-agent-core-t3yqzgse.js";
 import {
   SessionMessageConverter
 } from "./roy-agent-core-zcx8nf4a.js";
@@ -24,6 +14,16 @@ import {
   safeParseToolArgs,
   withTimeout
 } from "./roy-agent-core-2xb3f3ye.js";
+import {
+  getCurrentBgTaskId
+} from "./roy-agent-core-c1v263jn.js";
+import {
+  AskUserError,
+  init_workflow_hil
+} from "./roy-agent-core-e25xkv53.js";
+import {
+  ContextError
+} from "./roy-agent-core-ctdhjv68.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";
@@ -585,7 +585,7 @@ class AgentComponent extends BaseComponent {
       this.toolComponent = tool ? tool : null;
       if (this.llmComponent) {
         try {
-          const mod = await import("./roy-agent-core-cy8azvpb.js");
+          const mod = await import("./roy-agent-core-krapd8x2.js");
           mod.setUnderstandImageLLMProvider(async (messages) => {
             const result = await this.llmComponent.invoke({
               messages,

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

@@ -1,7 +1,7 @@
 import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook
-} from "./roy-agent-core-gns3wa97.js";
+} from "./roy-agent-core-zhv8efqh.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";

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

@@ -0,0 +1,89 @@
+import {
+  parseImageInput
+} from "./roy-agent-core-zjdzk1gg.js";
+
+// src/env/tool/built-in/understand-image.ts
+import { z } from "zod";
+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 { setUnderstandImageLLMProvider, getUnderstandImageLLMProvider, resetUnderstandImageLLMProvider, understandImageTool };

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

@@ -1,6 +1,3 @@
-// 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";
@@ -15,6 +12,9 @@ function startsWith(buf, sig) {
   return true;
 }
 function sniffMimeType(buffer, fallbackName) {
+  return sniffMimeFromBuffer(buffer, fallbackName);
+}
+function sniffMimeFromBuffer(buffer, fallbackName) {
   if (startsWith(buffer, [137, 80, 78, 71, 13, 10, 26, 10])) {
     return "image/png";
   }
@@ -98,88 +98,38 @@ async function parseLocalImagePath(filePath) {
   }
   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 }
-      };
+function sniffImageMime(image, explicitMediaType) {
+  if (explicitMediaType && typeof explicitMediaType === "string" && explicitMediaType !== "image/*" && explicitMediaType.length > 0) {
+    return explicitMediaType;
+  }
+  if (typeof image === "string" && image.startsWith("data:")) {
+    const match = image.match(/^data:([^;,]+)/);
+    if (match && match[1]) {
+      return match[1];
     }
-    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 }
-      };
+  }
+  if (typeof image === "string" && /^https?:\/\//i.test(image)) {
+    const m = image.match(/\.([a-zA-Z0-9]+)(?:\?|$)/);
+    const ext = m?.[1]?.toLowerCase();
+    if (ext === "jpg" || ext === "jpeg")
+      return "image/jpeg";
+    if (ext === "png")
+      return "image/png";
+    if (ext === "gif")
+      return "image/gif";
+    if (ext === "webp")
+      return "image/webp";
+    if (ext === "bmp")
+      return "image/bmp";
+  }
+  if (image instanceof Uint8Array) {
+    const detected = sniffMimeFromBuffer(image);
+    if (detected && detected !== "application/octet-stream") {
+      return detected;
     }
-    return {
-      success: true,
-      output: responseText,
-      metadata: {
-        execution_time_ms: Date.now() - startTime
-      }
-    };
   }
-};
+  const desc = typeof image === "string" ? `URL "${image.slice(0, 60)}${image.length > 60 ? "..." : ""}"` : `buffer (${image.length} bytes, no recognized magic bytes)`;
+  throw new Error(`sniffImageMime: cannot determine image MIME from ${desc}. ` + `Provide an explicit mediaType (e.g. "image/jpeg") or use a data: URL with explicit MIME prefix.`);
+}
 
-export { ATTACH_FILE_MAX_BYTES, sniffMimeType, isMediaType, parseImageInput, setUnderstandImageLLMProvider, getUnderstandImageLLMProvider, resetUnderstandImageLLMProvider, understandImageTool };
+export { ATTACH_FILE_MAX_BYTES, sniffMimeType, isMediaType, parseImageInput, sniffImageMime };

package/package.json

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

package/dist/shared/@ai-setting/{roy-agent-core-50jdqb7r.js → roy-agent-core-2yt4jmzv.js}

@@ -2,6 +2,9 @@ import {
   ProcessRegistry,
   runWithProcessRegistryAsync
 } from "./roy-agent-core-mvs5sen6.js";
+import {
+  TaskHookPoints
+} from "./roy-agent-core-1pg0fepg.js";
 import {
   builtInPrompts
 } from "./roy-agent-core-skqt40yy.js";
@@ -11,9 +14,6 @@ import {
 import {
   runWithBgTaskIdAsync
 } from "./roy-agent-core-c1v263jn.js";
-import {
-  TaskHookPoints
-} from "./roy-agent-core-1pg0fepg.js";
 import {
   globalHookManager,
   init_global_hook_manager

package/dist/shared/@ai-setting/{roy-agent-core-3e0w0ekw.js → roy-agent-core-7xek618f.js}

@@ -1,11 +1,11 @@
-import {
-  getFromMapWithNormalization,
-  init_node_id_utils
-} from "./roy-agent-core-ddwa0n6h.js";
 import {
   DecoratorNode,
   init_decorator_node
 } from "./roy-agent-core-1ce3fqrk.js";
+import {
+  getFromMapWithNormalization,
+  init_node_id_utils
+} from "./roy-agent-core-ddwa0n6h.js";
 import {
   TracedAs,
   init_decorator

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

@@ -1,12 +1,12 @@
+import {
+  MemorySessionStore,
+  SQLiteSessionStore
+} from "./roy-agent-core-wgp3q62x.js";
 import {
   init_search_query_parser,
   matchesQuery,
   parseSearchQuery
 } from "./roy-agent-core-rvxg1wps.js";
-import {
-  MemorySessionStore,
-  SQLiteSessionStore
-} from "./roy-agent-core-wgp3q62x.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";

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

@@ -8,10 +8,6 @@ import {
   AgentComponentAdapter,
   init_agent_component_adapter
 } from "./roy-agent-core-ec4djnzd.js";
-import {
-  TemplateResolver,
-  init_template_resolver
-} from "./roy-agent-core-h1cb2jzh.js";
 import {
   PythonCallNode,
   SkillNode,
@@ -30,6 +26,10 @@ import {
   parseWorkflowJsonOutput,
   validateJsonOutputSchema
 } from "./roy-agent-core-1db4vpc6.js";
+import {
+  TemplateResolver,
+  init_template_resolver
+} from "./roy-agent-core-h1cb2jzh.js";
 import {
   DAGManager,
   init_dag_manager

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

@@ -1,6 +1,9 @@
 import {
-  BasePlugin
-} from "./roy-agent-core-az13yzmc.js";
+  TaskHookPoints
+} from "./roy-agent-core-1pg0fepg.js";
+import {
+  WORKFLOW_EXTRACT_PROMPT
+} from "./roy-agent-core-skqt40yy.js";
 import {
   validateWorkflowDefinition
 } from "./roy-agent-core-w8rv08d3.js";
@@ -8,11 +11,8 @@ import {
   enqueueToAddFakeUserMessage
 } from "./roy-agent-core-t3yqzgse.js";
 import {
-  WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-skqt40yy.js";
-import {
-  TaskHookPoints
-} from "./roy-agent-core-1pg0fepg.js";
+  BasePlugin
+} from "./roy-agent-core-az13yzmc.js";
 import {
   init_context
 } from "./roy-agent-core-h7ak839w.js";

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

@@ -1,14 +1,10 @@
+import {
+  adaptMcpTool
+} from "./roy-agent-core-dxfd6p1c.js";
 import {
   ComponentError,
   ErrorCodes
 } from "./roy-agent-core-ctdhjv68.js";
-import {
-  ensureFallbackNpmPrefix,
-  isUsableNpmPrefix
-} from "./roy-agent-core-fnv3ev18.js";
-import {
-  adaptMcpTool
-} from "./roy-agent-core-dxfd6p1c.js";
 import {
   toEnvKey
 } from "./roy-agent-core-7hh0brvs.js";
@@ -19,6 +15,10 @@ import {
   createLogger,
   init_logger
 } from "./roy-agent-core-kaq037np.js";
+import {
+  ensureFallbackNpmPrefix,
+  isUsableNpmPrefix
+} from "./roy-agent-core-fnv3ev18.js";
 
 // src/env/mcp/types.ts
 import { z } from "zod";