@bevel-software/platform-core-backend 0.33.0 → 0.35.0

package/dist/modules/workspace/agent-access.gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-access.gate.js","sourceRoot":"","sources":["../../../src/modules/workspace/agent-access.gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,4VAA4V,CAAC;AAE/V;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IACvB,SAAS,GAAG,EAAE,CAAC;IACf,SAAS,GAAG,EAAE,CAAC;IACN,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAEnD,4DAA4D;IAC5D,qBAAqB,CAAC,IAAY;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,iEAAiE;IACjE,qBAAqB,CAAC,IAAY;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,oEAAoE;IACpE,aAAa;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,8EAA8E;IAC9E,oBAAoB;QAClB,OAAO,sBAAsB,GAAG,IAAI,CAAC,SAAS,CAAC;IACjD,CAAC;IAED,mFAAmF;IACnF,QAAQ,CAAC,QAAoB;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAEO,QAAQ;QACd,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;CACF;AAgBD,gFAAgF;AAChF,SAAS,aAAa,CAAC,GAAgB;IACrC,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CACvB,IAAqB,EACrB,GAAgB,EAChB,MAAc,EACd,MAAe;IAEf,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAqB,EACrB,GAAgB,EAChB,MAAc,EACd,MAAc;IAEd,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO;IACxB,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAqB,EACrB,GAAgB,EAChB,MAAc,EACd,MAAe;IAEf,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO;IACxB,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"agent-access.gate.js","sourceRoot":"","sources":["../../../src/modules/workspace/agent-access.gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,+NAA+N,CAAC;AAElO;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IACvB,SAAS,GAAG,EAAE,CAAC;IACf,SAAS,GAAG,EAAE,CAAC;IACN,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAEnD,4DAA4D;IAC5D,qBAAqB,CAAC,IAAY;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,iEAAiE;IACjE,qBAAqB,CAAC,IAAY;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,oEAAoE;IACpE,aAAa;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,8EAA8E;IAC9E,oBAAoB;QAClB,OAAO,sBAAsB,GAAG,IAAI,CAAC,SAAS,CAAC;IACjD,CAAC;IAED,mFAAmF;IACnF,QAAQ,CAAC,QAAoB;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAEO,QAAQ;QACd,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;CACF;AAgBD,gFAAgF;AAChF,SAAS,aAAa,CAAC,GAAgB;IACrC,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CACvB,IAAqB,EACrB,GAAgB,EAChB,MAAc,EACd,MAAe;IAEf,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAqB,EACrB,GAAgB,EAChB,MAAc,EACd,MAAc;IAEd,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO;IACxB,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAqB,EACrB,GAAgB,EAChB,MAAc,EACd,MAAe;IAEf,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO;IACxB,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/modules/workspace/file-readers/doc-extract.service.d.ts

@@ -89,10 +89,21 @@ export declare class DocExtractService {
     private readonly now;
     private readonly onUnreadable;
     /**
-     * Cold extractions currently running, by cache key. Two reads of the same
-     * document arriving together would otherwise BOTH parse it — the expensive
-     * half of this service, run twice for one answer — because neither had
-     * written the cache entry yet when the other looked.
+     * Reads currently running, by cache key — the cache lookup included, from
+     * the moment `extract` is called. Two reads of the same document arriving
+     * together would otherwise BOTH parse it — the expensive half of this
+     * service, run twice for one answer — because neither had written the
+     * cache entry yet when the other looked. The entry is set before anything
+     * is awaited: were the lookup awaited first, a second read could miss the
+     * cache (its read of the file started before the first read's write) AND
+     * the map (the first read finished and left it in that window), and parse
+     * the document again, telling the people looking at it twice.
+     *
+     * What is shared is exactly what the key identifies — the bytes' extraction
+     * under a format, which is what the cache holds — and nothing of the read
+     * that started it: the key carries no path, so two reads of the same bytes
+     * at different paths share one promise, and each names the answer with its
+     * own path (`extract`).
      */
     private readonly inFlight;
     constructor(cacheRoot: string, extractor: IDocumentExtractor, opts?: DocExtractServiceOptions);
@@ -110,6 +121,19 @@ export declare class DocExtractService {
      * `origin`, when given, is where a fresh failure is reported.
      */
     extract(path: string, bytes: Buffer, origin?: ReadOrigin): Promise<DocExtractOutcome>;
+    /** What the cache holds for `key`, or undefined on a miss. */
+    private remembered;
+    /**
+     * One read of `bytes`, shared by every `extract` of the same key that
+     * arrives before it settles (see `inFlight`): the cache lookup, then the
+     * extraction and its cache write. The write stays INSIDE the shared
+     * promise: were the entry dropped as soon as parsing settled, a read
+     * arriving during the write would miss both the cache and the map — and
+     * parse the same document again. A failure is reported to the FIRST
+     * read's origin and path, once; `path` otherwise gives only the format,
+     * which every read of the key shares.
+     */
+    private read;
     /** Best-effort, like every event: a listener that throws never fails the read. */
     private notifyUnreadable;
     /** Content hash + lowercased extension — e.g. `…sha….odt` (see the class doc). */

package/dist/modules/workspace/file-readers/doc-extract.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-extract.service.d.ts","sourceRoot":"","sources":["../../../../src/modules/workspace/file-readers/doc-extract.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,kCAAkC,CAAC;AAG/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,kHAAkH;IAClH,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GACzB,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,aAAa,CAAC,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,qBAAa,iBAAiB;IAc1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAb5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkD;IAC/E;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkD;gBAGzE,SAAS,EAAE,MAAM,EACA,SAAS,EAAE,kBAAkB,EAC9C,IAAI,GAAE,wBAA6B;IAOrC;;;;;;OAMG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAQpF;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8B3F,kFAAkF;IAClF,OAAO,CAAC,gBAAgB;IAQxB,kFAAkF;IAClF,OAAO,CAAC,QAAQ;CAGjB"}
+{"version":3,"file":"doc-extract.service.d.ts","sourceRoot":"","sources":["../../../../src/modules/workspace/file-readers/doc-extract.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAG3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,kHAAkH;IAClH,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GACzB,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,aAAa,CAAC,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAcnC,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,qBAAa,iBAAiB;IAyB1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAxB5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkD;IAC/E;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;gBAGjE,SAAS,EAAE,MAAM,EACA,SAAS,EAAE,kBAAkB,EAC9C,IAAI,GAAE,wBAA6B;IAOrC;;;;;;OAMG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAKpF;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAM3F,8DAA8D;YAChD,UAAU;IAMxB;;;;;;;;;OASG;IACH,OAAO,CAAC,IAAI;IAoBZ,kFAAkF;IAClF,OAAO,CAAC,gBAAgB;IAQxB,kFAAkF;IAClF,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/modules/workspace/file-readers/doc-extract.service.js

@@ -1,5 +1,9 @@
 import { extractionMarker, fileExtension } from './doc-extract.types.js';
 import { DocExtractionCache, gitBlobSha } from './extraction-cache.js';
+/** `raw` as the answer for `path`: its marker names that path. */
+function named(path, raw) {
+    return raw.ok ? { ok: true, marker: extractionMarker(path, raw.summary), text: raw.text } : raw;
+}
 /**
  * How long an extraction stopped over its budget, or whose worker died under
  * it, is remembered: an overrun is a property of the moment (a busy server, a
@@ -59,10 +63,21 @@ export class DocExtractService {
     now;
     onUnreadable;
     /**
-     * Cold extractions currently running, by cache key. Two reads of the same
-     * document arriving together would otherwise BOTH parse it — the expensive
-     * half of this service, run twice for one answer — because neither had
-     * written the cache entry yet when the other looked.
+     * Reads currently running, by cache key — the cache lookup included, from
+     * the moment `extract` is called. Two reads of the same document arriving
+     * together would otherwise BOTH parse it — the expensive half of this
+     * service, run twice for one answer — because neither had written the
+     * cache entry yet when the other looked. The entry is set before anything
+     * is awaited: were the lookup awaited first, a second read could miss the
+     * cache (its read of the file started before the first read's write) AND
+     * the map (the first read finished and left it in that window), and parse
+     * the document again, telling the people looking at it twice.
+     *
+     * What is shared is exactly what the key identifies — the bytes' extraction
+     * under a format, which is what the cache holds — and nothing of the read
+     * that started it: the key carries no path, so two reads of the same bytes
+     * at different paths share one promise, and each names the answer with its
+     * own path (`extract`).
      */
     inFlight = new Map();
     constructor(cacheRoot, extractor, opts = {}) {
@@ -79,12 +94,8 @@ export class DocExtractService {
      * only to cold ones; `file_stat` uses it to report a remembered failure.
      */
     async getCached(path, bytes) {
-        const hit = await this.cache.get(this.cacheKey(path, bytes), this.now());
-        if (!hit)
-            return undefined;
-        return hit.failed
-            ? { ok: false, message: hit.message }
-            : { ok: true, marker: extractionMarker(path, hit.summary), text: hit.text };
+        const hit = await this.remembered(this.cacheKey(path, bytes));
+        return hit && named(path, hit);
     }
     /**
      * The extraction of `bytes` (remembered, or run in the extractor's worker
@@ -92,37 +103,47 @@ export class DocExtractService {
      * `origin`, when given, is where a fresh failure is reported.
      */
     async extract(path, bytes, origin) {
+        // The bytes are hashed BEFORE the extractor takes its copy of them.
         const key = this.cacheKey(path, bytes);
-        const remembered = await this.getCached(path, bytes);
-        if (remembered)
-            return remembered;
-        const running = this.inFlight.get(key);
-        const result = await (running ??
-            (() => {
-                // The cache write stays INSIDE the shared promise: were the entry
-                // dropped as soon as parsing settled, a read arriving during the
-                // write would miss both the cache and the in-flight map — and parse
-                // the same document again. The bytes are hashed (above) BEFORE the
-                // extractor takes its copy of them.
-                const started = (async () => {
-                    const res = await this.extractor.extract(fileExtension(path), bytes);
-                    if (res.ok) {
-                        await this.cache.put(key, { summary: res.summary, text: res.text });
-                    }
-                    else if (res.failure !== 'busy') {
-                        const until = res.failure === 'parser' ? undefined : this.now() + TIMEOUT_MEMORY_MS;
-                        await this.cache.put(key, { failed: true, message: res.message, ...(until === undefined ? {} : { until }) });
-                        if (origin)
-                            this.notifyUnreadable({ workspaceId: origin.workspaceId, path, reason: reasonOf(res.message) });
-                    }
-                    return res;
-                })().finally(() => this.inFlight.delete(key));
-                this.inFlight.set(key, started);
-                return started;
-            })());
-        if (!result.ok)
-            return { ok: false, message: result.message };
-        return { ok: true, marker: extractionMarker(path, result.summary), text: result.text };
+        return named(path, await (this.inFlight.get(key) ?? this.read(key, path, bytes, origin)));
+    }
+    /** What the cache holds for `key`, or undefined on a miss. */
+    async remembered(key) {
+        const hit = await this.cache.get(key, this.now());
+        if (!hit)
+            return undefined;
+        return hit.failed ? { ok: false, message: hit.message } : { ok: true, summary: hit.summary, text: hit.text };
+    }
+    /**
+     * One read of `bytes`, shared by every `extract` of the same key that
+     * arrives before it settles (see `inFlight`): the cache lookup, then the
+     * extraction and its cache write. The write stays INSIDE the shared
+     * promise: were the entry dropped as soon as parsing settled, a read
+     * arriving during the write would miss both the cache and the map — and
+     * parse the same document again. A failure is reported to the FIRST
+     * read's origin and path, once; `path` otherwise gives only the format,
+     * which every read of the key shares.
+     */
+    read(key, path, bytes, origin) {
+        const started = (async () => {
+            const hit = await this.remembered(key);
+            if (hit)
+                return hit;
+            const res = await this.extractor.extract(fileExtension(path), bytes);
+            if (res.ok) {
+                await this.cache.put(key, { summary: res.summary, text: res.text });
+                return { ok: true, summary: res.summary, text: res.text };
+            }
+            if (res.failure !== 'busy') {
+                const until = res.failure === 'parser' ? undefined : this.now() + TIMEOUT_MEMORY_MS;
+                await this.cache.put(key, { failed: true, message: res.message, ...(until === undefined ? {} : { until }) });
+                if (origin)
+                    this.notifyUnreadable({ workspaceId: origin.workspaceId, path, reason: reasonOf(res.message) });
+            }
+            return { ok: false, message: res.message };
+        })().finally(() => this.inFlight.delete(key));
+        this.inFlight.set(key, started);
+        return started;
     }
     /** Best-effort, like every event: a listener that throws never fails the read. */
     notifyUnreadable(doc) {

package/dist/modules/workspace/file-readers/doc-extract.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"doc-extract.service.js","sourceRoot":"","sources":["../../../../src/modules/workspace/file-readers/doc-extract.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doc-extract.service.js","sourceRoot":"","sources":["../../../../src/modules/workspace/file-readers/doc-extract.service.ts"],"names":[],"mappings":"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"}

package/dist/modules/workspace/index.d.ts

@@ -26,6 +26,14 @@ export { SpillStore } from './spill-store.js';
 export { DocExtractService } from './file-readers/doc-extract.service.js';
 export type { IDocumentExtractor } from './file-readers/document-extractor.contract.js';
 export { WorkerDocumentExtractor } from './file-readers/extract-in-worker.js';
+/**
+ * What `grep` runs a caller's pattern with: the matcher contract, its one
+ * implementation (ripgrep), and the boot check that ripgrep is there. The
+ * composition root wires them through this surface, as a suite does.
+ */
+export { compareSearchPaths, PATTERN_DIALECT, PatternRefusedError, PatternTooExpensiveError, SearchAbandonedError, SearchBusyError, type FileMatches, type IPatternMatcher, type IPatternSearch, type TreeScope, type TreeSearchOptions, } from './pattern-matcher.contract.js';
+export { RipgrepPatternMatcher, type RipgrepPatternMatcherOptions } from './ripgrep-search.js';
+export { assertRipgrep } from './ripgrep-version.js';
 export { isTextBytes } from './file-readers/text-reader.js';
 export { isUntouchedStarterPage, knowledgeFolderIsNew } from './first-run.js';
 export type { FirstRunStarter, FirstRunStarterSource, MayRead } from './first-run.js';

package/dist/modules/workspace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACtF;;;;GAIG;AACH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGnG,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACtF;;;;GAIG;AACH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGnG,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E;;;;GAIG;AACH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/modules/workspace/index.js

@@ -26,6 +26,14 @@ export { SpillStore } from './spill-store.js';
  */
 export { DocExtractService } from './file-readers/doc-extract.service.js';
 export { WorkerDocumentExtractor } from './file-readers/extract-in-worker.js';
+/**
+ * What `grep` runs a caller's pattern with: the matcher contract, its one
+ * implementation (ripgrep), and the boot check that ripgrep is there. The
+ * composition root wires them through this surface, as a suite does.
+ */
+export { compareSearchPaths, PATTERN_DIALECT, PatternRefusedError, PatternTooExpensiveError, SearchAbandonedError, SearchBusyError, } from './pattern-matcher.contract.js';
+export { RipgrepPatternMatcher } from './ripgrep-search.js';
+export { assertRipgrep } from './ripgrep-version.js';
 // Reached by other modules; exported here so they stop importing the files.
 export { isTextBytes } from './file-readers/text-reader.js';
 export { isUntouchedStarterPage, knowledgeFolderIsNew } from './first-run.js';

package/dist/modules/workspace/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,kBAAkB,GAInB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACtF;;;;GAIG;AACH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAE5B,sEAAsE;AACtE,+EAA+E;AAC/E,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,4EAA4E;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,kBAAkB,GAInB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACtF;;;;GAIG;AACH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAE5B,sEAAsE;AACtE,+EAA+E;AAC/E,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E;;;;GAIG;AACH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,GAMhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAqC,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,4EAA4E;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/modules/workspace/nul-scan.d.ts

@@ -0,0 +1,19 @@
+import { type Stats } from 'node:fs';
+import type { IPatternSearch } from './pattern-matcher.contract.js';
+/** How much of a file {@link holdsNul} holds in memory at once. */
+export declare const NUL_SCAN_CHUNK: number;
+/**
+ * Whether the file at `absolute` holds a NUL, read a chunk at a time and
+ * stopped at the first, under the search's budget: a check that outlives it
+ * is answered as the search is, and reads no further. The file is opened
+ * without following a link, and only the file that was judged (`judged`, its
+ * device and inode) is read: a link or another file swapped in since, here or
+ * in a folder above it, is not, and holds nothing.
+ *
+ * The check a named text file gets from `grep` when ripgrep answers no line
+ * from it (see `workspace.tools.ts`, `grepTextFile`): ripgrep stops reading a
+ * file at the lines the answer can take, so a NUL past them goes unseen by it,
+ * and "no searchable text" must be told from "no match" by this read.
+ */
+export declare function holdsNul(absolute: string, judged: Stats, search: IPatternSearch): Promise<boolean>;
+//# sourceMappingURL=nul-scan.d.ts.map

package/dist/modules/workspace/nul-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nul-scan.d.ts","sourceRoot":"","sources":["../../../src/modules/workspace/nul-scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,mEAAmE;AACnE,eAAO,MAAM,cAAc,QAAY,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BxG"}

package/dist/modules/workspace/nul-scan.js

@@ -0,0 +1,55 @@
+import { constants as fsConstants } from 'node:fs';
+import nodeFs from 'node:fs/promises';
+/** How much of a file {@link holdsNul} holds in memory at once. */
+export const NUL_SCAN_CHUNK = 64 * 1024;
+/**
+ * Whether the file at `absolute` holds a NUL, read a chunk at a time and
+ * stopped at the first, under the search's budget: a check that outlives it
+ * is answered as the search is, and reads no further. The file is opened
+ * without following a link, and only the file that was judged (`judged`, its
+ * device and inode) is read: a link or another file swapped in since, here or
+ * in a folder above it, is not, and holds nothing.
+ *
+ * The check a named text file gets from `grep` when ripgrep answers no line
+ * from it (see `workspace.tools.ts`, `grepTextFile`): ripgrep stops reading a
+ * file at the lines the answer can take, so a NUL past them goes unseen by it,
+ * and "no searchable text" must be told from "no match" by this read.
+ */
+export async function holdsNul(absolute, judged, search) {
+    let stopped = false;
+    try {
+        return await search.charged(async () => {
+            let handle;
+            try {
+                handle = await nodeFs.open(absolute, fsConstants.O_RDONLY | (fsConstants.O_NOFOLLOW ?? 0));
+            }
+            catch (err) {
+                // ELOOP: the name is a link now. Anything else is the caller's to answer.
+                if (err?.code === 'ELOOP')
+                    return false;
+                throw err;
+            }
+            try {
+                const opened = await handle.stat();
+                if (!opened.isFile() || opened.dev !== judged.dev || opened.ino !== judged.ino)
+                    return false;
+                const chunk = Buffer.alloc(NUL_SCAN_CHUNK);
+                while (!stopped) {
+                    const { bytesRead } = await handle.read(chunk, 0, chunk.length, null);
+                    if (bytesRead === 0)
+                        return false;
+                    if (chunk.subarray(0, bytesRead).includes(0))
+                        return true;
+                }
+                return false;
+            }
+            finally {
+                await handle.close();
+            }
+        });
+    }
+    finally {
+        stopped = true;
+    }
+}
+//# sourceMappingURL=nul-scan.js.map

package/dist/modules/workspace/nul-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nul-scan.js","sourceRoot":"","sources":["../../../src/modules/workspace/nul-scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,WAAW,EAAc,MAAM,SAAS,CAAC;AAC/D,OAAO,MAAM,MAAM,kBAAkB,CAAC;AAGtC,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB,EAAE,MAAa,EAAE,MAAsB;IACpF,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;YACrC,IAAI,MAAyB,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,GAAG,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7F,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,0EAA0E;gBAC1E,IAAK,GAAiC,EAAE,IAAI,KAAK,OAAO;oBAAE,OAAO,KAAK,CAAC;gBACvE,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACnC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG;oBAAE,OAAO,KAAK,CAAC;gBAC7F,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;gBAC3C,OAAO,CAAC,OAAO,EAAE,CAAC;oBAChB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;oBACtE,IAAI,SAAS,KAAK,CAAC;wBAAE,OAAO,KAAK,CAAC;oBAClC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;wBAAE,OAAO,IAAI,CAAC;gBAC5D,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;oBAAS,CAAC;gBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/modules/workspace/pattern-matcher.contract.d.ts

@@ -2,49 +2,132 @@ import { ToolError } from '../tool-helpers/index.js';
 /**
  * The contract for running a CALLER'S regular expression: what `grep` (REST,
  * MCP and `call_tool_chain` alike, one handler) depends on, so it never holds
- * a concrete engine. The one implementation is `WorkerPatternMatcher`
- * (`bounded-matcher.ts`), owned by the composition root and closed with the
+ * a concrete engine. The one implementation is `RipgrepPatternMatcher`
+ * (`ripgrep-search.ts`), owned by the composition root and closed with the
  * graph.
  *
- * JavaScript's engine backtracks, so a pattern like `^(a+)+$` over a line of
- * forty `a`s and a `!` never finishes. An implementation must therefore never
- * run the pattern on the request thread, must stop a search whose matching
- * outlives its budget with {@link PatternTooExpensiveError}, and must refuse
- * work it cannot take on with {@link SearchBusyError} rather than queue it
- * without bound. Within budget, a pattern matches exactly the lines
- * `RegExp#test` does.
+ * The engine is ripgrep's default one: linear-time, so no pattern can stall
+ * it, and RE2-style, so it refuses look-around and backreferences. It runs in
+ * child processes, never on the request thread. An implementation must stop a
+ * search that outlives its budget with {@link PatternTooExpensiveError},
+ * refuse a pattern its engine refuses with {@link PatternRefusedError}, and
+ * refuse work it cannot take on with {@link SearchBusyError} rather than queue
+ * it without bound.
  */
 export interface IPatternMatcher {
     /**
-     * One search's matcher for `source`/`flags`: its budget is spent across
-     * every call it makes. Throws the 400 `Invalid regex` the caller's syntax
-     * earns, or the 400 `pattern_too_long` an over-long pattern earns.
+     * One search's matcher for `pattern`: its budget is spent across every call
+     * it makes. Rejects with the 400 {@link PatternRefusedError} when the engine
+     * refuses the pattern, or the 400 `pattern_too_long` an over-long pattern
+     * earns, before any file is searched. When `signal` aborts (the caller went
+     * away), every run the search has going is killed, and the call it was
+     * serving rejects with {@link SearchAbandonedError}.
      */
-    search(source: string, flags: string): IPatternSearch;
-    /** Ends the workers; a search after this is refused. */
+    search(pattern: string, opts: {
+        ignoreCase: boolean;
+        signal?: AbortSignal;
+    }): Promise<IPatternSearch>;
+    /** Ends every running search; a search after this is refused. */
     close(): Promise<void>;
 }
-/** One search, under one budget. */
+/** Where a tree search runs: a directory, never a file. */
+export interface TreeScope {
+    /** Absolute, canonical directory the search runs in. */
+    cwd: string;
+    /** The directory searched, relative to `cwd` (`.` for `cwd` itself). */
+    root: string;
+}
+/** Which files a tree search opens, and how much of each it keeps. */
+export interface TreeSearchOptions {
+    /**
+     * The files searched, relative to the scope's `root` as
+     * {@link IPatternSearch.list} answers them; no other file is opened. A name
+     * holding a line break cannot be named to ripgrep exactly and is refused.
+     */
+    only: readonly string[];
+    /**
+     * The most lines one file answers: matching stops at it, so a file of
+     * millions of matching lines costs its first few and one look for a NUL
+     * in the rest, not a record for every line. A matching line that is not
+     * UTF-8 is not answered and does not use up the cap.
+     */
+    maxLinesPerFile: number;
+}
+/** One file's matching lines, as a tree search finds them. */
+export interface FileMatches {
+    /** The file, relative to the scope's `root`, `/`-separated. */
+    path: string;
+    /** Its matching lines, in order: 1-based numbers, the whole line without its `\n`. */
+    lines: {
+        line: number;
+        text: string;
+    }[];
+}
+/**
+ * One search, under one budget.
+ *
+ * A tree search covers every file under the scope's root: hidden files and
+ * folders, files a `.gitignore` or `.ignore` names, untracked files. It never
+ * enters a folder named `.git` (in any case), never follows a symbolic link,
+ * and reads no configuration of its own. Who may read what is not its
+ * business: the caller filters what it answers.
+ */
 export interface IPatternSearch {
     /**
-     * The indices of the lines the pattern matches, in order, at most `limit` of
-     * them (the first `limit`, exactly as a loop that stops at the cap finds).
-     * Throws {@link PatternTooExpensiveError} once the search's budget is spent.
+     * The lines the pattern matches in the `only` files under the scope, one
+     * file at a time in {@link compareSearchPaths} order, found by the same walk
+     * as {@link list}: a named path that has since become a link is not
+     * followed. A file whose content is binary contributes nothing, and neither
+     * does a line that is not UTF-8. Each file is answered as soon as ripgrep
+     * has finished it (whether a file is binary is known only then), so
+     * stopping the iteration stops the search at the file the caller had
+     * enough with.
+     */
+    files(scope: TreeScope, opts: TreeSearchOptions): AsyncIterable<FileMatches>;
+    /**
+     * Every file under the scope, relative to the root, in
+     * {@link compareSearchPaths} order: the walk {@link files} makes, without
+     * opening a file — what a caller judges before choosing what is searched.
      */
-    matchingLines(lines: string[], limit: number): Promise<number[]>;
+    list(scope: TreeScope): Promise<string[]>;
+    /**
+     * For each of `texts`, the 0-based indices of its lines (split on `\n`) that
+     * the pattern matches, in order.
+     */
+    matchingLines(texts: readonly string[]): Promise<number[][]>;
+    /**
+     * Run `work` the search waits on between its runs (judging which files the
+     * caller may read) under the search's one budget: the time it takes is
+     * spent from it, and work still running when the budget is gone is
+     * answered with {@link PatternTooExpensiveError} — or
+     * {@link SearchAbandonedError} when the caller has gone — at once, whatever
+     * `work` itself does after.
+     */
+    charged<T>(work: () => Promise<T>): Promise<T>;
 }
-/** A pattern stopped for taking too long — a 400, worded for the caller. */
+/**
+ * The order every search answers in: ripgrep's, path segment by segment, each
+ * compared by its UTF-8 bytes. Defined beside the platform's own walk order
+ * in `shared/path-order.ts`, which says how the two differ and why the search
+ * has one of its own; re-exported here because it is part of this contract.
+ */
+export { compareSearchPaths } from '../../shared/path-order.js';
+/** A search stopped for taking too long — a 400, worded for the caller. */
 export declare class PatternTooExpensiveError extends ToolError {
     constructor(pattern: string, budgetMs: number);
 }
-/** Every worker busy and the queue for one full — a 503, so the caller retries rather than reads a partial answer. */
+/** What the engine accepts, as every refusal and the tool's description say it. */
+export declare const PATTERN_DIALECT = "grep runs ripgrep's default regex engine, which takes RE2-style patterns: no look-around and no backreferences.";
+/** A pattern the engine refuses — a 400 quoting the engine's own reason. */
+export declare class PatternRefusedError extends ToolError {
+    constructor(reason: string);
+}
+/** Every search slot busy and the queue for one full — a 503, so the caller retries rather than reads a partial answer. */
 export declare class SearchBusyError extends ToolError {
     constructor();
 }
-/**
- * Whether `err` ends a whole search rather than one file's part of it: a
- * directory walk that skipped a file for either would answer an incomplete
- * result as if it were the whole one.
- */
-export declare function endsTheSearch(err: unknown): boolean;
+/** A search whose caller went away: its runs were killed, and nobody is waiting for the answer. */
+export declare class SearchAbandonedError extends ToolError {
+    constructor();
+}
 //# sourceMappingURL=pattern-matcher.contract.d.ts.map

package/dist/modules/workspace/pattern-matcher.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pattern-matcher.contract.d.ts","sourceRoot":"","sources":["../../../src/modules/workspace/pattern-matcher.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IACtD,wDAAwD;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAClE;AAED,4EAA4E;AAC5E,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAW9C;AAED,sHAAsH;AACtH,qBAAa,eAAgB,SAAQ,SAAS;;CAK7C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD"}
+{"version":3,"file":"pattern-matcher.contract.d.ts","sourceRoot":"","sources":["../../../src/modules/workspace/pattern-matcher.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACtG,iEAAiE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC7E;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7D;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,2EAA2E;AAC3E,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAU9C;AAED,mFAAmF;AACnF,eAAO,MAAM,eAAe,oHACuF,CAAC;AAEpH,4EAA4E;AAC5E,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,MAAM,EAAE,MAAM;CAI3B;AAED,2HAA2H;AAC3H,qBAAa,eAAgB,SAAQ,SAAS;;CAK7C;AAED,mGAAmG;AACnG,qBAAa,oBAAqB,SAAQ,SAAS;;CAKlD"}

package/dist/modules/workspace/pattern-matcher.contract.js

@@ -1,27 +1,44 @@
 import { ToolError } from '../tool-helpers/index.js';
-/** A pattern stopped for taking too long — a 400, worded for the caller. */
+/**
+ * The order every search answers in: ripgrep's, path segment by segment, each
+ * compared by its UTF-8 bytes. Defined beside the platform's own walk order
+ * in `shared/path-order.ts`, which says how the two differ and why the search
+ * has one of its own; re-exported here because it is part of this contract.
+ */
+export { compareSearchPaths } from '../../shared/path-order.js';
+/** A search stopped for taking too long — a 400, worded for the caller. */
 export class PatternTooExpensiveError extends ToolError {
     constructor(pattern, budgetMs) {
-        super(`Pattern too expensive: /${pattern.length > 80 ? `${pattern.slice(0, 80)}…` : pattern}/ did not finish matching within this search's ${budgetMs / 1000} s budget, ` +
-            'so it was stopped and nothing was returned. Patterns with nested or overlapping repetition such as ' +
-            '`(a+)+` or `(a|aa)*` can take exponential time on some lines. Use a simpler pattern — a literal, ' +
-            'an anchor, a character class, a single repetition — or narrow `path`.', 400, { code: 'pattern_too_expensive' });
+        super(`Pattern too expensive: /${shown(pattern)}/ did not finish within this search's ${budgetMs / 1000} s budget, ` +
+            'so it was stopped and nothing was returned. Narrow `path` to the folder you mean, or use a more ' +
+            'specific pattern.', 400, { code: 'pattern_too_expensive' });
         this.name = 'PatternTooExpensiveError';
     }
 }
-/** Every worker busy and the queue for one full — a 503, so the caller retries rather than reads a partial answer. */
+/** What the engine accepts, as every refusal and the tool's description say it. */
+export const PATTERN_DIALECT = "grep runs ripgrep's default regex engine, which takes RE2-style patterns: no look-around and no backreferences.";
+/** A pattern the engine refuses — a 400 quoting the engine's own reason. */
+export class PatternRefusedError extends ToolError {
+    constructor(reason) {
+        super(`Invalid regex: ${reason}\n${PATTERN_DIALECT}`, 400, { code: 'invalid_pattern' });
+        this.name = 'PatternRefusedError';
+    }
+}
+/** Every search slot busy and the queue for one full — a 503, so the caller retries rather than reads a partial answer. */
 export class SearchBusyError extends ToolError {
     constructor() {
         super('Too many searches are running at once; try again in a few seconds.', 503, { code: 'search_busy' });
         this.name = 'SearchBusyError';
     }
 }
-/**
- * Whether `err` ends a whole search rather than one file's part of it: a
- * directory walk that skipped a file for either would answer an incomplete
- * result as if it were the whole one.
- */
-export function endsTheSearch(err) {
-    return err instanceof PatternTooExpensiveError || err instanceof SearchBusyError;
+/** A search whose caller went away: its runs were killed, and nobody is waiting for the answer. */
+export class SearchAbandonedError extends ToolError {
+    constructor() {
+        super('The search was stopped because its caller went away.', 499, { code: 'search_abandoned' });
+        this.name = 'SearchAbandonedError';
+    }
+}
+function shown(pattern) {
+    return pattern.length > 80 ? `${pattern.slice(0, 80)}…` : pattern;
 }
 //# sourceMappingURL=pattern-matcher.contract.js.map

package/dist/modules/workspace/pattern-matcher.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"pattern-matcher.contract.js","sourceRoot":"","sources":["../../../src/modules/workspace/pattern-matcher.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAsCrD,4EAA4E;AAC5E,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACrD,YAAY,OAAe,EAAE,QAAgB;QAC3C,KAAK,CACH,2BAA2B,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,kDAAkD,QAAQ,GAAG,IAAI,aAAa;YACjK,qGAAqG;YACrG,mGAAmG;YACnG,uEAAuE,EACzE,GAAG,EACH,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAClC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,sHAAsH;AACtH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C;QACE,KAAK,CAAC,oEAAoE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAC1G,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,wBAAwB,IAAI,GAAG,YAAY,eAAe,CAAC;AACnF,CAAC"}
+{"version":3,"file":"pattern-matcher.contract.js","sourceRoot":"","sources":["../../../src/modules/workspace/pattern-matcher.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AA2GrD;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,2EAA2E;AAC3E,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACrD,YAAY,OAAe,EAAE,QAAgB;QAC3C,KAAK,CACH,2BAA2B,KAAK,CAAC,OAAO,CAAC,yCAAyC,QAAQ,GAAG,IAAI,aAAa;YAC5G,kGAAkG;YAClG,mBAAmB,EACrB,GAAG,EACH,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAClC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,eAAe,GAC1B,iHAAiH,CAAC;AAEpH,4EAA4E;AAC5E,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD,YAAY,MAAc;QACxB,KAAK,CAAC,kBAAkB,MAAM,KAAK,eAAe,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,2HAA2H;AAC3H,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C;QACE,KAAK,CAAC,oEAAoE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAC1G,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,mGAAmG;AACnG,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD;QACE,KAAK,CAAC,sDAAsD,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACjG,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,SAAS,KAAK,CAAC,OAAe;IAC5B,OAAO,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AACpE,CAAC"}