@pentoshi/clai 4.12.0 → 4.13.0

package/dist/tools/definitions/fs-read.js

@@ -0,0 +1,43 @@
+import { MAX_FS_READ_FILES } from "../fs/read-input.js";
+const FILE_PROPERTIES = {
+    path: { type: "string", minLength: 1, description: "File or directory path (absolute, relative, or ~)." },
+    offset: { type: "integer", minimum: 0, description: "1-indexed start line; 0 means 1. Alias: startLine." },
+    limit: { type: "integer", minimum: 1, description: "Max lines (default 200, max 5000), or directory entries (default 500)." },
+    startLine: { type: "integer", minimum: 0, description: "Inclusive start line. Prefer offset+limit OR startLine+endLine, not both." },
+    endLine: { type: "integer", minimum: 1, description: "Inclusive end line, at least startLine/offset." },
+    pattern: { type: "string", minLength: 1, description: 'JS regex source ("function\\\\s+foo") or /pattern/i; returns matching lines and context. A line range optionally narrows the search.' },
+    context: { type: "integer", minimum: 0, maximum: 20, description: "Context lines before/after each pattern match (default 2)." },
+    maxMatches: { type: "integer", minimum: 1, maximum: 100, description: "Max pattern matches (default 20)." },
+    caseInsensitive: { type: "boolean", description: "Case-insensitive pattern matching; alternatively use /pattern/i." },
+    maxBytes: { type: "integer", minimum: 1, description: "Maximum content bytes for this file, including range/pattern reads. Multi-file calls share a 256 KiB content budget; narrow filters to read more." },
+};
+export const FS_READ_DESCRIPTION = [
+    "Read one text file or list one directory with {path,...options}.",
+    `Only when several known files are needed together, use {files:[{path,...options},...]} with 1–${MAX_FS_READ_FILES} entries; single-file reads remain preferred when sufficient.`,
+    'Example: {"files":[{"path":"src/app.ts","offset":1,"limit":80},{"path":"src/config.ts","pattern":"export","context":2}]}.',
+    "Choose exactly one of path or files. In files mode, every entry requires path; all filters belong inside that entry, never at the top level. Do not add irrelevant files to fill the limit.",
+    "Small path-only files return fully; large files auto-head. hasMore=true or clipping means incomplete coverage: continue using that file’s footer offset/limit, or narrow its filters. Do not repeat path-only hoping for more.",
+    "Known range: offset+limit or startLine+endLine (1-indexed inclusive). Known symbol: pattern with optional context. Discover unknown paths with shell.exec rg first.",
+    "Range/pattern lines are numbered N: text. Multi-file results are ordered, labeled by path, and report each file’s success or failure separately; successful reads remain available if another fails. Retry only failed/unfinished entries that are still needed.",
+].join(" ");
+export const FS_READ_PARAMETERS = {
+    type: "object",
+    properties: {
+        ...FILE_PROPERTIES,
+        files: {
+            type: "array",
+            minItems: 1,
+            maxItems: MAX_FS_READ_FILES,
+            description: "Optional alternative to path: 1–6 relevant file objects, each with its own path and filters. Omit top-level path and filters when using files.",
+            items: {
+                type: "object",
+                properties: FILE_PROPERTIES,
+                required: ["path"],
+                additionalProperties: false,
+            },
+        },
+    },
+    required: [],
+    additionalProperties: false,
+};
+//# sourceMappingURL=fs-read.js.map

package/dist/tools/definitions/fs-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-read.js","sourceRoot":"","sources":["../../../src/tools/definitions/fs-read.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,eAAe,GAAG;IACtB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE;IACzG,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE;IAC1G,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,wEAAwE,EAAE;IAC7H,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,2EAA2E,EAAE;IACpI,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACvG,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,sIAAsI,EAAE;IAC9L,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,4DAA4D,EAAE;IAChI,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,mCAAmC,EAAE;IAC3G,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,kEAAkE,EAAE;IACrH,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,mJAAmJ,EAAE;CAC5M,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,kEAAkE;IAClE,iGAAiG,iBAAiB,+DAA+D;IACjL,2HAA2H;IAC3H,6LAA6L;IAC7L,gOAAgO;IAChO,qKAAqK;IACrK,kQAAkQ;CACnQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,GAAG,eAAe;QAClB,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,iBAAiB;YAC3B,WAAW,EAAE,gJAAgJ;YAC7J,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,eAAe;gBAC3B,QAAQ,EAAE,CAAC,MAAM,CAAC;gBAClB,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;IACD,QAAQ,EAAE,EAAE;IACZ,oBAAoB,EAAE,KAAK;CAC5B,CAAC"}

