@myagentroam/agent 0.10.23 → 0.10.24

package/dist/agent-core/tools/code-mode/quickjs-engine.js

@@ -82,6 +82,10 @@ export async function createCodeModeEngine(options) {
                 const syntaxError = locateSource && error?.name === 'SyntaxError';
                 if (syntaxError)
                     message = `JavaScript compilation failed before tool execution: ${message}`.slice(0, 4096);
+                if (error?.name === 'ReferenceError' &&
+                    ["'text' is not defined", "'console' is not defined"].includes(message))
+                    message =
+                        `${message} Code Mode has no console or standalone text/image helpers; use observe.text(value) or observe.image(value).`.slice(0, 4096);
                 const location = locateSource ? compilerSourceLocation(error, input.code) : '';
                 if (location)
                     message = message.slice(0, 4096 - location.length) + location;
@@ -331,7 +335,7 @@ export async function createCodeModeEngine(options) {
                 }
                 if (kind === 'result')
                     return {
-                        error: guestError('MAR_AGENT_TOOL_INPUT_INVALID', 'observe.result requires an unmodified original tool result or error.')
+                        error: guestError('MAR_AGENT_TOOL_INPUT_INVALID', `observe.result requires an unmodified original tool result or error; received ${handle ? vm.typeof(handle) : 'undefined'}. Pass the awaited tools.NAME(...) result; use observe.text(value) for derived values.`)
                     };
                 // A standalone image is a value, never an original tool-result observation.
                 if (kind === 'image') {
@@ -634,11 +638,11 @@ function streamText(value, emit) {
         return;
     }
     const ancestors = new Set();
-    const write = (item, key) => {
+    const write = (item, key, path) => {
         if (item && typeof item === 'object' && typeof item.toJSON === 'function')
             item = item.toJSON(key);
         if (['bigint', 'function', 'symbol', 'undefined'].includes(typeof item))
-            throw Object.assign(new TypeError('Only JSON values may be emitted.'), {
+            throw Object.assign(new TypeError(`Only JSON values may be emitted; ${path} has type ${typeof item}. Omit optional fields or use null explicitly.`), {
                 code: 'MAR_AGENT_TOOL_INPUT_INVALID'
             });
         if (item instanceof Number || item instanceof String || item instanceof Boolean)
@@ -666,7 +670,7 @@ function streamText(value, emit) {
             for (let index = 0; index < length; index++) {
                 if (index)
                     emit(',');
-                write(item[index], String(index));
+                write(item[index], String(index), `${path}[${index}]`.slice(0, 256));
             }
             emit(']');
         }
@@ -689,13 +693,13 @@ function streamText(value, emit) {
                     (name === 'dataBase64' || (name === 'data' && item.type === 'image')) &&
                     typeof field === 'string'
                     ? '[image payload omitted; use observe.image]'
-                    : field, name);
+                    : field, name, `${path}[${JSON.stringify(name.slice(0, 64))}]`.slice(0, 256));
             }
             emit('}');
         }
         ancestors.delete(item);
     };
-    write(value, '');
+    write(value, '', '$');
 }
 function compilerSourceLocation(error, source) {
     if (error?.name !== 'SyntaxError' ||

package/dist/agent-core/tools/local/read.js

@@ -242,33 +242,34 @@ async function detectEncoding(path) {
     }
 }
 function parseReadInput(value) {
-    if (!value || typeof value !== 'object')
-        return invalidReadInput();
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return invalidReadInput('input', 'an object with a reads array');
     const input = value;
-    if (Object.keys(input).some((key) => key !== 'reads'))
-        return invalidReadInput();
     if (!Array.isArray(input.reads) ||
         input.reads.length === 0 ||
         input.reads.length > TOOL_EXECUTION_LIMITS.readMaxBatchItems)
-        return invalidReadInput();
+        return invalidReadInput('reads', `an array of 1 to ${TOOL_EXECUTION_LIMITS.readMaxBatchItems} requests`);
+    if (Object.keys(input).some((key) => key !== 'reads'))
+        return invalidReadInput('input', 'only the reads field; put path/offset/limit inside reads');
     return { reads: input.reads.map(parseReadRequest) };
 }
-function parseReadRequest(value) {
-    if (!value || typeof value !== 'object')
-        return invalidReadInput();
+function parseReadRequest(value, index) {
+    const field = `reads[${index}]`;
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return invalidReadInput(field, 'an object with path and optional offset/limit');
     const input = value;
     if (Object.keys(input).some((key) => !['path', 'offset', 'limit'].includes(key)))
-        return invalidReadInput();
+        return invalidReadInput(field, 'only path, offset and limit fields');
     if (typeof input.path !== 'string' || input.path === '')
-        return invalidReadInput();
+        return invalidReadInput(`${field}.path`, 'a non-empty string');
     if (input.offset !== undefined &&
         input.offset !== null &&
         (!Number.isInteger(input.offset) || input.offset < 1))
-        return invalidReadInput();
+        return invalidReadInput(`${field}.offset`, 'an integer >= 1');
     if (input.limit !== undefined &&
         input.limit !== null &&
         (!Number.isInteger(input.limit) || input.limit < 1))
-        return invalidReadInput();
+        return invalidReadInput(`${field}.limit`, 'an integer >= 1');
     return {
         path: input.path,
         ...(typeof input.offset === 'number' ? { offset: input.offset } : {}),
@@ -292,8 +293,8 @@ function readError(path, error) {
         : 'MAR_AGENT_TOOL_FAILED';
     return { path, error: { code, message: 'Unable to read file.' } };
 }
-function invalidReadInput() {
-    throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Read input is invalid.');
+function invalidReadInput(field, expected) {
+    throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', `${field}: expected ${expected}.`);
 }
 function escapeAttribute(value) {
     return value.replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('<', '&lt;');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/agent",
-  "version": "0.10.23",
+  "version": "0.10.24",
   "description": "Embeddable MAR coding agent SDK and CLI.",
   "license": "Apache-2.0",
   "type": "module",