@xrkseek/harness-cli 0.1.0 → 0.1.2

package/node_modules/@xrkseek/xrk-file-reference/dist/grammar.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Browser-safe `@file` token grammar shared by terminal and web clients.
+ *
+ * @module @xrkseek/xrk-file-reference/grammar
+ */
+import type { FileReferenceCandidate } from './types.js';
+/** Active `@` token ending at the editor cursor. */
+export interface ActiveAtToken {
+    /** Complete token replaced when the user accepts a completion. */
+    prefix: string;
+    /** Path query after `@` or `@"`. */
+    query: string;
+    /** Whether the user opened a quoted path. */
+    quoted: boolean;
+}
+/**
+ * Extract an `@path` or `@"path with spaces` token at the cursor. An `@`
+ * inside another token, such as an email address, is not a completion trigger.
+ * @param line - current editor line.
+ * @param cursorCol - cursor column within that line.
+ * @returns the active token, or `undefined` outside an `@` token.
+ */
+export declare function activeAtToken(line: string, cursorCol: number): ActiveAtToken | undefined;
+/**
+ * Format a selected path as prompt text. Whitespace uses the quoted
+ * `@"path"` grammar; a quoted directory keeps that quote open after its
+ * trailing slash so completion can descend another level.
+ * @param candidate - selected file or directory.
+ * @param preserveQuote - retain an explicitly opened quote even when unnecessary.
+ * @returns the insertion value, or `undefined` for a path the editor grammar cannot represent safely.
+ */
+export declare function formatFileMention(candidate: FileReferenceCandidate, preserveQuote: boolean): string | undefined;
+//# sourceMappingURL=grammar.d.ts.map

package/node_modules/@xrkseek/xrk-file-reference/dist/grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAExD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CASxF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,sBAAsB,EACjC,aAAa,EAAE,OAAO,GACrB,MAAM,GAAG,SAAS,CAOpB"}

package/node_modules/@xrkseek/xrk-file-reference/dist/grammar.js