package/dist/tools/definitions/selection.js

@@ -1,6 +1,5 @@
 import { TOOL_DEFINITIONS } from "./aggregate.js";
 import { NON_REGISTRY_TOOL_NAMES } from "../definitions.js";
-import { SUBAGENT_TOOL_NAMES } from "./subagents.js";
 export const byName = new Map(TOOL_DEFINITIONS.map((d) => [d.name, d]));
 export function getToolDefinitions(filter) {
     let defs = TOOL_DEFINITIONS;
@@ -11,50 +10,6 @@ export function getToolDefinitions(filter) {
         const allow = new Set(filter.names);
         defs = defs.filter((d) => allow.has(d.name));
     }
-    if (filter?.compact) {
-        const core = new Set([
-            ...SUBAGENT_TOOL_NAMES,
-            "fs.read",
-            "fs.write",
-            "fs.writeMany",
-            "fs.list",
-            "fs.search",
-            "fs.edit",
-            "fs.append",
-            "fs.delete",
-            "shell.exec",
-            "shell.jobs",
-            "shell.tail",
-            "shell.wait",
-            "shell.stop",
-            "terminal.start",
-            "terminal.send",
-            "terminal.read",
-            "terminal.status",
-            "terminal.list",
-            "terminal.close",
-            "web.search",
-            "web.fetch",
-            "http.fetch",
-            "net.pingSweep",
-            "wordlist.find",
-            "tool.check",
-            "image.view",
-            "image.ocr",
-            "skill.load",
-            "skill.list",
-            "mcp.call",
-            "mcp.list",
-            "mcp.tools",
-            "instructions.record",
-            "plan.create",
-            "task.add",
-            "task.move",
-            "job.read",
-            "task.update",
-        ]);
-        defs = defs.filter((d) => core.has(d.name));
-    }
     return defs.map((d) => ({ ...d }));
 }
 export function getCompactToolDefinitions() {

package/dist/tools/definitions/selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../src/tools/definitions/selection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../src/tools/definitions/selection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAExE,MAAM,UAAU,kBAAkB,CAAC,MAIlC;IACC,IAAI,IAAI,GAAG,gBAAgB,CAAC;IAC5B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,kBAAkB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,YAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACtB,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CACb,eAAe,CAAC,CAAC,IAAI,wDAAwD,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,yBAAyB,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tools/definitions/shell.js

@@ -1,11 +1,14 @@
 import { def, emptyObject } from "./define.js";
 export const TOOL_DEFINITIONS_SHELL = [
-    def("shell.exec", 'Run a shell command. Default timeoutMs is 40000; choose a larger timeout for builds, installs, scaffolds, scans, and searches. Known long installs get a safe automatic budget when omitted. Persistent servers, watchers, and listeners: background:"always" with a name; they auto-launch as normal background jobs that need shell.tail/shell.jobs plus a readiness probe. Choose responder:true for a fire-and-continue finite job with automatic terminal delivery. Pass background:"never" to force foreground and honor timeoutMs. Pass cwd instead of cd.', {
+    def("shell.exec", 'Run a shell command in the foreground by default; commands are never automatically backgrounded. You choose execution mode and foreground timeoutMs in milliseconds. Foreground default is 60000; set a sufficient budget for builds, installs, scans and searches. background:"always" explicitly starts a durable pollable job; use shell.wait for finite jobs. Persistent servers, watchers, and listeners: background:"always" with a name; use shell.tail plus a readiness probe and shell.stop for cleanup. responder:true explicitly delegates finite work with automatic terminal delivery; do independent work instead of polling, then analyze the result and call job.read. background:"never" overrides responder. timeoutMs is ignored for background and Responder jobs; authorization expiry remains enforced. Pass cwd instead of cd.', {
         type: "object",
         properties: {
             command: { type: "string" },
             cwd: { type: "string" },
-            timeoutMs: { type: "integer" },
+            timeoutMs: {
+                type: "integer",
+                description: "Foreground execution deadline in milliseconds (1000–1800000; default 60000). Ignored for background and Responder jobs, which have no execution deadline. No command-based budget or seconds conversion.",
+            },
             name: {
                 type: "string",
                 description: "Short label for a background job, e.g. \"api dev server\".",
@@ -13,7 +16,7 @@ export const TOOL_DEFINITIONS_SHELL = [
             background: {
                 type: "string",
                 enum: ["auto", "never", "always"],
-                description: "auto (default): run finite commands in the foreground and persistent commands in the background. never: always run in the foreground and honor timeoutMs. always: always run as a durable pollable job.",
+                description: 'Omitted or auto (legacy compatibility): foreground unless responder:true is explicitly chosen; no heuristic backgrounding. never: force foreground even with responder:true. always: explicitly start a durable job, pollable unless responder:true.',
             },
             responder: {
                 type: "boolean",

package/dist/tools/definitions/shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/tools/definitions/shell.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,CAAC,MAAM,sBAAsB,GAAqB;IACtD,GAAG,CACD,YAAY,EACZ,miBAAmiB,EACniB;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9B,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;aAC1E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;gBACjC,WAAW,EACT,yMAAyM;aAC5M;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4NAA4N;aAC/N;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,gKAAgK;aACnK;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,oBAAoB,EAAE,KAAK;KAC5B,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB;IACD,GAAG,CACD,YAAY,EACZ,qKAAqK,EACrK,WAAW,EACX,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB;IACD,GAAG,CACD,YAAY,EACZ,4UAA4U,EAC5U;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC1B,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,yEAAyE;aAC5E;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;gBACtC,WAAW,EAAE,0CAA0C;aACxD;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB;IACD,GAAG,CACD,YAAY,EACZ,2FAA2F,EAC3F;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QACtC,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB;IACD,GAAG,CACD,YAAY,EACZ,8fAA8f,EAC9f;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,oDAAoD;aAClE;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB;CACF,CAAC"}
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/tools/definitions/shell.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,CAAC,MAAM,sBAAsB,GAAqB;IACtD,GAAG,CACD,YAAY,EACZ,uzBAAuzB,EACvzB;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0MAA0M;aACxN;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;aAC1E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;gBACjC,WAAW,EACT,sPAAsP;aACzP;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4NAA4N;aAC/N;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,gKAAgK;aACnK;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,oBAAoB,EAAE,KAAK;KAC5B,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB;IACD,GAAG,CACD,YAAY,EACZ,qKAAqK,EACrK,WAAW,EACX,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB;IACD,GAAG,CACD,YAAY,EACZ,4UAA4U,EAC5U;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC1B,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,yEAAyE;aAC5E;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;gBACtC,WAAW,EAAE,0CAA0C;aACxD;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB;IACD,GAAG,CACD,YAAY,EACZ,2FAA2F,EAC3F;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QACtC,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB;IACD,GAAG,CACD,YAAY,EACZ,8fAA8f,EAC9f;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,oDAAoD;aAClE;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB;CACF,CAAC"}

package/dist/tools/elevated-shell.d.ts

@@ -11,6 +11,7 @@ export type PreparedElevation = {
     result: ToolResult;
 };
 export declare function preparePrivilegedBackgroundArgv(command: string, argv: string[], options: {
+    cwd?: string | undefined;
     signal?: AbortSignal | undefined;
     onOutput?: ToolRunOptions["onOutput"];
     requestSecret?: ToolRunOptions["requestSecret"];

package/dist/tools/elevated-shell.js

@@ -40,6 +40,7 @@ export async function preparePrivilegedBackgroundArgv(command, argv, options, de
     }
     const outcome = await obtainSudoPassword({
         requestSecret: options.requestSecret,
+        operation: { name: "shell.exec", args: { executable: "sudo", argv: ["-S", "-p", "", command, ...argv], cwd: options.cwd } },
         title: options.title ?? "Administrator access",
         prompt: options.prompt ??
             "Enter your password for sudo. It is sent only to sudo stdin, kept in memory for a few minutes so parallel privileged commands don't ask again, and never written to disk. Esc cancels.",
@@ -126,6 +127,7 @@ export async function tryRunElevatedWithoutTty(command, options, dependencies =
     const run = dependencies.run ?? spawnArgv;
     const outcome = await obtainSudoPassword({
         requestSecret: options.requestSecret,
+        operation: { name: "shell.exec", args: { command, cwd: options.cwd, executable: "sudo", argv: ["-S", "-p", "", "sh", "-c", command], timeoutMs: options.timeoutMs } },
         title: "Administrator access",
         prompt: `Enter your password for sudo. Command: ${truncateForPrompt(command)}. It is sent only to sudo stdin, kept in memory for a few minutes so parallel privileged commands don't ask again, and never written to disk. Esc cancels.`,
         ...(options.signal ? { signal: options.signal } : {}),

package/dist/tools/elevated-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"elevated-shell.js","sourceRoot":"","sources":["../../src/tools/elevated-shell.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"elevated-shell.js","sourceRoot":"","sources":["../../src/tools/elevated-shell.ts"],"names":[],"mappings":"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"}

package/dist/tools/fs/read-budget.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_READ_MAX_BYTES: number;
+export declare function clipReadText(text: string, maxBytes: number): string;
+export declare class ReadOutputBudget {
+    private remaining;
+    truncated: boolean;
+    constructor(maxBytes?: number);
+    take(line: string): string | undefined;
+}

package/dist/tools/fs/read-budget.js

@@ -0,0 +1,30 @@
+export const DEFAULT_READ_MAX_BYTES = 8 * 1024 * 1024;
+export function clipReadText(text, maxBytes) {
+    const candidate = text.slice(0, maxBytes);
+    if (Buffer.byteLength(candidate, "utf8") <= maxBytes)
+        return candidate;
+    const buffer = Buffer.from(candidate, "utf8");
+    let end = maxBytes;
+    while (end > 0 && (buffer[end] & 0xc0) === 0x80)
+        end -= 1;
+    return buffer.subarray(0, end).toString("utf8");
+}
+export class ReadOutputBudget {
+    remaining;
+    truncated = false;
+    constructor(maxBytes = DEFAULT_READ_MAX_BYTES) {
+        this.remaining = maxBytes;
+    }
+    take(line) {
+        if (this.remaining < 1) {
+            this.truncated = true;
+            return undefined;
+        }
+        const text = clipReadText(line, this.remaining - 1);
+        this.remaining -= Buffer.byteLength(text, "utf8") + 1;
+        if (text !== line)
+            this.truncated = true;
+        return text;
+    }
+}
+//# sourceMappingURL=read-budget.js.map

package/dist/tools/fs/read-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-budget.js","sourceRoot":"","sources":["../../../src/tools/fs/read-budget.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtD,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,QAAQ;QAAE,OAAO,SAAS,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAE,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,GAAG,IAAI,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,OAAO,gBAAgB;IACnB,SAAS,CAAS;IAC1B,SAAS,GAAG,KAAK,CAAC;IAElB,YAAY,QAAQ,GAAG,sBAAsB;QAC3C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,IAAY;QACf,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,IAAI,KAAK,IAAI;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/tools/fs/read-input.d.ts

@@ -0,0 +1,16 @@
+import type { FsReadOptions } from "../fs.js";
+export declare const MAX_FS_READ_FILES = 6;
+export declare const FS_READ_OPTION_KEYS: readonly ["offset", "limit", "startLine", "endLine", "pattern", "context", "maxMatches", "caseInsensitive", "maxBytes"];
+export interface FsReadFileInput extends FsReadOptions {
+    path: string;
+}
+type ReadInputResult = {
+    ok: true;
+    files: FsReadFileInput[];
+    multiple: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseFsReadInput(args: Record<string, unknown>): ReadInputResult;
+export {};

package/dist/tools/fs/read-input.js

@@ -0,0 +1,73 @@
+export const MAX_FS_READ_FILES = 6;
+export const FS_READ_OPTION_KEYS = [
+    "offset", "limit", "startLine", "endLine", "pattern", "context",
+    "maxMatches", "caseInsensitive", "maxBytes",
+];
+const USAGE = 'Use {"path":"src/app.ts","offset":1,"limit":80} for one file, or {"files":[{"path":"src/app.ts","limit":80},{"path":"src/config.ts","pattern":"export","context":2}]} for 1–6 relevant files. Put each file’s options inside its entry; use exactly one of path or files.';
+function readFileInput(raw, label) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`${label} must be an object with a path and optional read filters.`);
+    }
+    const args = raw;
+    const unknown = Object.keys(args).find((key) => key !== "path" && !FS_READ_OPTION_KEYS.includes(key));
+    if (unknown)
+        throw new Error(`${label}.${unknown} is not a read option. Put offset/limit, startLine/endLine, pattern/context, maxMatches, caseInsensitive or maxBytes directly beside path.`);
+    if (typeof args.path !== "string" || !args.path.trim()) {
+        throw new Error(`${label}.path must be a non-empty string.`);
+    }
+    const file = { path: args.path };
+    for (const key of FS_READ_OPTION_KEYS) {
+        const value = args[key];
+        if (value === undefined || value === null)
+            continue;
+        if (key === "pattern") {
+            if (typeof value !== "string" || !value.trim()) {
+                throw new Error(`${label}.pattern must be a non-empty regex string.`);
+            }
+            file.pattern = value;
+        }
+        else if (key === "caseInsensitive") {
+            if (typeof value !== "boolean")
+                throw new Error(`${label}.${key} must be true or false.`);
+            file.caseInsensitive = value;
+        }
+        else {
+            const number = typeof value === "string" && value.trim() ? Number(value) : value;
+            const minimum = key === "offset" || key === "startLine" || key === "context" ? 0 : 1;
+            if (typeof number !== "number" || !Number.isSafeInteger(number) || number < minimum) {
+                throw new Error(`${label}.${key} must be an integer >= ${minimum}.`);
+            }
+            file[key] = number;
+        }
+    }
+    return file;
+}
+export function parseFsReadInput(args) {
+    try {
+        if (args.files !== undefined && args.files !== null) {
+            if (args.path !== undefined && args.path !== null) {
+                throw new Error("fs.read received both path and files.");
+            }
+            if (!Array.isArray(args.files) || args.files.length < 1 || args.files.length > MAX_FS_READ_FILES) {
+                throw new Error(`fs.read files must be an array of 1–${MAX_FS_READ_FILES} file objects.`);
+            }
+            const sharedOption = FS_READ_OPTION_KEYS.find((key) => args[key] !== undefined && args[key] !== null);
+            if (sharedOption)
+                throw new Error(`Move ${sharedOption} into the appropriate files entry.`);
+            const unknown = Object.keys(args).find((key) => key !== "files" && key !== "path");
+            if (unknown)
+                throw new Error(`fs.read.${unknown} is not supported in files mode; place read filters directly inside each file entry.`);
+            return {
+                ok: true,
+                files: args.files.map((file, index) => readFileInput(file, `files[${index}]`)),
+                multiple: true,
+            };
+        }
+        const { files: _unused, ...single } = args;
+        return { ok: true, files: [readFileInput(single, "fs.read")], multiple: false };
+    }
+    catch (error) {
+        return { ok: false, error: `${error instanceof Error ? error.message : String(error)}\n${USAGE}` };
+    }
+}
+//# sourceMappingURL=read-input.js.map

package/dist/tools/fs/read-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-input.js","sourceRoot":"","sources":["../../../src/tools/fs/read-input.ts"],"names":[],"mappings":"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"}

package/dist/tools/fs/read-many.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResult } from "../../types.js";
+import { type FsReadFileInput } from "./read-input.js";
+export declare function fsReadMany(files: readonly FsReadFileInput[], options?: {
+    confirmed?: boolean | undefined;
+    signal?: AbortSignal | undefined;
+}): Promise<ToolResult>;

package/dist/tools/fs/read-many.js

@@ -0,0 +1,50 @@
+import { fsRead } from "./read.js";
+import { MAX_FS_READ_FILES } from "./read-input.js";
+import { boundFsReadOutput, formatFsReadSection } from "./read-sections.js";
+const BATCH_MAX_BYTES = 256 * 1024;
+const READ_CONCURRENCY = 3;
+export async function fsReadMany(files, options = {}) {
+    if (files.length < 1 || files.length > MAX_FS_READ_FILES) {
+        return { ok: false, exitCode: 1, output: `fs.read accepts 1–${MAX_FS_READ_FILES} files per call.` };
+    }
+    options.signal?.throwIfAborted();
+    const results = new Array(files.length);
+    const maxBytes = Math.floor(BATCH_MAX_BYTES / files.length);
+    let next = 0;
+    const worker = async () => {
+        while (next < files.length) {
+            options.signal?.throwIfAborted();
+            const index = next++;
+            const { path, ...filters } = files[index];
+            try {
+                results[index] = await fsRead(path, {
+                    ...filters,
+                    ...options,
+                    maxBytes: Math.min(filters.maxBytes ?? maxBytes, maxBytes),
+                });
+                options.signal?.throwIfAborted();
+            }
+            catch (error) {
+                options.signal?.throwIfAborted();
+                results[index] = { ok: false, exitCode: 1, output: error instanceof Error ? error.message : String(error) };
+            }
+        }
+    };
+    const settled = await Promise.allSettled(Array.from({ length: Math.min(READ_CONCURRENCY, files.length) }, worker));
+    const rejected = settled.find((result) => result.status === "rejected");
+    if (rejected?.status === "rejected")
+        throw rejected.reason;
+    const failed = results.filter((result) => !result.ok).length;
+    const output = results.map((result, index) => formatFsReadSection({
+        index: index + 1, total: files.length, path: files[index].path,
+        ok: result.ok, body: result.output || "(empty file)",
+    })).join("\n\n");
+    const bounded = boundFsReadOutput(output, BATCH_MAX_BYTES);
+    return {
+        ok: failed === 0,
+        ...(failed > 0 ? { exitCode: 1 } : {}),
+        truncated: bounded !== output || results.some((result) => result.truncated),
+        output: bounded,
+    };
+}
+//# sourceMappingURL=read-many.js.map

package/dist/tools/fs/read-many.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-many.js","sourceRoot":"","sources":["../../../src/tools/fs/read-many.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAwB,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,CAAC;AACnC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAiC,EACjC,UAAiF,EAAE;IAEnF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;QACzD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,qBAAqB,iBAAiB,kBAAkB,EAAE,CAAC;IACtG,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,OAAO,GAAiB,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;YACrB,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE;oBAClC,GAAG,OAAO;oBACV,GAAG,OAAO;oBACV,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,QAAQ,EAAE,QAAQ,CAAC;iBAC3D,CAAC,CAAC;gBACH,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACnC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;gBACjC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9G,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACnH,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IACxE,IAAI,QAAQ,EAAE,MAAM,KAAK,UAAU;QAAE,MAAM,QAAQ,CAAC,MAAM,CAAC;IAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC;QAChE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAE,CAAC,IAAI;QAC/D,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,IAAI,cAAc;KACrD,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjB,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3D,OAAO;QACL,EAAE,EAAE,MAAM,KAAK,CAAC;QAChB,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,SAAS,EAAE,OAAO,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;QAC3E,MAAM,EAAE,OAAO;KAChB,CAAC;AACJ,CAAC"}

package/dist/tools/fs/read-sections.d.ts

@@ -0,0 +1,11 @@
+export interface FsReadSection {
+    readonly index: number;
+    readonly total: number;
+    readonly path: string;
+    readonly ok: boolean;
+    readonly body: string;
+}
+export declare function formatFsReadSection(section: FsReadSection): string;
+export declare function parseFsReadSections(output: string): FsReadSection[];
+export declare function isFsReadMultiOutput(output: string): boolean;
+export declare function boundFsReadOutput(output: string, maxChars: number): string;

package/dist/tools/fs/read-sections.js

@@ -0,0 +1,71 @@
+import { MAX_FS_READ_FILES } from "./read-input.js";
+const HEADER = /^# fs\.read file=(\d+)\/(\d+) path=("(?:\\.|[^"\\])*") status=(ok|failed)$/m;
+export function formatFsReadSection(section) {
+    return `# fs.read file=${section.index}/${section.total} path=${JSON.stringify(section.path)} status=${section.ok ? "ok" : "failed"}\n${section.body}\n# end fs.read file=${section.index}/${section.total}`;
+}
+export function parseFsReadSections(output) {
+    const sections = [];
+    const pattern = new RegExp(HEADER.source, "gm");
+    let header;
+    while (sections.length < MAX_FS_READ_FILES && (header = pattern.exec(output))) {
+        const index = Number(header[1]);
+        const total = Number(header[2]);
+        if (total < 1 || total > MAX_FS_READ_FILES || index < 1 || index > total)
+            continue;
+        let path;
+        try {
+            path = JSON.parse(header[3]);
+        }
+        catch {
+            continue;
+        }
+        const start = header.index + header[0].length + 1;
+        const endMarker = `\n# end fs.read file=${index}/${total}`;
+        const marker = output.indexOf(endMarker, start);
+        const next = marker < 0 ? pattern.exec(output) : undefined;
+        const end = marker >= start ? marker : next?.index ?? output.length;
+        pattern.lastIndex = marker >= start ? marker + endMarker.length : end;
+        sections.push({ index, total, path, ok: header[4] === "ok", body: output.slice(start, end).trimEnd() });
+    }
+    return sections;
+}
+export function isFsReadMultiOutput(output) {
+    return HEADER.test(output);
+}
+export function boundFsReadOutput(output, maxChars) {
+    if (output.length <= maxChars)
+        return output;
+    const sections = parseFsReadSections(output);
+    if (sections.length === 0)
+        return output;
+    const prefix = output.slice(0, HEADER.exec(output)?.index ?? 0);
+    const notice = "\n# Output clipped; re-read this path with narrower filters. Coverage is incomplete.\n";
+    const pathBudget = Math.max(32, Math.floor(maxChars / (sections.length * 4)));
+    const bounded = sections.map((section) => ({
+        ...section,
+        path: section.path.length <= pathBudget ? section.path : `${section.path.slice(0, pathBudget - 1)}…`,
+    }));
+    const headersSize = prefix.length + bounded.reduce((size, section) => size + formatFsReadSection({ ...section, body: "" }).length + 2, 0);
+    if (headersSize >= maxChars) {
+        const note = "\nBodies omitted; coverage is incomplete. Re-read with narrower filters.";
+        const available = Math.max(0, maxChars - prefix.length - note.length);
+        const rowBudget = Math.max(0, Math.floor(available / sections.length) - 1);
+        const rows = sections.map((section) => {
+            const label = `${section.index}/${section.total} ${section.ok ? "ok" : "failed"}: `;
+            return `${label}${section.path.slice(0, Math.max(0, rowBudget - label.length))}`.slice(0, rowBudget);
+        });
+        return `${prefix}${rows.join("\n")}${note}`.slice(0, maxChars);
+    }
+    const budget = Math.max(0, Math.floor((maxChars - headersSize) / bounded.length));
+    return prefix + bounded.map((section) => {
+        if (section.body.length <= budget)
+            return formatFsReadSection(section);
+        if (budget <= notice.length)
+            return formatFsReadSection({ ...section, body: notice.trim().slice(0, budget) });
+        const contentBudget = budget - notice.length;
+        const head = Math.ceil(contentBudget * 0.7);
+        const tail = contentBudget - head;
+        return formatFsReadSection({ ...section, body: `${section.body.slice(0, head)}${notice}${tail > 0 ? section.body.slice(-tail) : ""}` });
+    }).join("\n\n");
+}
+//# sourceMappingURL=read-sections.js.map

package/dist/tools/fs/read-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-sections.js","sourceRoot":"","sources":["../../../src/tools/fs/read-sections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAUpD,MAAM,MAAM,GAAG,6EAA6E,CAAC;AAE7F,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,OAAO,kBAAkB,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,wBAAwB,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;AAC/M,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,MAA8B,CAAC;IACnC,OAAO,QAAQ,CAAC,MAAM,GAAG,iBAAiB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,iBAAiB,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,KAAK;YAAE,SAAS;QACnF,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAW,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,wBAAwB,KAAK,IAAI,KAAK,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,MAAM,GAAG,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;QACpE,OAAO,CAAC,SAAS,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;QACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAgB;IAChE,IAAI,MAAM,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC7C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,wFAAwF,CAAC;IACxG,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzC,GAAG,OAAO;QACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,GAAG;KACrG,CAAC,CAAC,CAAC;IACJ,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1I,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,0EAA0E,CAAC;QACxF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC;YACpF,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACvG,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAClF,OAAO,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACtC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM;YAAE,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9G,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,aAAa,GAAG,IAAI,CAAC;QAClC,OAAO,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1I,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/tools/fs/read-window.d.ts

@@ -10,5 +10,5 @@ export declare function resolveLineWindow(options: FsReadOptions): {
     ok: false;
     error: string;
 };
-export declare function readLineWindow(resolved: string, start: number, limit: number, fileBytes: number, note?: string): Promise<ToolResult>;
+export declare function readLineWindow(resolved: string, start: number, limit: number, fileBytes: number, note?: string, maxBytes?: number, signal?: AbortSignal): Promise<ToolResult>;
 export declare function readByPattern(resolved: string, options: FsReadOptions, fileBytes: number): Promise<ToolResult>;