nolo-cli 0.13.0 → 0.14.0-alpha.2

package/{chunk-MZHSAPZP.js → chunk-2Q5FTOQA.js}

@@ -19,7 +19,7 @@ import {
   readPageFunc,
   readPageFunctionSchema,
   slateToSimplifiedMarkdown
-} from "./chunk-IVAOVLM7.js";
+} from "./chunk-BOJVWKNA.js";
 import {
   markdownToSlate
 } from "./chunk-3LY4F7SV.js";
@@ -34,10 +34,10 @@ import {
 } from "./chunk-VF4K2QE6.js";
 import {
   createDocState
-} from "./chunk-TQYYGE6G.js";
+} from "./chunk-XBZL4SGS.js";
 import {
   createDialogAction
-} from "./chunk-2BVGERJ2.js";
+} from "./chunk-VFGBWVXO.js";
 import {
   buildSkillDocMarkdown,
   normalizeSkillBudgetTier,
@@ -76,13 +76,13 @@ import {
   updateContentCategory,
   updateContentTitle,
   updateStep
-} from "./chunk-FSUZIGIG.js";
+} from "./chunk-LVJFD5HS.js";
 import {
   createAgent,
   runLlm,
   streamAgentChatTurn,
   updateAgent
-} from "./chunk-Y5P3ZRGC.js";
+} from "./chunk-CPGQAMHA.js";
 import {
   NOLO_WORKSPACE_TOOL_NAMES,
   buildNoloSubjectRefQueryTarget,
@@ -101,7 +101,7 @@ import {
 } from "./chunk-B4KT7RN2.js";
 import {
   buildDatabaseFileContentUrl
-} from "./chunk-JFANOO7I.js";
+} from "./chunk-3B2LFO6R.js";
 import {
   DEFAULT_MODEL
 } from "./chunk-OGGHETUE.js";
@@ -122,22 +122,24 @@ import {
   selectCurrentDialogKey,
   selectPendingRawDataByPageKey
 } from "./chunk-3ASDTTEI.js";
-import {
-  toErrorMessage
-} from "./chunk-HNMXYYJR.js";
 import {
   compactWhitespace
 } from "./chunk-DWLEOOGR.js";
+import {
+  toErrorMessage
+} from "./chunk-HNMXYYJR.js";
 import {
   shareResourceAction
-} from "./chunk-DPFWKRHG.js";
+} from "./chunk-BHK5ZAW7.js";
 import {
   AGENT_UPDATE_FIELD_NAMES,
+  SYSTEM_AGENT_CAPABILITIES,
+  SYSTEM_AGENT_CAPABILITY_IDS,
   normalizeAgentUpdateFieldList,
   selectAutoApproveSelfUpdateFields,
   selectCurrentServer,
   selectSyncServers
-} from "./chunk-JU7J7EAV.js";
+} from "./chunk-S5UACFUP.js";
 import {
   asRecordOrEmpty
 } from "./chunk-KX6YBIHG.js";
@@ -145,7 +147,7 @@ import {
   addContentAction,
   createSpaceKey,
   normalizeSpaceId
-} from "./chunk-WVTBAALN.js";
+} from "./chunk-3FCSMQAC.js";
 import {
   patch,
   read,
@@ -153,7 +155,7 @@ import {
   readAndWaitAction,
   toTimestampMs,
   write
-} from "./chunk-VKG4HXYV.js";
+} from "./chunk-A5V7UEZJ.js";
 import {
   SEPARATOR,
   createAgentKey,
@@ -178,7 +180,7 @@ import {
 } from "./chunk-QSJ3HFEF.js";
 import {
   readAction
-} from "./chunk-XHQWJUW4.js";
+} from "./chunk-NJVPXLRY.js";
 import {
   createAsyncThunk,
   getRuntimeServerContext,
@@ -186,16 +188,16 @@ import {
   selectIdentityToken,
   selectIdentityUserId,
   selectRuntimeSnapshot
-} from "./chunk-TSUJOM6N.js";
+} from "./chunk-DVRHHFEA.js";
 import {
   isAbortError
 } from "./chunk-OOSFSFMA.js";
-import {
-  isRecord
-} from "./chunk-KUG52IAP.js";
 import {
   asTrimmedString
 } from "./chunk-3EUW3WEO.js";
+import {
+  isRecord
+} from "./chunk-KUG52IAP.js";
 import {
   API_ENDPOINTS
 } from "./chunk-LCBAMY2M.js";
@@ -11211,15 +11213,9 @@ var TOOL_PACKS = {
     "fetchWebpage"
   ]
 };