@@ -0,0 +1,43 @@
+/**
+ * Browser-safe `@file` token grammar shared by terminal and web clients.
+ *
+ * @module @xrkseek/xrk-file-reference/grammar
+ */
+/**
+ * Extract an `@path` or `@"path with spaces` token at the cursor. An `@`
+ * inside another token, such as an email address, is not a completion trigger.
+ * @param line - current editor line.
+ * @param cursorCol - cursor column within that line.
+ * @returns the active token, or `undefined` outside an `@` token.
+ */
+export function activeAtToken(line, cursorCol) {
+    const beforeCursor = line.slice(0, cursorCol);
+    const quoted = /(?:^|\s)(@"([^"]*))$/u.exec(beforeCursor);
+    if (quoted?.[1] !== undefined && quoted[2] !== undefined) {
+        return { prefix: quoted[1], query: quoted[2], quoted: true };
+    }
+    const plain = /(?:^|\s)(@([^\s]*))$/u.exec(beforeCursor);
+    if (plain?.[1] === undefined || plain[2] === undefined)
+        return undefined;
+    return { prefix: plain[1], query: plain[2], quoted: false };
+}
+/**
+ * Format a selected path as prompt text. Whitespace uses the quoted
+ * `@"path"` grammar; a quoted directory keeps that quote open after its
+ * trailing slash so completion can descend another level.
+ * @param candidate - selected file or directory.
+ * @param preserveQuote - retain an explicitly opened quote even when unnecessary.
+ * @returns the insertion value, or `undefined` for a path the editor grammar cannot represent safely.
+ */
+export function formatFileMention(candidate, preserveQuote) {
+    const path = candidate.kind === 'directory' ? `${candidate.path}/` : candidate.path;
+    if (/[\u0000-\u001f\u007f-\u009f"]/u.test(path))
+        return undefined;
+    const quoted = preserveQuote || /\s/u.test(path);
+    if (!quoted)
+        return `@${path}`;
+    if (candidate.kind === 'directory')
+        return `@"${path}`;
+    return `@"${path}"`;
+}
+//# sourceMappingURL=grammar.js.map

package/node_modules/@xrkseek/xrk-file-reference/dist/grammar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.js","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,SAAiB;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACzD,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IAC9D,CAAC;IACD,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACxD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACxE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC7D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiC,EACjC,aAAsB;IAEtB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAA;IACnF,IAAI,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,MAAM,GAAG,aAAa,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,IAAI,EAAE,CAAA;IAC9B,IAAI,SAAS,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,KAAK,IAAI,EAAE,CAAA;IACtD,OAAO,KAAK,IAAI,GAAG,CAAA;AACrB,CAAC"}

package/node_modules/@xrkseek/xrk-file-reference/dist/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Public file-reference discovery records. This module contains types only so
+ * generated Remote clients can consume it without Host runtime code.
+ * @module @xrkseek/xrk-file-reference/types
+ */
+/** One path-only completion candidate inside the target session cwd. */
+export interface FileReferenceCandidate {
+    /** User-facing path accepted by normal prompts and filesystem tools. */
+    path: string;
+    /** Directories keep completion open; files finish the mention. */
+    kind: 'file' | 'directory';
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@xrkseek/xrk-file-reference/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAC3B"}

package/node_modules/@xrkseek/xrk-file-reference/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Public file-reference discovery records. This module contains types only so
+ * generated Remote clients can consume it without Host runtime code.
+ * @module @xrkseek/xrk-file-reference/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/@xrkseek/xrk-file-reference/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/node_modules/@xrkseek/xrk-file-reference/package.json

@@ -8,61 +8,24 @@
     "directory": "packages/context/file-reference"
   },
   "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
   "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
     "./grammar": {
-      "types": "./src/grammar.ts",
-      "default": "./src/grammar.ts"
-    },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
+      "types": "./dist/grammar.d.ts",
+      "import": "./dist/grammar.js",
+      "default": "./dist/grammar.js"
     },
     "./types": {
-      "types": "./src/types.ts",
-      "default": "./src/types.ts"
-    },
-    "./typert": {
-      "types": "./lib/typert.host.d.ts",
-      "default": "./lib/typert.host.js"
-    },
-    "./remote": {
-      "types": "./lib/typert.remote-client.d.ts",
-      "default": "./lib/typert.remote-client.js"
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
     },
-    "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
-    "lib/index.js",
-    "lib/invariant.js",
-    "lib/types/**/*.js",
-    "lib/types/**/*.d.ts",
-    "lib/typert.host.js",
-    "lib/typert.host.d.ts",
-    "lib/typert.remote-client.js",
-    "lib/typert.remote-client.d.ts"
+    "dist",
+    "README.md",
+    "README.zh.md"
   ],
   "license": "MIT",
-  "peerDependencies": {
-    "@xrkseek/xrk-agent": "workspace:^",
-    "@xrkseek/xrk-invariants": "workspace:^",
-    "@xrkseek/xrk-typert-protocol": "workspace:^",
-    "@xrkseek/cordis": "workspace:^"
-  },
-  "devDependencies": {
-    "@xrkseek/xrk-agent": "workspace:^",
-    "@xrkseek/xrk-invariants": "workspace:^",
-    "@xrkseek/xrk-typert-protocol": "workspace:^",
-    "@xrkseek/cordis": "workspace:^"
-  },
-  "dependencies": {
-    "zod": "^4.4.3"
-  },
   "private": true
 }

