@deepseek-harness-tui/dsh-tui 0.8.6 → 0.8.8

package/lib/types/update.js

@@ -1,7 +1,7 @@
 import { spawn } from 'node:child_process';
-import { readFileSync } from 'node:fs';
+import { readFileSync, realpathSync, renameSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { gte, gt, lt, valid } from 'semver';
 import { shellQuote } from './utils/shellQuote.js';
@@ -225,6 +225,70 @@ export function tuiUpdatePluginArgs(profile, targetVersion) {
 export function isTransientUpdateFailure(stderr) {
     return /ENOENT|EPERM|EBUSY/i.test(stderr) && /_tmp_\d+/i.test(stderr);
 }
+/**
+ * Best-effort migrate the GLOBAL launcher to the delegating shim (0.8.7):
+ * after a successful profile update, copy this package's `bin/dsh-tui.js`
+ * and `package.json` over the global install so the launcher can never lag
+ * the profile again — the shim delegates all logic to the profile copy it
+ * just updated. Single-file-safe by contract: the new bin imports nothing
+ * from lib/ (see its header), so overwriting it inside an older global
+ * install cannot dangle a missing helper.
+ *
+ * Locating the global dir relies on argv[1] being the global `dsh-tui.js`
+ * (true when booted through the `dsh-tui` command). Source checkouts and
+ * direct `dsh --profile` boots resolve nothing — the migration is a silent
+ * no-op there. Write failures (permissions, locked files) are equally
+ * silent: the launcher-alignment warning remains the fallback diagnosis.
+ *
+ * @returns true when the global launcher files were replaced.
+ */
+export function migrateGlobalLauncher() {
+    const launcherBin = process.argv[1];
+    if (launcherBin === undefined || !launcherBin.endsWith('dsh-tui.js'))
+        return false;
+    // Walk up from the bin to the containing package; accept it only when it
+    // is OUR package and not the profile copy we are running from (junction
+    // layouts collapse both onto the same real path — copying onto ourselves
+    // would be a no-op at best).
+    let dir = dirname(resolve(launcherBin));
+    const ownDir = dirname(dirname(fileURLToPath(import.meta.url)));
+    for (let depth = 0; depth < 4; depth++) {
+        const manifest = join(dir, 'package.json');
+        try {
+            const parsed = JSON.parse(readFileSync(manifest, 'utf8'));
+            if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)
+                && parsed.name === PACKAGE_NAME) {
+                let same = false;
+                try {
+                    same = realpathSync(dir) === realpathSync(ownDir);
+                }
+                catch {
+                    same = resolve(dir) === resolve(ownDir);
+                }
+                if (same)
+                    return false;
+                // tmp + rename keeps each file atomic; a crash mid-migration leaves
+                // either the old or the new file, never a truncated one.
+                const replace = (target, source) => {
+                    const staged = `${target}.dsh-tui-migrate`;
+                    writeFileSync(staged, readFileSync(source));
+                    renameSync(staged, target);
+                };
+                replace(join(dir, 'bin', 'dsh-tui.js'), join(ownDir, 'bin', 'dsh-tui.js'));
+                replace(manifest, join(ownDir, 'package.json'));
+                return true;
+            }
+        }
+        catch {
+            // Unreadable manifest at this level — keep walking up.
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return false;
+        dir = parent;
+    }
+    return false;
+}
 /**
  * Update the installed dsh-tui package and restart the same launcher while
  * preserving the active session. The TUI must already be unmounted before
@@ -297,6 +361,13 @@ export async function updateTuiAndRestart(sessionId, profile, targetVersion) {
             return { updateCode: 1, restartCode: 1 };
         }
     }
+    // Launcher migration (0.8.7): the freshly installed profile carries the
+    // delegating shim — stamp it over the global launcher so this is the LAST
+    // time the outer copy can lag. Best-effort; the alignment warning stays as
+    // the fallback when the copy is impossible.
+    if (migrateGlobalLauncher()) {
+        process.stderr.write('dsh-tui: global launcher aligned to the delegating shim (no manual npm i -g needed anymore).\n');
+    }
     const restartCode = await runProcess(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
         env: {
             ...process.env,

package/lib/types/utils/execFileNoThrow.d.ts

@@ -4,31 +4,14 @@ export interface ExecFileNoThrowResult {
     stdout: string;
     stderr: string;
 }
-/**
- * Options for {@link execFileNoThrow}: stdin payload, timeout, and child
- * working directory.
- */
+/** Options for {@link execFileNoThrow}: stdin payload, timeout, and child
+ * working directory. */
 export interface ExecFileNoThrowOptions {
-    /** Stdin payload (OSC 52 clipboard helpers and tmux load-buffer). */
     input?: string;
-    /** Kill the child after this many milliseconds. */
     timeout?: number;
-    /**
-     * Accepted for call-site compatibility with the original execa-based
-     * implementation; `false` (the only value the Ink core passes) matches this
-     * shim's behavior of running in the current working directory.
-     */
     useCwd?: boolean;
-    /** Working directory for the child; defaults to the parent's cwd. */
     cwd?: string;
 }
-/**
- * Run a command without throwing: resolves with `{ code, stdout, stderr }`
- * even when the process exits non-zero or cannot spawn.
- * @param file - The executable path to spawn.
- * @param args - Command-line arguments; defaults to none.
- * @param options - Spawn options (input, timeout, cwd).
- * @returns The process outcome: exit code, captured stdout, and captured stderr.
- */
+/** Run a command without throwing; child output is bounded for safety. */
 export declare function execFileNoThrow(file: string, args?: readonly string[], options?: ExecFileNoThrowOptions): Promise<ExecFileNoThrowResult>;
 //# sourceMappingURL=execFileNoThrow.d.ts.map

package/lib/types/utils/execFileNoThrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execFileNoThrow.d.ts","sourceRoot":"","sources":["../../../src/utils/execFileNoThrow.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAiChC"}
+{"version":3,"file":"execFileNoThrow.d.ts","sourceRoot":"","sources":["../../../src/utils/execFileNoThrow.ts"],"names":[],"mappings":"AAKA,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED;wBACwB;AACxB,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AA6BD,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CA+BhC"}

package/lib/types/utils/execFileNoThrow.js

@@ -1,44 +1,65 @@
 import { spawn } from 'node:child_process';
-/**
- * Run a command without throwing: resolves with `{ code, stdout, stderr }`
- * even when the process exits non-zero or cannot spawn.
- * @param file - The executable path to spawn.
- * @param args - Command-line arguments; defaults to none.
- * @param options - Spawn options (input, timeout, cwd).
- * @returns The process outcome: exit code, captured stdout, and captured stderr.
- */
-export function execFileNoThrow(file, args, options) {
+import { extname } from 'node:path';
+const MAX_CAPTURE_BYTES = 64 * 1024;
+function appendBounded(chunks, chunk, total) {
+    if (total.value >= MAX_CAPTURE_BYTES)
+        return;
+    const remaining = MAX_CAPTURE_BYTES - total.value;
+    const part = chunk.subarray(0, remaining);
+    chunks.push(part);
+    total.value += part.length;
+}
+/** Quote one argument for the Windows command interpreter without flattening
+ * the caller's argv into an unquoted shell command. */
+function quoteWindowsArg(value) {
+    const escaped = value.replace(/(\\*)"/g, '$1$1\\"').replace(/(\\+)$/g, '$1$1');
+    return `"${escaped.replace(/%/g, '%%')}"`;
+}
+function spawnCommand(file, args, options) {
+    const isWindowsScript = process.platform === 'win32' && /\.(?:cmd|bat)$/iu.test(extname(file));
+    if (!isWindowsScript)
+        return spawn(file, args, { timeout: options?.timeout, cwd: options?.cwd });
+    const command = `"${[file, ...args].map(quoteWindowsArg).join(' ')}"`;
+    return spawn(process.env.ComSpec ?? 'cmd.exe', ['/d', '/s', '/c', command], {
+        timeout: options?.timeout,
+        cwd: options?.cwd,
+        windowsHide: true,
+        windowsVerbatimArguments: true,
+    });
+}
+/** Run a command without throwing; child output is bounded for safety. */
+export function execFileNoThrow(file, args = [], options) {
     return new Promise(resolve => {
-        const child = spawn(file, args ?? [], { timeout: options?.timeout, cwd: options?.cwd });
-        // Collect raw bytes and decode once at close: per-chunk toString() splits
-        // multi-byte UTF-8 characters straddling a chunk boundary into U+FFFD.
+        let child;
+        try {
+            child = spawnCommand(file, args, options);
+        }
+        catch {
+            resolve({ code: 1, stdout: '', stderr: '' });
+            return;
+        }
         const stdoutChunks = [];
         const stderrChunks = [];
-        child.stdout.on('data', (chunk) => {
-            stdoutChunks.push(chunk);
-        });
-        child.stderr.on('data', (chunk) => {
-            stderrChunks.push(chunk);
-        });
-        // A child may exit before consuming the supplied input. The resulting
-        // EPIPE/EOF belongs to that child outcome and must not crash the caller.
-        child.stdin.on('error', () => { });
-        child.on('error', () => {
-            resolve({
-                code: 1,
-                stdout: Buffer.concat(stdoutChunks).toString('utf8'),
-                stderr: Buffer.concat(stderrChunks).toString('utf8'),
-            });
-        });
-        child.on('close', code => {
+        const stdoutTotal = { value: 0 };
+        const stderrTotal = { value: 0 };
+        let settled = false;
+        const finish = (code) => {
+            if (settled)
+                return;
+            settled = true;
             resolve({
                 code,
                 stdout: Buffer.concat(stdoutChunks).toString('utf8'),
                 stderr: Buffer.concat(stderrChunks).toString('utf8'),
             });
-        });
+        };
+        child.stdout?.on('data', (chunk) => appendBounded(stdoutChunks, chunk, stdoutTotal));
+        child.stderr?.on('data', (chunk) => appendBounded(stderrChunks, chunk, stderrTotal));
+        child.stdin?.on('error', () => { });
+        child.on('error', () => finish(1));
+        child.on('close', code => finish(code));
         if (options?.input !== undefined)
-            child.stdin.write(options.input);
-        child.stdin.end();
+            child.stdin?.write(options.input);
+        child.stdin?.end();
     });
 }

package/lib/types/utils/externalEditor.d.ts

@@ -1,5 +1,5 @@
 /**
- * External editor round-trip for the prompt input (issue #123): Ctrl+X dumps
+ * External editor round-trip for the prompt input (issue #123): Ctrl+G dumps
  * the current draft into a temp file, hands the terminal to `$VISUAL` /
  * `$EDITOR` (nvim, vim, nano, `code --wait`, …), and returns the saved text
  * for the input to adopt.
@@ -16,11 +16,12 @@
  * failing restore never overrides the outcome.
  *
  * Editor resolution order mirrors readline's edit-and-execute-command:
- * `$VISUAL` → `$EDITOR` → `vi` on POSIX (always present). Windows has no
- * console-editor guarantee and `notepad` does not block, so an unresolved
- * editor there reports `unavailable` and the UI asks the user to set
- * `$EDITOR`. The variable may carry arguments (`EDITOR="code --wait"`), so
- * the command line is split quote-aware before spawning.
+ * `$VISUAL` → `$EDITOR`. There is deliberately NO fallback editor: an
+ * unresolved editor reports `unavailable` and the UI asks the user to set
+ * `$VISUAL` or `$EDITOR` (dropping someone into an unconfigured `vi` is a
+ * trap for users who don't know how to quit it). The variable may carry
+ * arguments (`EDITOR="code --wait"`), so the command line is split
+ * quote-aware before spawning.
  *
  * Windows launch: libuv resolves bare names to `.exe` on PATH but will NOT
  * execute `.cmd`/`.bat` shims (VS Code's `code` on PATH is `code.cmd`), and
@@ -37,7 +38,8 @@
  * - `edited`: the saved content differs from the draft — adopt `text`
  * - `unchanged`: the file matches the draft (modulo newline convention), or
  *   the editor exited non-zero (`:cq` abort semantics) — keep the draft
- * - `unavailable`: no editor could be resolved (Windows without `$EDITOR`)
+ * - `unavailable`: no editor could be resolved (neither `$VISUAL` nor
+ *   `$EDITOR` is set)
  * - `failed`: the editor process or the temp-file round-trip errored
  *   (`message` names the failed command or carries the fs error)
  */
@@ -59,11 +61,10 @@ export type EditorOutcome = {
 export declare function splitEditorCommand(commandLine: string): string[];
 /**
  * Resolve the editor argv from the environment. `$VISUAL` wins over
- * `$EDITOR` (readline convention); POSIX falls back to `vi`, Windows has no
- * blocking console editor fallback and returns undefined. `platform` is a
- * parameter so the Windows branch is unit-testable from CI's Linux runners.
+ * `$EDITOR` (readline convention); when neither is set there is no fallback
+ * editor — returns undefined and the caller reports `unavailable`.
  */
-export declare function resolveEditorCommand(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string[] | undefined;
+export declare function resolveEditorCommand(env?: NodeJS.ProcessEnv): string[] | undefined;
 /**
  * Windows shim resolution: a bare command like `code` usually lives on PATH
  * as `code.cmd`, which libuv refuses to execute directly. Walk PATH with

package/lib/types/utils/externalEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"externalEditor.d.ts","sourceRoot":"","sources":["../../../src/utils/externalEditor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAUH;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BhE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,EAAE,GAAG,SAAS,CAOtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAqBtC;AAKD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,CAalD;AA8CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAsDhF"}
+{"version":3,"file":"externalEditor.d.ts","sourceRoot":"","sources":["../../../src/utils/externalEditor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAUH;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BhE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,EAAE,GAAG,SAAS,CAOtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAqBtC;AAKD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,CAalD;AA8CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAsDhF"}

package/lib/types/utils/externalEditor.js

@@ -1,5 +1,5 @@
 /**
- * External editor round-trip for the prompt input (issue #123): Ctrl+X dumps
+ * External editor round-trip for the prompt input (issue #123): Ctrl+G dumps
  * the current draft into a temp file, hands the terminal to `$VISUAL` /
  * `$EDITOR` (nvim, vim, nano, `code --wait`, …), and returns the saved text
  * for the input to adopt.
@@ -16,11 +16,12 @@
  * failing restore never overrides the outcome.
  *
  * Editor resolution order mirrors readline's edit-and-execute-command:
- * `$VISUAL` → `$EDITOR` → `vi` on POSIX (always present). Windows has no
- * console-editor guarantee and `notepad` does not block, so an unresolved
- * editor there reports `unavailable` and the UI asks the user to set
- * `$EDITOR`. The variable may carry arguments (`EDITOR="code --wait"`), so
- * the command line is split quote-aware before spawning.
+ * `$VISUAL` → `$EDITOR`. There is deliberately NO fallback editor: an
+ * unresolved editor reports `unavailable` and the UI asks the user to set
+ * `$VISUAL` or `$EDITOR` (dropping someone into an unconfigured `vi` is a
+ * trap for users who don't know how to quit it). The variable may carry
+ * arguments (`EDITOR="code --wait"`), so the command line is split
+ * quote-aware before spawning.
  *
  * Windows launch: libuv resolves bare names to `.exe` on PATH but will NOT
  * execute `.cmd`/`.bat` shims (VS Code's `code` on PATH is `code.cmd`), and
@@ -76,17 +77,16 @@ export function splitEditorCommand(commandLine) {
 }
 /**
  * Resolve the editor argv from the environment. `$VISUAL` wins over
- * `$EDITOR` (readline convention); POSIX falls back to `vi`, Windows has no
- * blocking console editor fallback and returns undefined. `platform` is a
- * parameter so the Windows branch is unit-testable from CI's Linux runners.
+ * `$EDITOR` (readline convention); when neither is set there is no fallback
+ * editor — returns undefined and the caller reports `unavailable`.
  */
-export function resolveEditorCommand(env = process.env, platform = process.platform) {
+export function resolveEditorCommand(env = process.env) {
     const raw = (env.VISUAL ?? '').trim() || (env.EDITOR ?? '').trim();
     if (raw !== '') {
         const args = splitEditorCommand(raw);
         return args.length > 0 ? args : undefined;
     }
-    return platform === 'win32' ? undefined : ['vi'];
+    return undefined;
 }
 /**
  * Windows shim resolution: a bare command like `code` usually lives on PATH

package/lib/types/utils/fileSuggestions.d.ts

@@ -0,0 +1,19 @@
+export type FileCandidateKind = 'file' | 'directory';
+export interface FileCandidate {
+    id: string;
+    path: string;
+    displayPath: string;
+    name: string;
+    kind: FileCandidateKind;
+    score: number;
+}
+export interface FileSuggestionOptions {
+    topK?: number;
+    maxFiles?: number;
+    maxDirectories?: number;
+}
+export declare function isPathLikeQuery(query: string): boolean;
+export declare function fuzzySubsequenceScore(query: string, candidate: string): number | undefined;
+export declare function rankFileCandidates(candidates: readonly FileCandidate[], query: string, topK?: number): FileCandidate[];
+export declare function preserveSelection(previous: FileCandidate | undefined, next: readonly FileCandidate[], fallback?: number): number;
+//# sourceMappingURL=fileSuggestions.d.ts.map

package/lib/types/utils/fileSuggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSuggestions.d.ts","sourceRoot":"","sources":["../../../src/utils/fileSuggestions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,WAAW,CAAA;AAEpD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAID,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB1F;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,aAAa,EAAE,CAMlH;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,aAAa,EAAE,EAAE,QAAQ,SAAI,GAAG,MAAM,CAM3H"}

package/lib/types/utils/fileSuggestions.js

@@ -0,0 +1,40 @@
+const pathSeparators = /[\\/]/;
+export function isPathLikeQuery(query) {
+    return query.startsWith('.') || query.startsWith('~') || query.startsWith('/') || /^[A-Za-z]:[\\/]/.test(query) || pathSeparators.test(query);
+}
+export function fuzzySubsequenceScore(query, candidate) {
+    const needle = query.toLocaleLowerCase();
+    const haystack = candidate.toLocaleLowerCase();
+    if (!needle)
+        return 0;
+    let cursor = 0;
+    let first = -1;
+    let gaps = 0;
+    for (const char of needle) {
+        const found = haystack.indexOf(char, cursor);
+        if (found === -1)
+            return undefined;
+        if (first === -1)
+            first = found;
+        gaps += found - cursor;
+        cursor = found + 1;
+    }
+    const prefixBonus = first === 0 ? 20 : 0;
+    const boundaryBonus = first > 0 && /[\\/_. -]/.test(haystack[first - 1] ?? '') ? 8 : 0;
+    return needle.length * 10 + prefixBonus + boundaryBonus - gaps - haystack.length / 100;
+}
+export function rankFileCandidates(candidates, query, topK = 50) {
+    const ranked = candidates
+        .map(candidate => ({ ...candidate, score: fuzzySubsequenceScore(query, `${candidate.path} ${candidate.name}`) ?? -Infinity }))
+        .filter(candidate => Number.isFinite(candidate.score))
+        .sort((a, b) => b.score - a.score || a.kind.localeCompare(b.kind) || a.path.localeCompare(b.path));
+    return ranked.slice(0, Math.max(0, topK));
+}
+export function preserveSelection(previous, next, fallback = 0) {
+    if (previous) {
+        const index = next.findIndex(candidate => candidate.id === previous.id);
+        if (index >= 0)
+            return index;
+    }
+    return next.length === 0 ? 0 : Math.min(Math.max(0, fallback), next.length - 1);
+}

package/lib/types/utils/mentions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../../src/utils/mentions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAA;IACX,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;CACb;AAMD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CA8B5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAe3D"}
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../../src/utils/mentions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAA;IACX,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;CACb;AAQD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CA8B5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAe3D"}

package/lib/types/utils/mentions.js

@@ -6,7 +6,9 @@
  * either a run of non-whitespace characters (`@src/a.ts`) or a double-quoted
  * path (`@"my dir/a.ts"`, for paths containing spaces).
  */
-/** True when `ch` delimits a token (whitespace). */
+/** True when `ch` delimits a token (whitespace). Path separators and the
+ *  quote char are ordinary token characters on every platform — Windows
+ *  backslash paths must survive both caret tracking and submission. */
 const isBoundary = (ch) => ch === undefined || /\s/.test(ch);
 /** Extract every `@` mention in `text` (typed order, duplicates kept out). */
 export function extractMentions(text) {