@sema-agent/core 2.3.0 → 2.4.0

package/dist/tools/web.js

@@ -594,7 +594,7 @@ function classifySearchFailure(message) {
     if (code === 408 || /\btimed? ?out\b|\betimedout\b/.test(m)) {
         return { retryable: true, hint: "This looks like a timeout — a retry may succeed; a narrower query tends to return faster." };
     }
-    if (/\becconnrefused\b|\benotfound\b|\beai_again\b|\becconnreset\b|\bepipe\b|\bfetch failed\b|socket hang up|\bnetwork\b|\bdns\b/.test(m)) {
+    if (/\beconnrefused\b|\benotfound\b|\beai_again\b|\beconnreset\b|\bepipe\b|\bfetch failed\b|socket hang up|\bnetwork\b|\bdns\b/.test(m)) {
         return { retryable: true, hint: "This is a network/transport fault, not a rejection of the query — one retry is reasonable; if it repeats, treat the search backend as unavailable and continue without it." };
     }
     if (code !== undefined && code >= 500 && code <= 599) {
@@ -751,6 +751,7 @@ export function createWebSearchTool(config) {
             const domainFiltered = usable.filter((r) => webSearchResultAllowed(r.url, allowed_domains, blocked_domains));
             const droppedByDomain = usable.length - domainFiltered.length;
             const kept = domainFiltered.slice(0, max);
+            const droppedByMax = domainFiltered.length - kept.length;
             const schemeAssumed = kept.filter((r) => r.schemeAssumed).length;
             let clipped = false;
             const shown = kept.map((r) => {
@@ -771,6 +772,9 @@ export function createWebSearchTool(config) {
             const domainNote = droppedByDomain > 0
                 ? `\n\n[WebSearch: ${droppedByDomain} result(s) were dropped by the ${allowed_domains?.length ? "allowed_domains" : "blocked_domains"} filter passed with this call — the backend returned them, this tool removed them. Relax or drop the filter to see them.]`
                 : "";
+            const maxResultsNote = droppedByMax > 0
+                ? `\n\n[WebSearch: showing ${kept.length} of ${domainFiltered.length} results — the rest were cut off by this deployment's maxResults limit (${max}).]`
+                : "";
             const clipNote = clipped
                 ? "\n\n[WebSearch: one or more result fields exceeded the display limits and were truncated — treat the text above as an excerpt, not the backend's full result.]"
                 : "";
@@ -780,7 +784,7 @@ export function createWebSearchTool(config) {
             const tailReminder = shown.length > 0
                 ? "REMINDER: You MUST include the sources above in your response to the user using markdown hyperlinks."
                 : "REMINDER: this search returned ZERO usable sources — there is nothing above to cite. Do not fabricate sources, URLs or citations; tell the user the search returned no usable results (the notes above say why, when there is a why) and answer from what you already know, or try a different query.";
-            const modelText = `${fenced}${dropNote}${domainNote}${schemeNote}${clipNote}\n\n${tailReminder}`;
+            const modelText = `${fenced}${dropNote}${domainNote}${maxResultsNote}${schemeNote}${clipNote}\n\n${tailReminder}`;
             return {
                 content: modelText,
                 details: {

package/dist/tools/worktree.js

@@ -164,11 +164,14 @@ export function createWorktreeTools(env, opts) {
                 const originalCwd = previous ? previous.originalCwd : cwdRef.current;
                 session.current = { worktreeDir: target, originalCwd, baseSha: head.value.stdout.trim(), entered: true };
                 cwdRef.current = target;
-                return (`Switched into the existing worktree at ${target}${previous ? ` (the previous worktree at ${previous.worktreeDir} was left on disk, untouched)` : ""}. ` +
-                    "The session's working directory is now this worktree — subsequent commands and relative paths " +
-                    "operate there. Note this is a cwd switch, not a sandbox: file containment stays anchored at the " +
-                    "task root. ExitWorktree will restore the original directory but will NOT remove a worktree " +
-                    "entered via `path`.");
+                return {
+                    content: `Switched into the existing worktree at ${target}${previous ? ` (the previous worktree at ${previous.worktreeDir} was left on disk, untouched)` : ""}. ` +
+                        "The session's working directory is now this worktree — subsequent commands and relative paths " +
+                        "operate there. Note this is a cwd switch, not a sandbox: file containment stays anchored at the " +
+                        "task root. ExitWorktree will restore the original directory but will NOT remove a worktree " +
+                        "entered via `path`.",
+                    details: { type: "worktree", action: "enter", worktreeDir: target },
+                };
             }
             const base = await resolveBaseCommit(env, repoRoot, baseRef ?? "fresh");
             if ("error" in base)
@@ -195,11 +198,14 @@ export function createWorktreeTools(env, opts) {
                 baseSha: base.sha,
             };
             cwdRef.current = createdDir;
-            return (`Created worktree at ${createdDir} (base: ${base.label}${base.note ?? ""}). ` +
-                "The session's working directory is now the worktree — subsequent commands and relative paths " +
-                "operate there. Note this is a cwd switch, not a sandbox: file containment stays anchored at the " +
-                "task root, so the rest of the repository remains reachable. " +
-                "Use ExitWorktree to leave (an unchanged worktree is removed; a changed one is kept).");
+            return {
+                content: `Created worktree at ${createdDir} (base: ${base.label}${base.note ?? ""}). ` +
+                    "The session's working directory is now the worktree — subsequent commands and relative paths " +
+                    "operate there. Note this is a cwd switch, not a sandbox: file containment stays anchored at the " +
+                    "task root, so the rest of the repository remains reachable. " +
+                    "Use ExitWorktree to leave (an unchanged worktree is removed; a changed one is kept).",
+                details: { type: "worktree", action: "create", worktreeDir: createdDir, base: base.label },
+            };
         },
     });
     const exit = defineTool({
@@ -245,16 +251,22 @@ export function createWorktreeTools(env, opts) {
             cwdRef.current = restoredTo;
             if (active.entered) {
                 const discardNote = discardChanges === true ? " (`discardChanges` does not apply to a worktree this session did not create)" : "";
-                return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
-                    `The worktree at ${active.worktreeDir} was entered via \`path\` (not created by this session) and ` +
-                    `was left on disk, untouched${discardNote}.`);
+                return {
+                    content: `Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                        `The worktree at ${active.worktreeDir} was entered via \`path\` (not created by this session) and ` +
+                        `was left on disk, untouched${discardNote}.`,
+                    details: { type: "worktree", action: "exit", worktreeDir: active.worktreeDir, kept: true },
+                };
             }
             const wtThere = await env.exists(active.worktreeDir);
             if (wtThere.ok && !wtThere.value) {
                 await pruneWorktrees(env, repoRoot).catch(() => undefined);
-                return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
-                    `The worktree at ${active.worktreeDir} was already gone from disk (removed externally, not by this ` +
-                    "session — any uncommitted work in it is lost); stale git worktree metadata was pruned.");
+                return {
+                    content: `Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                        `The worktree at ${active.worktreeDir} was already gone from disk (removed externally, not by this ` +
+                        "session — any uncommitted work in it is lost); stale git worktree metadata was pruned.",
+                    details: { type: "worktree", action: "exit", worktreeDir: active.worktreeDir, kept: false },
+                };
             }
             let changed = true;
             let changeDetail = "could not verify the worktree state — keeping it to be safe";
@@ -278,10 +290,13 @@ export function createWorktreeTools(env, opts) {
                 const removeHint = wantsRemove && keep !== true
                     ? " To remove it anyway and permanently discard these changes, re-invoke with discard_changes: true."
                     : "";
-                return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
-                    `The worktree was KEPT at ${active.worktreeDir} (${why}) — inspect or merge it there, and remove it ` +
-                    "later with `git worktree remove` if no longer needed." +
-                    removeHint);
+                return {
+                    content: `Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                        `The worktree was KEPT at ${active.worktreeDir} (${why}) — inspect or merge it there, and remove it ` +
+                        "later with `git worktree remove` if no longer needed." +
+                        removeHint,
+                    details: { type: "worktree", action: "exit", worktreeDir: active.worktreeDir, kept: true },
+                };
             }
             await env.exec(`git worktree remove --force ${shq(active.worktreeDir)}`, { cwd: repoRoot }).catch(() => undefined);
             await pruneWorktrees(env, repoRoot).catch(() => undefined);
@@ -291,12 +306,18 @@ export function createWorktreeTools(env, opts) {
                 : changeDetail;
             const stateClause = changed ? `had ${detailForDiscard} (discarded — discardChanges was set)` : "had no changes";
             if (stillThere.ok && stillThere.value) {
-                return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
-                    `The worktree at ${active.worktreeDir} ${changed ? "was marked for discard" : "had no changes"} but could NOT be removed — it is still on disk; ` +
-                    "remove it manually with `git worktree remove --force` if no longer needed.");
+                return {
+                    content: `Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                        `The worktree at ${active.worktreeDir} ${changed ? "was marked for discard" : "had no changes"} but could NOT be removed — it is still on disk; ` +
+                        "remove it manually with `git worktree remove --force` if no longer needed.",
+                    details: { type: "worktree", action: "exit", worktreeDir: active.worktreeDir, kept: true },
+                };
             }
-            return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
-                `The worktree at ${active.worktreeDir} ${stateClause} and was removed.`);
+            return {
+                content: `Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                    `The worktree at ${active.worktreeDir} ${stateClause} and was removed.`,
+                details: { type: "worktree", action: "exit", worktreeDir: active.worktreeDir, kept: false },
+            };
         },
     });
     return [enter, exit];

package/package.json

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