package/node_modules/@xrkseek/xrk-file-reference-local/dist/search.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Host-workspace discovery for `@file` completion. The index contains paths
+ * only: selected values remain ordinary prompt text and file contents stay
+ * behind the model-facing `read` tool.
+ *
+ * @module @xrkseek/xrk-file-reference-local/search
+ */
+import type { FileReferenceCandidate } from '@xrkseek/xrk-file-reference/types';
+export { activeAtToken, formatFileMention } from '@xrkseek/xrk-file-reference/grammar';
+/** Default maximum file and directory candidates rendered for one query. */
+export declare const DEFAULT_FILE_SEARCH_MAX_RESULTS = 20;
+/** Default maximum entries retained in one workspace search index. */
+export declare const DEFAULT_FILE_SEARCH_MAX_ENTRIES = 10000;
+/** Directory basenames omitted from traversal unless the deployment overrides them. */
+export declare const DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES: readonly [".git", "node_modules"];
+/** Resolved limits and exclusions for one workspace index. */
+export interface FileSearchConfig {
+    /** Maximum ranked candidates returned for one query. */
+    maxResults: number;
+    /** Maximum indexed files and directories. */
+    maxEntries: number;
+    /** Directory basenames never traversed or offered. */
+    excludedDirectories: readonly string[];
+}
+/**
+ * Cancellable, reusable fuzzy index rooted at one agent working directory.
+ * Directory-scoped queries list live state; bare fuzzy queries share one
+ * bounded traversal until the `@` interaction ends or a tool result invalidates it.
+ */
+export declare class WorkspaceFileSearch {
+    private readonly root;
+    private readonly config;
+    private readonly excludedDirectories;
+    private generation;
+    private disposed;
+    constructor(root: string, config: FileSearchConfig);
+    /**
+     * Return ranked path candidates for the current token.
+     * @param rawQuery - path text following `@` or `@"`.
+     * @param signal - cancels this caller's wait without killing an index shared by a newer query.
+     * @returns at most `maxResults` deterministic candidates.
+     */
+    list(rawQuery: string, signal: AbortSignal): Promise<FileReferenceCandidate[]>;
+    /** Discard the current index so the next bare query observes a fresh tree. */
+    invalidate(): void;
+    /** Abort traversal and make later queries return no candidates. */
+    dispose(): void;
+    private ensureIndex;
+    private scanWorkspace;
+    private listDirectory;
+}
+//# sourceMappingURL=search.d.ts.map

package/node_modules/@xrkseek/xrk-file-reference-local/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAA;AAE/E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAEtF,4EAA4E;AAC5E,eAAO,MAAM,+BAA+B,KAAK,CAAA;AACjD,sEAAsE;AACtE,eAAO,MAAM,+BAA+B,QAAS,CAAA;AACrD,uFAAuF;AACvF,eAAO,MAAM,wCAAwC,mCAAoC,CAAA;AAEzF,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAcD;;;;GAIG;AACH,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAAQ;gBAGL,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB;IAc3C;;;;;OAKG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAkBpF,8EAA8E;IAC9E,UAAU,IAAI,IAAI;IAKlB,mEAAmE;IACnE,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,WAAW;YAgBL,aAAa;YA2Bb,aAAa;CAqB5B"}

package/node_modules/@xrkseek/xrk-file-reference-local/dist/search.js