+var SYSTEM_AGENT_CAPABILITY_PACKS = SYSTEM_AGENT_CAPABILITIES.map((capability) => ({ ...capability }));
 var CAPABILITY_PACKS = [
-  {
-    id: "web-search",
-    label: "\u8054\u7F51\u641C\u7D22",
-    description: "\u8BA9 agent \u80FD\u641C\u7D22\u4E92\u8054\u7F51\u3001\u6293\u53D6\u7F51\u9875\u5185\u5BB9\uFF0C\u83B7\u53D6\u6700\u65B0\u4FE1\u606F\u3002",
-    tools: ["exa_search", "fetchWebpage"],
-    defaultEnabled: true,
-    icon: "\u{1F310}"
-  },
+  ...SYSTEM_AGENT_CAPABILITY_PACKS,
   {
     id: "long-term-memory",
     label: "\u957F\u671F\u8BB0\u5FC6",
@@ -11367,6 +11363,20 @@ var PACK_MANAGED_TOOLS = new Set(
 var DEFAULT_ENABLED_PACKS = CAPABILITY_PACKS.filter(
   (pack) => pack.defaultEnabled
 ).map((pack) => pack.id);
+var SYSTEM_BUILTIN_SKILL_PACK_IDS = SYSTEM_AGENT_CAPABILITY_IDS;
+function applySystemBuiltinSkillFilter(toolNames, systemBuiltinSkills) {
+  if (!systemBuiltinSkills) return toolNames;
+  const disabledToolSet = /* @__PURE__ */ new Set();
+  for (const packId of SYSTEM_BUILTIN_SKILL_PACK_IDS) {
+    const enabled = systemBuiltinSkills[packId];
+    if (enabled === false) {
+      const pack = CAPABILITY_PACK_BY_ID[packId];
+      if (pack) pack.tools.forEach((t) => disabledToolSet.add(t));
+    }
+  }
+  if (disabledToolSet.size === 0) return toolNames;
+  return toolNames.filter((t) => !disabledToolSet.has(t));
+}
 function expandEnabledPacks(enabledPacks, explicitTools = []) {
   const packTools = (enabledPacks ?? []).map((id) => CAPABILITY_PACK_BY_ID[id]?.tools ?? []).flat();
   return [.../* @__PURE__ */ new Set([...packTools, ...explicitTools ?? []])];
@@ -14104,7 +14114,7 @@ async function deleteDialogsFunc(args, thunkApi) {
   const deletedDialogIds = [];
   const deletedDialogKeys = [];
   const failures = [];
-  const { deleteDialog } = await import("./dialogSlice-35LA3ZRG.js");
+  const { deleteDialog } = await import("./dialogSlice-VNKDTTHR.js");
   for (const target of targets) {
     try {
       await thunkApi.dispatch(deleteDialog(target.dbKey)).unwrap();
@@ -14368,7 +14378,7 @@ var readSkillDocFunctionSchema = {
   }
 };
 async function readSkillDocFunc(args, thunkApi) {
-  const { buildReadDocResult } = await import("./readDocTool-QHVGQHUJ.js");
+  const { buildReadDocResult } = await import("./readDocTool-TCYJY4PP.js");
   const id = args?.id ?? args?.doc ?? args?.docKey ?? args?.pageKey;
   if (typeof id !== "string" || !id.trim()) {
     throw new Error("readSkillDoc requires id or doc.");
@@ -19756,7 +19766,7 @@ var selectUserIdFromState = (state) => typeof state?.auth?.currentUser?.userId =
 var selectCurrentServerFromState = (state) => typeof state?.settings?.currentServer === "string" ? state.settings.currentServer : null;
 async function addImageContentToSpace(input) {
   const injectedAddContentAction = input.thunkApi?.extra?.addContentAction;
-  const addContentAction2 = typeof injectedAddContentAction === "function" ? injectedAddContentAction : (await import("./addContentAction-JGBUVR7K.js")).addContentAction;
+  const addContentAction2 = typeof injectedAddContentAction === "function" ? injectedAddContentAction : (await import("./addContentAction-4Z762DMR.js")).addContentAction;
   await addContentAction2(
     {
       spaceId: input.spaceId,
@@ -20498,19 +20508,20 @@ var remotionRenderVideoFunc = async (args, thunkApi) => {
   };
 };
 
-// packages/ai/tools/rememberMemoryTool.ts
+// packages/ai/tools/rememberMemoryToolSchema.ts
 var rememberMemoryFunctionSchema = {
   name: "rememberMemory",
   description: [
-    "\u5F53\u4F60\u5224\u65AD\u67D0\u6761\u7528\u6237\u504F\u597D\u3001\u7EA0\u6B63\u3001\u51B3\u7B56\u4E60\u60EF\u6216\u5F53\u524D Space \u5171\u8BC6\u503C\u5F97\u88AB\u957F\u671F\u8BB0\u4F4F\u65F6\uFF0C\u8C03\u7528\u672C\u5DE5\u5177\u5199\u5165\u4E00\u6761 memory\u3002",
-    "\u9ED8\u8BA4\u5148\u8BB0\u539F\u59CB\u4E8B\u4EF6\uFF0C\u4E0D\u8981\u628A\u4E00\u6B21\u6027\u4E34\u65F6\u8981\u6C42\u3001\u5F53\u524D\u4EFB\u52A1\u8FDB\u5EA6\u6216\u660E\u663E\u77ED\u671F\u4FE1\u606F\u5199\u8FDB\u53BB\u3002",
+    "\u628A\u503C\u5F97\u957F\u671F\u8BB0\u4F4F\u7684\u7528\u6237\u504F\u597D\u3001\u7EA0\u6B63\u3001\u51B3\u7B56\u4E60\u60EF\u6216\u5F53\u524D Space \u5171\u8BC6\u5199\u6210\u4E00\u6761 memory\u3002",
+    "\u9ED8\u8BA4\u503E\u5411\u4E8E\u8BB0\uFF1A\u7528\u6237\u8BF4\u51FA\u300C\u8BB0\u4F4F/\u8BB0\u5F97/\u522B\u5FD8\u4E86/\u4EE5\u540E\u90FD/\u522B\u518D/\u6211\u559C\u6B22/\u6211\u4E0D\u559C\u6B22/\u4E0B\u6B21\u300D\u8FD9\u7C7B\u8BDD\u65F6\uFF0C\u9ED8\u8BA4\u5C31\u8C03\u7528\u672C\u5DE5\u5177\uFF0C\u4E0D\u8981\u53CD\u590D\u81EA\u95EE\u662F\u5426\u591F\u683C\u3002",
+    "\u4ECD\u7136\u4E0D\u8981\u8BB0\uFF1A\u4E00\u6B21\u6027\u4EFB\u52A1\u7EC6\u8282\u3001\u5F53\u524D\u4EFB\u52A1\u8FDB\u5EA6\u3001\u5F88\u5FEB\u8FC7\u671F\u7684\u4E8B\u5B9E\u3002",
     "\u53EA\u6709\u91CD\u590D\u51FA\u73B0\u7684\u53EF\u6267\u884C\u6D41\u7A0B/\u6392\u969C\u6B65\u9AA4\u624D\u4F20 kind=procedural\uFF1B\u4E00\u822C\u504F\u597D\u548C\u4E8B\u5B9E\u4FDD\u6301\u9ED8\u8BA4 episodic\u3002",
     "scope \u6309\u5185\u5BB9\u6027\u8D28\u9009\uFF0C\u4E0D\u56FA\u5B9A\u4F18\u5148\u67D0\u4E00\u5C42\uFF1A",
     "  - Space \u534F\u4F5C\u7EA6\u5B9A/\u56E2\u961F\u89C4\u5219 \u2192 scope=space\uFF08\u5F53\u524D dialog \u7ED1\u5B9A space \u65F6\uFF09",
     "  - \u7528\u6237\u4E2A\u4EBA\u8EAB\u4EFD\u6216\u7EAF\u4E2A\u4EBA\u504F\u597D \u2192 scope=auto\uFF08\u9ED8\u8BA4\u8BB0\u5230\u7528\u6237\uFF09",
     "  - \u4E0E\u5F53\u524D Agent \u6302\u94A9\u7684\u6709\u6548\u505A\u6CD5 \u2192 scope=auto\uFF08runtime \u81EA\u52A8\u628A subject \u6807\u8BB0\u4E3A\u5F53\u524D Agent\uFF09",
     "  - \u5F53\u524D\u4EFB\u52A1\u7684\u4E34\u65F6\u8FDB\u5EA6 \u2192 \u4E0D\u8981\u8C03\u7528\uFF0C\u8D70\u5BF9\u8BDD\u4E0A\u4E0B\u6587",
-    "\u4F18\u5148\u5199\u6210\u4E00\u53E5\u7B80\u6D01\u3001\u672A\u6765\u4ECD\u53EF\u7406\u89E3\u7684\u8BDD\uFF1B\u5982\u65E0\u5FC5\u8981\uFF0C\u4E0D\u8981\u9891\u7E41\u8C03\u7528\u3002"
+    "\u5199\u6210\u4E00\u53E5\u7B80\u6D01\u3001\u672A\u6765\u4ECD\u53EF\u7406\u89E3\u7684\u8BDD\u3002\u9ED8\u8BA4\u9759\u9ED8\u6267\u884C\uFF0C\u4E0D\u7528\u5411\u7528\u6237\u6C47\u62A5\u5DF2\u8BB0\u4F4F\u3002"
   ].join("\n"),
   parameters: {
     type: "object",
@@ -20533,6 +20544,8 @@ var rememberMemoryFunctionSchema = {
     required: ["content"]
   }
 };
+
+// packages/ai/tools/rememberMemoryTool.ts
 async function rememberMemoryFunc(args, thunkApi) {
   const state = thunkApi.getState();
   const spaceId = selectCurrentSpaceId(state) || void 0;
@@ -23241,7 +23254,7 @@ var executeToolRun = createAsyncThunk(
     if (!executionInput) {
       throw new Error(`ToolRun ${id} has no input to execute with.`);
     }
-    const { findToolExecutor: findToolExecutor2 } = await import("./tools-TPQYTLQZ.js");
+    const { findToolExecutor: findToolExecutor2 } = await import("./tools-MWNK4RKM.js");
     const { executor } = findToolExecutor2(run.toolName);
     toolRunStarted({
       id: run.id,
@@ -23265,7 +23278,7 @@ var executeToolRun = createAsyncThunk(
         const latestState = thunkApi.getState();
         const userId = latestState.auth?.currentUser?.userId;
         if (userId) {
-          const { fetchUserSpaceMemberships } = await import("./spaceSlice-WTFNKOVA.js");
+          const { fetchUserSpaceMemberships } = await import("./spaceSlice-6PZEMRZM.js");
           await thunkApi.dispatch(fetchUserSpaceMemberships(userId));
         }
       }
@@ -25668,7 +25681,7 @@ async function updateDocFunc(args, thunkApi) {
       updated_at: (/* @__PURE__ */ new Date()).toISOString()
     };
     await dispatch(write({ data: updatedPageData, customKey: id })).unwrap();
-    const { getDocState, applyExternalDocUpdate } = await import("./docStore-3CP2IO6M.js");
+    const { getDocState, applyExternalDocUpdate } = await import("./docStore-W4KEEPCW.js");
     if (getDocState().pageKey === id) {
       applyExternalDocUpdate({
         slateData: finalSlateData,
@@ -25693,7 +25706,7 @@ async function updateDocFunc(args, thunkApi) {
 // packages/ai/tools/updateUserPreferenceProfileTool.ts
 async function dispatchSetSettings(thunkApi, changes) {
   const injectedSetSettings = thunkApi?.extra?.setSettings;
-  const setSettings = typeof injectedSetSettings === "function" ? injectedSetSettings : (await import("./settingSlice-VGRJUSE5.js")).setSettings;
+  const setSettings = typeof injectedSetSettings === "function" ? injectedSetSettings : (await import("./settingSlice-FTWZ5ZHT.js")).setSettings;
   await thunkApi.dispatch(setSettings(changes)).unwrap();
 }
 var updateUserPreferenceProfileFunctionSchema = {
@@ -27905,6 +27918,7 @@ export {
   formatNotFoundRunCard,
   isAgentRunTerminalStatus,
   TOOL_PACKS,
+  applySystemBuiltinSkillFilter,
   expandEnabledPacks,
   expandEnabledPackPromptPatches,
   appendEnabledPackPromptPatches,
@@ -27926,6 +27940,7 @@ export {
   waitForAbortableDelay,
   createSSEParser,
   formatAgentListCard,
+  rememberMemoryFunctionSchema,
   TOOL_GROUP_META,
   toolQueryFunctionSchema,
   toolQueryFunc,

package/{chunk-MG6BVV3T.js → chunk-33K5FKRL.js}

@@ -4,10 +4,10 @@ import {
   providerHttpFailure,
   readSseFrames,
   throwIfChatCompletionStreamFailed
-} from "./chunk-5S4SWV5G.js";
+} from "./chunk-PB2DHBEQ.js";
 import {
   parseToolArgumentsJson
-} from "./chunk-TA7VKOHU.js";
+} from "./chunk-VQFY3VXW.js";
 import {
   createThinkParserState,
   createToolCallAccumulator,
@@ -17,12 +17,12 @@ import {
 import {
   requiresBareImageUrl,
   toBareImageUrlMessages
-} from "./chunk-LUKQQJFL.js";
+} from "./chunk-UW3WOIWJ.js";
 import {
   buildProviderAuthHeaders,
   buildProviderExecutionPlan,
   toOpenAiCompatibleMessages
-} from "./chunk-TYPHUVK5.js";
+} from "./chunk-KTFJUPDW.js";
 import {
   canonicalizeToolName,
   createGlob,
@@ -46,15 +46,15 @@ import {
 import {
   asTrimmedLowercaseString
 } from "./chunk-QSJ3HFEF.js";
-import {
-  isRecord
-} from "./chunk-KUG52IAP.js";
 import {
   asTrimmedString
 } from "./chunk-3EUW3WEO.js";
 import {
   asOptionalPositiveFiniteNumber
 } from "./chunk-U6VC4MU4.js";
+import {
+  isRecord
+} from "./chunk-KUG52IAP.js";
 import {
   normalizeServerOrigin
 } from "./chunk-CF7PE763.js";
@@ -1225,30 +1225,18 @@ function buildReadWorkspaceDescription(variant) {
     return "Read a UTF-8 text file inside the workspace.";
   }
   if (variant === "workflow") {
-    return "Read a UTF-8 text file inside the workspace after listFiles, globFiles, or searchFiles has narrowed the target. Use line ranges from searchFiles matches and tailLines for logs or generated output. Read the whole file only when the task truly needs all content or exact edit context.";
+    return 'Read a UTF-8 text file inside the workspace after listFiles, globFiles, or searchFiles has narrowed the target. Use lines with a range from searchFiles matches, or lines: "-50" for logs and generated output. Read the whole file only when the task truly needs all content or exact edit context.';
   }
   if (variant === "antiShell") {
     return "Read a UTF-8 text file inside the workspace. Do not use execShell with cat/sed/head/tail for normal text reads when readFile can return the needed file or line range. Use searchFiles first for content search, then readFile only the relevant lines when possible.";
   }
-  return "Read a UTF-8 text file inside the workspace. Read before editing when you need exact text for editFile. For discovery or classification tasks, avoid batch-reading every candidate; report candidate paths first, or read only one to three representative files with maxLines or focused line ranges. Use line ranges for large code, docs, data, configs, and logs after searchFiles returns line numbers. Read the whole file only when the task truly needs all content or exact edit context.";
+  return "Read a UTF-8 text file inside the workspace. Read before editing when you need exact text for editFile. For discovery or classification tasks, avoid batch-reading every candidate; report candidate paths first, or read only one to three representative files with a small lines count. Use lines ranges for large code, docs, data, configs, and logs after searchFiles returns line numbers. Read the whole file only when the task truly needs all content or exact edit context.";
 }
 function buildReadWorkspaceParameters(variant) {
   const path = buildWorkspacePathProperty();
-  const startLine = {
-    type: "integer",
-    description: "1-based first line to return. Use with endLine or maxLines after searchFiles gives a line number."
-  };
-  const endLine = {
-    type: "integer",
-    description: "1-based last line to return, inclusive."
-  };
-  const maxLines = {
-    type: "integer",
-    description: "Maximum number of lines to return starting at startLine, or from the start of the file when startLine is omitted. Use for lightweight previews of candidate configs, docs, data, and logs instead of reading many whole files. When the user gives a read/preview budget, each readFile preview consumes one budget slot."
-  };
-  const tailLines = {
-    type: "integer",
-    description: "Return only the last N lines, useful for logs and generated text."
+  const lines = {
+    type: "string",
+    description: 'Which lines to return: "40-120" for a range (1-based, inclusive), "120-" from a line to the end, "-50" for the last N lines (logs, generated output), "50" for the first N. Omit to read the whole file. Use a range after searchFiles gives a line number, and a small count to preview candidates instead of reading many whole files. When the user gives a read/preview budget, each readFile preview consumes one budget slot.'
   };
   if (variant === "minimal") {
     return {
@@ -1257,27 +1245,9 @@ function buildReadWorkspaceParameters(variant) {
       required: ["path"]
     };
   }
-  if (variant === "rich") {
-    return {
-      type: "object",
-      properties: {
-        path,
-        startLine,
-        endLine,
-        maxLines,
-        tailLines
-      },
-      required: ["path"]
-    };
-  }
   return {
     type: "object",
-    properties: {
-      path,
-      startLine,
-      endLine,
-      maxLines
-    },
+    properties: { path, lines },
     required: ["path"]
   };
 }
@@ -2014,31 +1984,120 @@ function readExpectedReplacementCount(args) {
   }
   return value;
 }
-function readPositiveIntegerArg(args) {
-  if (args.value === void 0) return void 0;
+var READ_FILE_SLICE_FALLBACK_LINES = 200;
+var LEGACY_SLICE_ARG_NAMES = ["startLine", "endLine", "maxLines", "tailLines"];
+function isAbsentArg(value) {
+  return value === void 0 || value === null;
+}
+function describeRejectedArgValue(value) {
+  if (typeof value === "string") return JSON.stringify(value);
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  if (Array.isArray(value)) return "an array";
+  return `a value of type ${typeof value}`;
+}
+function readIntegerArg(args) {
+  if (isAbsentArg(args.value)) return {};
+  const min = args.min ?? 1;
   const value = Number(args.value);
-  if (!Number.isInteger(value) || value < 1) {
-    throw new Error(`${args.name} must be a positive integer.`);
+  if (!Number.isInteger(value) || value < min) {
+    const expected = min === 0 ? "a non-negative integer" : "a positive integer";
+    return {
+      warning: `Ignored ${args.name}: expected ${expected}, received ${describeRejectedArgValue(args.value)}.`
+    };
   }
-  return args.max ? Math.min(value, args.max) : value;
+  return { value: args.max ? Math.min(value, args.max) : value };
 }
-function readFileSliceArgs(args) {
-  const startLine = readPositiveIntegerArg({ value: args.startLine, name: "startLine" });
-  const endLine = readPositiveIntegerArg({ value: args.endLine, name: "endLine" });
-  const maxLines = readPositiveIntegerArg({ value: args.maxLines, name: "maxLines", max: 2e3 });
-  const tailLines = readPositiveIntegerArg({ value: args.tailLines, name: "tailLines", max: 2e3 });
-  if (tailLines !== void 0 && (startLine !== void 0 || endLine !== void 0)) {
-    throw new Error("tailLines cannot be combined with startLine or endLine.");
+function collectIntegerArg(args) {
+  const { value, warning } = readIntegerArg(args);
+  if (warning) {
+    args.warnings.push(
+      args.fallback === void 0 ? warning : `${warning} Using ${args.fallback} instead.`
+    );
   }
-  if (endLine !== void 0 && startLine !== void 0 && endLine < startLine) {
-    throw new Error("endLine must be greater than or equal to startLine.");
+  return value ?? args.fallback;
+}
+var LINES_ARG_SYNTAX = '"40-120", "120-", "-50", or "50"';
+var LINES_RANGE_FORMAT = /^(\d+)?\s*-\s*(\d+)?$/;
+function parseLinesArg(value) {
+  const text = typeof value === "string" ? value.trim() : "";
+  if (!text) {
+    return {
+      warning: `Ignored lines: expected ${LINES_ARG_SYNTAX}, received ${describeRejectedArgValue(value)}.`
+    };
   }
-  return {
-    startLine,
-    endLine,
-    maxLines,
-    tailLines
+  const reject = {
+    warning: `Ignored lines: expected ${LINES_ARG_SYNTAX}, received ${JSON.stringify(text)}.`
+  };
+  if (/^\d+$/.test(text)) {
+    const count = Number(text);
+    return count > 0 ? { slice: { maxLines: Math.min(count, 2e3) } } : reject;
+  }
+  const range = LINES_RANGE_FORMAT.exec(text);
+  if (!range) return reject;
+  const [, rawStart, rawEnd] = range;
+  if (rawStart === void 0 && rawEnd === void 0) return reject;
+  if (rawStart === void 0) {
+    const tail = Number(rawEnd);
+    return tail > 0 ? { slice: { tailLines: Math.min(tail, 2e3) } } : reject;
+  }
+  const startLine = Number(rawStart);
+  if (startLine < 1) return reject;
+  if (rawEnd === void 0) return { slice: { startLine } };
+  const endLine = Number(rawEnd);
+  if (endLine < startLine) {
+    return {
+      warning: `Ignored lines ${JSON.stringify(text)}: the end line must be greater than or equal to the start line.`
+    };
+  }
+  return { slice: { startLine, endLine } };
+}
+function readFileSliceArgs(args) {
+  const warnings = [];
+  const legacyUsed = LEGACY_SLICE_ARG_NAMES.filter((name) => !isAbsentArg(args[name]));
+  const withFallback = (slice) => {
+    warnings.push(
+      `No usable line range remained; returned the first ${READ_FILE_SLICE_FALLBACK_LINES} lines instead of the whole file.`
+    );
+    return { ...slice, maxLines: READ_FILE_SLICE_FALLBACK_LINES, warnings };
   };
+  if (!isAbsentArg(args.lines)) {
+    if (legacyUsed.length > 0) {
+      warnings.push(`Ignored ${legacyUsed.join(", ")}: superseded by lines.`);
+    }
+    const { slice, warning } = parseLinesArg(args.lines);
+    if (warning) warnings.push(warning);
+    return slice ? { ...slice, warnings } : withFallback({});
+  }
+  if (legacyUsed.length === 0) return { warnings };
+  warnings.push(
+    `${legacyUsed.join(", ")} ${legacyUsed.length > 1 ? "are" : "is"} deprecated; use lines instead (${LINES_ARG_SYNTAX}).`
+  );
+  const take = (name, max) => collectIntegerArg({ value: args[name], name, max, warnings });
+  const resolved = {
+    startLine: take("startLine"),
+    endLine: take("endLine"),
+    maxLines: take("maxLines", 2e3),
+    tailLines: take("tailLines", 2e3)
+  };
+  if (resolved.endLine !== void 0 && resolved.startLine !== void 0 && resolved.endLine < resolved.startLine) {
+    warnings.push(
+      `Ignored endLine (${resolved.endLine}): endLine must be greater than or equal to startLine (${resolved.startLine}).`
+    );
+    resolved.endLine = void 0;
+  }
+  if (resolved.tailLines !== void 0 && (resolved.startLine !== void 0 || resolved.endLine !== void 0)) {
+    warnings.push(
+      `Ignored tailLines (${resolved.tailLines}): tailLines cannot be combined with startLine or endLine.`
+    );
+    resolved.tailLines = void 0;
+  }
+  const nothingUsable = LEGACY_SLICE_ARG_NAMES.every((name) => resolved[name] === void 0);
+  return nothingUsable ? withFallback(resolved) : { ...resolved, warnings };
+}
+function buildReadFileSliceHint(totalLines) {
+  return `File has ${totalLines} lines. Use lines: ${LINES_ARG_SYNTAX}, or omit it for the whole file.`;
 }
 function splitTextLines(content) {
   const lines = content.split(/\r?\n/);
@@ -2128,36 +2187,42 @@ function requireWorkspaceGlobPattern(args) {
   if (!pattern) throw new Error("globFiles requires a non-empty pattern.");
   return pattern;
 }
-function readWorkspaceMaxResults(args, defaultValue) {
-  if (args.maxResults === void 0) return defaultValue;
-  const value = Number(args.maxResults);
-  if (!Number.isInteger(value) || value < 1) {
-    throw new Error("maxResults must be a positive integer.");
-  }
-  return Math.min(value, 500);
-}
-function readWorkspaceMaxDepth(args) {
-  if (args.maxDepth === void 0) return 1;
-  const value = Number(args.maxDepth);
-  if (!Number.isInteger(value) || value < 1) {
-    throw new Error("maxDepth must be a positive integer.");
-  }
-  return Math.min(value, 10);
+function readWorkspaceMaxResults(args, warnings, defaultValue) {
+  return collectIntegerArg({
+    value: args.maxResults,
+    name: "maxResults",
+    max: 500,
+    fallback: defaultValue,
+    warnings
+  });
 }
-function readWorkspaceEntryType(args) {
-  if (args.entryType === void 0) return "all";
-  if (args.entryType === "all" || args.entryType === "files" || args.entryType === "directories") {
-    return args.entryType;
-  }
-  throw new Error("entryType must be one of all, files, or directories.");
+function readWorkspaceMaxDepth(args, warnings) {
+  return collectIntegerArg({
+    value: args.maxDepth,
+    name: "maxDepth",
+    max: 10,
+    fallback: 1,
+    warnings
+  });
 }
-function readWorkspaceContextLines(args) {
-  if (args.contextLines === void 0) return void 0;
-  const value = Number(args.contextLines);
-  if (!Number.isInteger(value) || value < 0) {
-    throw new Error("contextLines must be a non-negative integer.");
-  }
-  return Math.min(value, 20);
+var WORKSPACE_ENTRY_TYPES = ["all", "files", "directories"];
+function readWorkspaceEntryType(args, warnings) {
+  if (isAbsentArg(args.entryType)) return "all";
+  const entryType = WORKSPACE_ENTRY_TYPES.find((value) => value === args.entryType);
+  if (entryType) return entryType;
+  warnings.push(
+    `Ignored entryType: expected one of ${WORKSPACE_ENTRY_TYPES.join(", ")}, received ${describeRejectedArgValue(args.entryType)}. Using all instead.`
+  );
+  return "all";
+}
+function readWorkspaceContextLines(args, warnings) {
+  return collectIntegerArg({
+    value: args.contextLines,
+    name: "contextLines",
+    min: 0,
+    max: 20,
+    warnings
+  });
 }
 function readWorkspaceExcludeGlobs(args) {
   if (args.exclude === void 0) return [];
@@ -2632,7 +2697,7 @@ async function resolveLocalWorkspaceToolPath(args) {
 async function readFileTool(args) {
   const parsed = parseWorkspaceToolArguments(args.call.arguments);
   const requestedPath = requireWorkspaceToolPath(parsed);
-  const sliceArgs = readFileSliceArgs(parsed);
+  const { warnings, ...sliceArgs } = readFileSliceArgs(parsed);
   const absolutePath = await resolveLocalWorkspaceToolPath({
     workspaceRoot: args.workspaceRoot,
     requestedPath,
@@ -2659,6 +2724,7 @@ async function readFileTool(args) {
       truncated: sliced.truncated,
       ...sliceArgs.maxLines ? { maxLines: sliceArgs.maxLines } : {},
       ...sliceArgs.tailLines ? { tailLines: sliceArgs.tailLines } : {},
+      ...warnings.length ? { warnings: [...warnings, buildReadFileSliceHint(sliced.totalLines)] } : {},
       ...activity ? { activity } : {}
     }
   };
@@ -2789,10 +2855,11 @@ async function listWorkspaceEntries(args) {
 }
 async function listFilesTool(args) {
   const parsed = parseWorkspaceToolArguments(args.call.arguments);
+  const warnings = [];
   const requestedPath = readWorkspacePathAlias(parsed) ?? ".";
-  const maxDepth = readWorkspaceMaxDepth(parsed);
-  const maxResults = readWorkspaceMaxResults(parsed);
-  const entryType = readWorkspaceEntryType(parsed);
+  const maxDepth = readWorkspaceMaxDepth(parsed, warnings);
+  const maxResults = readWorkspaceMaxResults(parsed, warnings);
+  const entryType = readWorkspaceEntryType(parsed, warnings);
   const dirPath = await resolveLocalWorkspaceToolPath({
     workspaceRoot: args.workspaceRoot,
     requestedPath,
@@ -2816,16 +2883,18 @@ async function listFilesTool(args) {
       limitedByMaxResults: listed.truncated,
       limitedByMaxDepth: listed.limitedByMaxDepth,
       visitedEntries: listed.visitedEntries,
-      ...maxResults ? { maxResults } : {}
+      ...maxResults ? { maxResults } : {},
+      ...warnings.length ? { warnings } : {}
     }
   };
 }
 async function searchFilesTool(args) {
   const parsed = parseWorkspaceToolArguments(args.call.arguments);
+  const warnings = [];
   const query = requireWorkspaceSearchQuery(parsed);
   const exclude = readWorkspaceExcludeGlobs(parsed);
-  const maxResults = readWorkspaceMaxResults(parsed, DEFAULT_SEARCH_MAX_RESULTS);
-  const contextLines = readWorkspaceContextLines(parsed);
+  const maxResults = readWorkspaceMaxResults(parsed, warnings, DEFAULT_SEARCH_MAX_RESULTS);
+  const contextLines = readWorkspaceContextLines(parsed, warnings);
   const literal = parsed.literal === true;
   const caseSensitive = parsed.caseSensitive === false ? false : true;
   const requestedPath = readWorkspacePathAlias(parsed) ?? ".";
@@ -2983,6 +3052,7 @@ async function searchFilesTool(args) {
       ...maxResults ? { maxResults } : {},
       exitCode: result.exitCode,
       searchEngine,
+      ...warnings.length ? { warnings } : {},
       ...extractActivity(parsed) ? { activity: extractActivity(parsed) } : {}
     }
   };
@@ -3099,9 +3169,10 @@ async function scanWorkspaceTextMatches(args) {
 }
 async function globFilesTool(args) {
   const parsed = parseWorkspaceToolArguments(args.call.arguments);
+  const warnings = [];
   const pattern = requireWorkspaceGlobPattern(parsed);
   const exclude = readWorkspaceExcludeGlobs(parsed);
-  const maxResults = readWorkspaceMaxResults(parsed);
+  const maxResults = readWorkspaceMaxResults(parsed, warnings);
   const requestedPath = readWorkspacePathAlias(parsed) ?? ".";
   const includeIgnored = parsed.includeIgnored === true;
   const searchPath = await resolveLocalWorkspaceToolPath({
@@ -3205,6 +3276,7 @@ async function globFilesTool(args) {
       ...maxResults ? { maxResults } : {},
       exitCode,
       searchEngine,
+      ...warnings.length ? { warnings } : {},
       ...activity ? { activity } : {}
     }
   };