@sema-agent/core 5.16.0 → 5.17.0

package/dist/tools/fs/fs-write.js

@@ -3,7 +3,7 @@ import { Type } from "typebox";
 import { defineTool, errorResult } from "../../core/tools.js";
 import { sha256, resolveKey, violationText, violationDetails, requireRead, checkStale, checkEditMatch, checkNoChange, fileArgPath, resolveQuoteMatch, adaptNewStringQuotes, resolveEscapeMatch, adaptNewStringEscapes, escapeMatchWasAttempted, ESCAPE_MATCH_MISS_NOTE, deletionOldString, countOccurrences, READ_REFUSED_ESCAPE_HINT, } from "./safety.js";
 import { decodeTextBytes, encodeTextForFile, normalizeEditText, normalizeFileText } from "./encoding.js";
-import { MAX_EDIT_BYTES, formatByteSize, decodeEditBytes, persistedTextOf, notReadRefusalText, enoentMessage, FILE_STATE_TRAILER, FILE_PATH_PARAMS, ipynbRedirect, countLines, } from "./fs-shared.js";
+import { MAX_EDIT_BYTES, decodeEditBytes, tooLargeToEditMessage, truncatedUtf16BodyMessage, persistedTextOf, notReadRefusalText, enoentMessage, FILE_STATE_TRAILER, FILE_PATH_PARAMS, ipynbRedirect, countLines, } from "./fs-shared.js";
 async function gateToolWrite(hook, tool, path, key, content) {
     if (hook === undefined)
         return undefined;
@@ -91,21 +91,21 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
             }
             const editInfo = await env.fileInfo(r.key, ctx.signal);
             if (editInfo.ok && editInfo.value.size > MAX_EDIT_BYTES) {
-                return errorResult(`Error (Edit): "${path}" is too large to edit (${formatByteSize(editInfo.value.size)}). Maximum editable file size is ${formatByteSize(MAX_EDIT_BYTES)}.`);
+                return errorResult(tooLargeToEditMessage(path, editInfo.value.size));
             }
             if (singleOld === "") {
                 const preBin = await env.readBinaryFile(r.key, ctx.signal);
                 if (!preBin.ok)
                     return errorResult(`Error (Edit): cannot read "${path}": ${preBin.error.message}`);
                 if (preBin.value.byteLength > MAX_EDIT_BYTES) {
-                    return errorResult(`Error (Edit): "${path}" is too large to edit (${formatByteSize(preBin.value.byteLength)}). Maximum editable file size is ${formatByteSize(MAX_EDIT_BYTES)}.`);
+                    return errorResult(tooLargeToEditMessage(path, preBin.value.byteLength));
                 }
                 const preDecResult = decodeEditBytes(preBin.value, path);
                 if (!preDecResult.ok)
                     return errorResult(preDecResult.message);
                 const preDec = preDecResult.value;
                 if (preDec.malformed)
-                    return errorResult(`Error (Edit): "${path}" has a truncated UTF-16 body; repair/convert it with bash first.`);
+                    return errorResult(truncatedUtf16BodyMessage("Edit", path));
                 if (preDec.text.trim() !== "")
                     return errorResult(`Error (Edit): Cannot create new file - file already exists.`);
                 const priorRead = state.get(r.key);
@@ -141,14 +141,14 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
             if (!readBin.ok)
                 return errorResult(`Error (Edit): cannot read "${path}": ${readBin.error.message}`);
             if (readBin.value.byteLength > MAX_EDIT_BYTES) {
-                return errorResult(`Error (Edit): "${path}" is too large to edit (${formatByteSize(readBin.value.byteLength)}). Maximum editable file size is ${formatByteSize(MAX_EDIT_BYTES)}.`);
+                return errorResult(tooLargeToEditMessage(path, readBin.value.byteLength));
             }
             const decodedResult = decodeEditBytes(readBin.value, path);
             if (!decodedResult.ok)
                 return errorResult(decodedResult.message);
             const decoded = decodedResult.value;
             if (decoded.malformed)
-                return errorResult(`Error (Edit): "${path}" has a truncated UTF-16 body; repair/convert it with bash first.`);
+                return errorResult(truncatedUtf16BodyMessage("Edit", path));
             const original = decoded.text;
             const entry = state.get(r.key);
             const readWasTruncated = entry?.truncated === true;
@@ -256,7 +256,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
                     return errorResult(`Error (Write): cannot re-read "${path}" to verify it is unchanged: ${readBin.error.message}`);
                 const decodedPrev = decodeTextBytes(readBin.value);
                 if (decodedPrev.malformed)
-                    return errorResult(`Error (Write): "${path}" has a truncated UTF-16 body; repair/convert it with bash first.`);
+                    return errorResult(truncatedUtf16BodyMessage("Write", path));
                 const stale = checkStale(state.get(r.key), sha256(decodedPrev.text));
                 if (stale)
                     return errorResult(violationText("Write", stale));
@@ -340,7 +340,7 @@ export function createNotebookEditTool(env, state, rootCanonical, cwdRef, additi
                 return errorResult(`Error (NotebookEdit): cannot read "${notebook_path}": ${readBin.error.message}`);
             const decodedNb = decodeTextBytes(readBin.value);
             if (decodedNb.malformed)
-                return errorResult(`Error (NotebookEdit): "${notebook_path}" has a truncated UTF-16 body; repair/convert it with bash first.`);
+                return errorResult(truncatedUtf16BodyMessage("NotebookEdit", notebook_path));
             const nbText = decodedNb.text;
             const stale = checkStale(state.get(r.key), sha256(nbText));
             if (stale)

package/dist/tools/fs/index.d.ts

@@ -34,6 +34,7 @@ export interface HandsToolkitOptions {
     autoBackgroundOnTimeout?: boolean;
     readImageDownsampler?: ReadImageDownsamplerOption;
     pdfModelCapabilities?: PdfModelCapabilities;
+    readCyberReminder?: boolean;
     beforeWrite?: BeforeWriteHook;
     monitorToolActive?: boolean;
 }

package/dist/tools/fs/index.js

@@ -30,7 +30,7 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
             ...(opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {}),
         }, env);
     const tools = [
-        createReadFileTool(env, readFileState, rootCanonical, readOnly ? undefined : cwdRef, readFaceRoots, opts.readImageDownsampler, opts.pdfModelCapabilities, bgOutputReadExemption),
+        createReadFileTool(env, readFileState, rootCanonical, readOnly ? undefined : cwdRef, readFaceRoots, opts.readImageDownsampler, opts.pdfModelCapabilities, bgOutputReadExemption, opts.readCyberReminder),
     ];
     if (!readOnly) {
         tools.push(createEditFileTool(env, readFileState, rootCanonical, cwdRef, additionalRoots, opts.beforeWrite), createWriteFileTool(env, readFileState, rootCanonical, cwdRef, additionalRoots, opts.beforeWrite), createNotebookEditTool(env, readFileState, rootCanonical, cwdRef, additionalRoots, opts.beforeWrite));

package/dist/tools/fs/safety.d.ts

@@ -82,4 +82,5 @@ export declare function escapeMatchWasAttempted(oldString: string): boolean;
 export declare const ESCAPE_MATCH_MISS_NOTE = "\n(note: Edit also tried swapping \\uXXXX escapes and their characters; neither form matched, so the mismatch is likely elsewhere in old_string. Re-read the file and copy the exact surrounding text.)";
 export declare function adaptNewStringQuotes(matchedOld: string, newString: string): string;
 export declare function deletionOldString(content: string, oldString: string, newString: string): string;
+export declare const EDIT_ECHO_MAX_CHARS = 200;
 export declare function checkEditMatch(content: string, oldString: string, replaceAll: boolean, truncated: boolean): FsViolation | undefined;

package/dist/tools/fs/safety.js

@@ -1,4 +1,5 @@
 import { createHash } from "node:crypto";
+import { sliceHeadSafe } from "../../core/surrogate-safe-slice.js";
 export function fileArgPath(args) {
     const a = args;
     const fp = a?.file_path;
@@ -577,6 +578,12 @@ export function deletionOldString(content, oldString, newString) {
         return oldString + "\n";
     return oldString;
 }
+export const EDIT_ECHO_MAX_CHARS = 200;
+function boundEditEcho(oldString) {
+    if (oldString.length <= EDIT_ECHO_MAX_CHARS)
+        return oldString;
+    return `${sliceHeadSafe(oldString, EDIT_ECHO_MAX_CHARS)}… (truncated)`;
+}
 export function checkEditMatch(content, oldString, replaceAll, truncated) {
     if (oldString === "") {
         return { code: "invalid", message: "old_string must not be empty." };
@@ -585,13 +592,13 @@ export function checkEditMatch(content, oldString, replaceAll, truncated) {
     if (n === 0) {
         return {
             code: "ambiguous_edit",
-            message: `String to replace not found in file.${truncated ? " (note: the read was truncated — it may be in the unshown portion)" : ""}\nString: ${oldString}`,
+            message: `String to replace not found in file.${truncated ? " (note: the read was truncated — it may be in the unshown portion)" : ""}\nString: ${boundEditEcho(oldString)}`,
         };
     }
     if (n > 1 && !replaceAll) {
         return {
             code: "ambiguous_edit",
-            message: `Found ${n} matches of the string to replace, but replace_all is false. To replace all occurrences, set replace_all to true. To replace only one occurrence, please provide more context to uniquely identify the instance.${truncated ? " (the read was truncated; some matches may be in the unshown portion)" : ""}\nString: ${oldString}`,
+            message: `Found ${n} matches of the string to replace, but replace_all is false. To replace all occurrences, set replace_all to true. To replace only one occurrence, please provide more context to uniquely identify the instance.${truncated ? " (the read was truncated; some matches may be in the unshown portion)" : ""}\nString: ${boundEditEcho(oldString)}`,
         };
     }
     return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/core",
-  "version": "5.16.0",
+  "version": "5.17.0",
   "description": "Stateless, task-oriented AI agent core",
   "type": "module",
   "license": "BUSL-1.1",