@@ -0,0 +1,258 @@
+/**
+ * Host-workspace discovery for `@file` completion. The index contains paths
+ * only: selected values remain ordinary prompt text and file contents stay
+ * behind the model-facing `read` tool.
+ *
+ * @module @xrkseek/xrk-file-reference-local/search
+ */
+import { lstat, readdir } from 'node:fs/promises';
+import { isAbsolute, join, relative, resolve, sep } from 'node:path';
+export { activeAtToken, formatFileMention } from '@xrkseek/xrk-file-reference/grammar';
+/** Default maximum file and directory candidates rendered for one query. */
+export const DEFAULT_FILE_SEARCH_MAX_RESULTS = 20;
+/** Default maximum entries retained in one workspace search index. */
+export const DEFAULT_FILE_SEARCH_MAX_ENTRIES = 10_000;
+/** Directory basenames omitted from traversal unless the deployment overrides them. */
+export const DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES = ['.git', 'node_modules'];
+/**
+ * Cancellable, reusable fuzzy index rooted at one agent working directory.
+ * Directory-scoped queries list live state; bare fuzzy queries share one
+ * bounded traversal until the `@` interaction ends or a tool result invalidates it.
+ */
+export class WorkspaceFileSearch {
+    root;
+    config;
+    excludedDirectories;
+    generation;
+    disposed = false;
+    constructor(root, config) {
+        this.root = root;
+        this.config = config;
+        if (!Number.isSafeInteger(config.maxResults) || config.maxResults <= 0) {
+            throw new Error('file search maxResults must be a positive safe integer');
+        }
+        if (!Number.isSafeInteger(config.maxEntries) || config.maxEntries <= 0) {
+            throw new Error('file search maxEntries must be a positive safe integer');
+        }
+        if (config.excludedDirectories.some(name => name.length === 0 || name.includes('/') || name.includes('\\'))) {
+            throw new Error('file search excludedDirectories entries must be non-empty directory basenames');
+        }
+        this.excludedDirectories = new Set(config.excludedDirectories);
+    }
+    /**
+     * Return ranked path candidates for the current token.
+     * @param rawQuery - path text following `@` or `@"`.
+     * @param signal - cancels this caller's wait without killing an index shared by a newer query.
+     * @returns at most `maxResults` deterministic candidates.
+     */
+    async list(rawQuery, signal) {
+        signal.throwIfAborted();
+        if (this.disposed)
+            return [];
+        const query = rawQuery.replaceAll('\\', '/');
+        const slash = query.lastIndexOf('/');
+        if (query === '' || slash >= 0) {
+            const directory = slash < 0 ? '' : query.slice(0, slash + 1);
+            const fragment = slash < 0 ? '' : query.slice(slash + 1);
+            return this.listDirectory(directory, fragment, signal);
+        }
+        const indexed = await waitForPromise(this.ensureIndex(), signal);
+        return rankCandidates(indexed.filter(candidate => visibleForGlobalQuery(candidate.path, query)), query, this.config.maxResults);
+    }
+    /** Discard the current index so the next bare query observes a fresh tree. */
+    invalidate() {
+        this.generation?.controller.abort(new Error('file search index invalidated'));
+        this.generation = undefined;
+    }
+    /** Abort traversal and make later queries return no candidates. */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.invalidate();
+    }
+    ensureIndex() {
+        if (this.generation !== undefined)
+            return this.generation.promise;
+        const controller = new AbortController();
+        const generation = {
+            controller,
+            promise: Promise.resolve([]),
+        };
+        generation.promise = this.scanWorkspace(controller.signal).catch((error) => {
+            /* v8 ignore next -- every owned abort clears `generation` synchronously; this only protects an unexpected scan failure */
+            if (this.generation === generation)
+                this.generation = undefined;
+            throw error;
+        });
+        this.generation = generation;
+        return generation.promise;
+    }
+    async scanWorkspace(signal) {
+        const indexed = [];
+        const directories = [{ absolute: this.root, relative: '' }];
+        for (let cursor = 0; cursor < directories.length && indexed.length < this.config.maxEntries; cursor += 1) {
+            signal.throwIfAborted();
+            const directory = directories[cursor];
+            /* v8 ignore next 3 -- cursor is bounded by this exact queue's length. */
+            if (directory === undefined) {
+                throw new Error('file search selected a missing directory');
+            }
+            const entries = await readDirectory(directory.absolute, signal);
+            for (const entry of entries) {
+                signal.throwIfAborted();
+                const path = directory.relative === '' ? entry.name : `${directory.relative}/${entry.name}`;
+                if (entry.isDirectory()) {
+                    if (this.excludedDirectories.has(entry.name))
+                        continue;
+                    indexed.push({ path, kind: 'directory' });
+                    directories.push({ absolute: join(directory.absolute, entry.name), relative: path });
+                }
+                else if (entry.isFile()) {
+                    indexed.push({ path, kind: 'file' });
+                }
+                if (indexed.length >= this.config.maxEntries)
+                    break;
+            }
+        }
+        return indexed;
+    }
+    async listDirectory(displayDirectory, fragment, signal) {
+        if (displayDirectory.split('/').some(segment => this.excludedDirectories.has(segment)))
+            return [];
+        const absolute = await resolveDisplayDirectory(this.root, displayDirectory, signal);
+        if (absolute === undefined)
+            return [];
+        const entries = await readDirectory(absolute, signal);
+        const candidates = [];
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') && !fragment.startsWith('.'))
+                continue;
+            if (entry.isDirectory()) {
+                if (this.excludedDirectories.has(entry.name))
+                    continue;
+                candidates.push({ path: `${displayDirectory}${entry.name}`, kind: 'directory' });
+            }
+            else if (entry.isFile()) {
+                candidates.push({ path: `${displayDirectory}${entry.name}`, kind: 'file' });
+            }
+        }
+        return rankCandidates(candidates, fragment, this.config.maxResults);
+    }
+}
+async function resolveDisplayDirectory(root, displayDirectory, signal) {
+    const resolvedRoot = resolve(root);
+    const absolute = resolve(resolvedRoot, displayDirectory === '' ? '.' : displayDirectory);
+    const fromRoot = relative(resolvedRoot, absolute);
+    if (fromRoot === '..' || fromRoot.startsWith(`..${sep}`))
+        return undefined;
+    /* v8 ignore next -- only Windows can produce a cross-volume absolute relative path */
+    if (isAbsolute(fromRoot))
+        return undefined;
+    let current = resolvedRoot;
+    for (const segment of fromRoot.split(sep).filter(Boolean)) {
+        signal.throwIfAborted();
+        current = join(current, segment);
+        try {
+            const status = await lstat(current);
+            signal.throwIfAborted();
+            if (status.isSymbolicLink() || !status.isDirectory())
+                return undefined;
+        }
+        catch (_error) {
+            signal.throwIfAborted();
+            return undefined;
+        }
+    }
+    return absolute;
+}
+async function readDirectory(absolute, signal) {
+    signal.throwIfAborted();
+    try {
+        const entries = await readdir(absolute, { withFileTypes: true });
+        signal.throwIfAborted();
+        return entries.sort((left, right) => compareText(left.name, right.name));
+    }
+    catch (_error) {
+        signal.throwIfAborted();
+        // An unreadable/missing subtree contributes no candidates; other readable
+        // branches remain useful and autocomplete is advisory.
+        return [];
+    }
+}
+function visibleForGlobalQuery(path, query) {
+    if (query.startsWith('.') || query.includes('/.'))
+        return true;
+    return !path.split('/').some(segment => segment.startsWith('.'));
+}
+function rankCandidates(candidates, query, limit) {
+    const ranked = [];
+    for (const candidate of candidates) {
+        const score = scoreCandidate(candidate, query);
+        if (score !== undefined)
+            ranked.push({ candidate, score });
+    }
+    ranked.sort((left, right) => right.score - left.score
+        || kindRank(left.candidate.kind) - kindRank(right.candidate.kind)
+        || (query === '' ? 0 : left.candidate.path.length - right.candidate.path.length)
+        || compareText(left.candidate.path, right.candidate.path));
+    return ranked.slice(0, limit).map(entry => entry.candidate);
+}
+function scoreCandidate(candidate, query) {
+    if (query === '')
+        return 0;
+    const path = candidate.path.toLowerCase();
+    const name = path.slice(path.lastIndexOf('/') + 1);
+    const needle = query.toLowerCase();
+    const directoryBonus = candidate.kind === 'directory' ? 25 : 0;
+    if (name === needle)
+        return 1_000 + directoryBonus;
+    if (name.startsWith(needle))
+        return 900 + directoryBonus;
+    if (name.includes(needle))
+        return 700 + directoryBonus;
+    if (path.includes(needle))
+        return 500 + directoryBonus;
+    const subsequence = subsequenceScore(path, needle);
+    return subsequence === undefined ? undefined : 300 + subsequence + directoryBonus;
+}
+function subsequenceScore(target, query) {
+    let targetIndex = 0;
+    let gap = 0;
+    for (const character of query) {
+        const found = target.indexOf(character, targetIndex);
+        if (found < 0)
+            return undefined;
+        gap += found - targetIndex;
+        targetIndex = found + 1;
+    }
+    return Math.max(0, 100 - gap);
+}
+function kindRank(kind) {
+    return kind === 'directory' ? 0 : 1;
+}
+function compareText(left, right) {
+    /* v8 ignore next -- entries and candidates are unique; host enumeration
+     * order determines which comparison direction sort requests. */
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function waitForPromise(promise, signal) {
+    /* v8 ignore next -- `list()` checks this signal immediately before its synchronous call into this helper */
+    if (signal.aborted)
+        return Promise.reject(errorReason(signal.reason, 'file search aborted'));
+    return new Promise((resolvePromise, rejectPromise) => {
+        const onAbort = () => { rejectPromise(errorReason(signal.reason, 'file search aborted')); };
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise.then((value) => {
+            signal.removeEventListener('abort', onAbort);
+            resolvePromise(value);
+        }, (error) => {
+            signal.removeEventListener('abort', onAbort);
+            rejectPromise(errorReason(error, 'file search index failed'));
+        });
+    });
+}
+function errorReason(reason, fallback) {
+    return reason instanceof Error ? reason : new Error(fallback, { cause: reason });
+}
+//# sourceMappingURL=search.js.map

package/node_modules/@xrkseek/xrk-file-reference-local/dist/search.js.map

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

package/node_modules/@xrkseek/xrk-file-reference-local/package.json

@@ -8,49 +8,22 @@
     "directory": "packages/context/file-reference-local"
   },
   "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
   "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
     "./search": {
-      "types": "./src/search.ts",
-      "default": "./src/search.ts"
-    },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
+      "types": "./dist/search.d.ts",
+      "import": "./dist/search.js",
+      "default": "./dist/search.js"
     },
-    "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
-    "lib/index.js",
-    "lib/invariant.js",
-    "lib/types/**/*.js",
-    "lib/types/**/*.d.ts"
+    "dist",
+    "README.md",
+    "README.zh.md"
   ],
   "license": "MIT",
   "dependencies": {
-    "@xrkseek/schemastery": "workspace:^"
-  },
-  "peerDependencies": {
-    "@xrkseek/xrk-agent": "workspace:^",
-    "@xrkseek/xrk-file-reference": "workspace:^",
-    "@xrkseek/xrk-invariants": "workspace:^",
-    "@xrkseek/xrk-system-prompt": "workspace:^",
-    "@xrkseek/xrk-tools": "workspace:^",
-    "@xrkseek/cordis": "workspace:^"
-  },
-  "devDependencies": {
-    "@xrkseek/xrk-agent": "workspace:^",
-    "@xrkseek/xrk-file-reference": "workspace:^",
-    "@xrkseek/xrk-invariants": "workspace:^",
-    "@xrkseek/xrk-system-prompt": "workspace:^",
-    "@xrkseek/xrk-tools": "workspace:^",
-    "@xrkseek/cordis": "workspace:^"
+    "@xrkseek/xrk-file-reference": "workspace:*"
   },
   "private": true
 }

package/node_modules/@xrkseek/xrk-session-reference/dist/config.d.ts

@@ -0,0 +1,25 @@
+/** Configuration and stable diagnostics for session references. */
+/** Hard maximum references accepted by one message. */
+export declare const MAX_REFERENCES = 3;
+/** Default number of discovery candidates returned to a host. */
+export declare const DEFAULT_CANDIDATE_LIMIT = 50;
+/** Default UTF-8 budget for one rendered reference JSON object. */
+export declare const DEFAULT_MAX_REFERENCE_BYTES = 65536;
+/** Session-reference service configuration. */
+export interface Config {
+    /** Maximum distinct source sessions referenced by one message, from one to three. */
+    maxReferences?: number;
+    /** Default host candidate-list limit. */
+    candidateLimit?: number;
+    /** Maximum rendered UTF-8 bytes for one source snapshot. */
+    maxReferenceBytes?: number;
+}
+/** Stable failure codes exposed to host adapters. */
+export type SessionReferenceErrorCode = 'SESSION_REFERENCE_INVALID_CONFIG' | 'SESSION_REFERENCE_INVALID_REFERENCE' | 'SESSION_REFERENCE_SELF_REFERENCE' | 'SESSION_REFERENCE_TOO_MANY' | 'SESSION_REFERENCE_READ_FAILED' | 'SESSION_REFERENCE_BUDGET_EXCEEDED' | 'SESSION_REFERENCE_CANCELLED';
+/** Typed session-reference failure suitable for host protocol error mapping. */
+export declare class SessionReferenceError extends Error {
+    readonly code: SessionReferenceErrorCode;
+    /** @param message Human-readable diagnosis. @param code Stable routing code. @param options Optional cause. */
+    constructor(message: string, code: SessionReferenceErrorCode, options?: ErrorOptions);
+}
+//# sourceMappingURL=config.d.ts.map

package/node_modules/@xrkseek/xrk-session-reference/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,uDAAuD;AACvD,eAAO,MAAM,cAAc,IAAI,CAAA;AAC/B,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,KAAK,CAAA;AACzC,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,QAAS,CAAA;AAEjD,+CAA+C;AAC/C,MAAM,WAAW,MAAM;IACrB,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,qDAAqD;AACrD,MAAM,MAAM,yBAAyB,GACjC,kCAAkC,GAClC,qCAAqC,GACrC,kCAAkC,GAClC,4BAA4B,GAC5B,+BAA+B,GAC/B,mCAAmC,GACnC,6BAA6B,CAAA;AAEjC,gFAAgF;AAChF,qBAAa,qBAAsB,SAAQ,KAAK;IAI5C,QAAQ,CAAC,IAAI,EAAE,yBAAyB;IAH1C,+GAA+G;gBAE7G,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,yBAAyB,EACxC,OAAO,CAAC,EAAE,YAAY;CAKzB"}

package/node_modules/@xrkseek/xrk-session-reference/dist/config.js

@@ -0,0 +1,18 @@
+/** Configuration and stable diagnostics for session references. */
+/** Hard maximum references accepted by one message. */
+export const MAX_REFERENCES = 3;
+/** Default number of discovery candidates returned to a host. */
+export const DEFAULT_CANDIDATE_LIMIT = 50;
+/** Default UTF-8 budget for one rendered reference JSON object. */
+export const DEFAULT_MAX_REFERENCE_BYTES = 65_536;
+/** Typed session-reference failure suitable for host protocol error mapping. */
+export class SessionReferenceError extends Error {
+    code;
+    /** @param message Human-readable diagnosis. @param code Stable routing code. @param options Optional cause. */
+    constructor(message, code, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'SessionReferenceError';
+    }
+}
+//# sourceMappingURL=config.js.map

package/node_modules/@xrkseek/xrk-session-reference/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAA;AAC/B,iEAAiE;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAA;AACzC,mEAAmE;AACnE,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAA;AAsBjD,gFAAgF;AAChF,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAInC;IAHX,+GAA+G;IAC/G,YACE,OAAe,EACN,IAA+B,EACxC,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAHd,SAAI,GAAJ,IAAI,CAA2B;QAIxC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF"}