@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/footer-data-provider.js

@@ -0,0 +1,338 @@
+import { execFile, spawnSync } from "child_process";
+import { existsSync, readFileSync, statSync, unwatchFile, watchFile } from "fs";
+import { dirname, join, resolve } from "path";
+import { closeWatcher, FS_WATCH_RETRY_DELAY_MS, watchWithErrorHandler } from "../utils/fs-watch.js";
+/**
+ * Find git metadata paths by walking up from cwd.
+ * Handles both regular git repos (.git is a directory) and worktrees (.git is a file).
+ */
+function findGitPaths(cwd) {
+    let dir = cwd;
+    while (true) {
+        const gitPath = join(dir, ".git");
+        if (existsSync(gitPath)) {
+            try {
+                const stat = statSync(gitPath);
+                if (stat.isFile()) {
+                    const content = readFileSync(gitPath, "utf8").trim();
+                    if (content.startsWith("gitdir: ")) {
+                        const gitDir = resolve(dir, content.slice(8).trim());
+                        const headPath = join(gitDir, "HEAD");
+                        if (!existsSync(headPath))
+                            return null;
+                        const commonDirPath = join(gitDir, "commondir");
+                        const commonGitDir = existsSync(commonDirPath)
+                            ? resolve(gitDir, readFileSync(commonDirPath, "utf8").trim())
+                            : gitDir;
+                        return { repoDir: dir, commonGitDir, headPath };
+                    }
+                }
+                else if (stat.isDirectory()) {
+                    const headPath = join(gitPath, "HEAD");
+                    if (!existsSync(headPath))
+                        return null;
+                    return { repoDir: dir, commonGitDir: gitPath, headPath };
+                }
+            }
+            catch {
+                return null;
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/** Ask git for the current branch. Returns null on detached HEAD or if git is unavailable. */
+function resolveBranchWithGitSync(repoDir) {
+    const result = spawnSync("git", ["--no-optional-locks", "symbolic-ref", "--quiet", "--short", "HEAD"], {
+        cwd: repoDir,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+    });
+    const branch = result.status === 0 ? result.stdout.trim() : "";
+    return branch || null;
+}
+/** Ask git for the current branch asynchronously. Returns null on detached HEAD or if git is unavailable. */
+function resolveBranchWithGitAsync(repoDir) {
+    return new Promise((resolvePromise) => {
+        execFile("git", ["--no-optional-locks", "symbolic-ref", "--quiet", "--short", "HEAD"], {
+            cwd: repoDir,
+            encoding: "utf8",
+        }, (error, stdout) => {
+            if (error) {
+                resolvePromise(null);
+                return;
+            }
+            const branch = stdout.trim();
+            resolvePromise(branch || null);
+        });
+    });
+}
+function isWslEnvironment() {
+    return process.platform === "linux" && !!(process.env.WSL_DISTRO_NAME || process.env.WSL_INTEROP);
+}
+function isWindowsMountedRepoPath(repoDir) {
+    return /^\/mnt\/[a-z](?:\/|$)/i.test(repoDir);
+}
+function shouldPollGitHead(repoDir) {
+    return isWslEnvironment() && isWindowsMountedRepoPath(repoDir);
+}
+/**
+ * Provides git branch and extension statuses - data not otherwise accessible to extensions.
+ * Token stats, model info available via ctx.sessionManager and ctx.model.
+ */
+export class FooterDataProvider {
+    cwd;
+    static WATCH_DEBOUNCE_MS = 500;
+    extensionStatuses = new Map();
+    cachedBranch = undefined;
+    gitPaths = undefined;
+    headWatcher = null;
+    headWatchFilePath = null;
+    headWatchFileListener = null;
+    reftableWatcher = null;
+    reftableTablesListWatcher = null;
+    reftableTablesListPath = null;
+    branchChangeCallbacks = new Set();
+    availableProviderCount = 0;
+    refreshTimer = null;
+    gitWatcherRetryTimer = null;
+    refreshInFlight = false;
+    refreshPending = false;
+    disposed = false;
+    constructor(cwd) {
+        this.cwd = cwd;
+        this.gitPaths = findGitPaths(cwd);
+        this.setupGitWatcher();
+    }
+    /** Current git branch, null if not in repo, "detached" if detached HEAD */
+    getGitBranch() {
+        if (this.cachedBranch === undefined) {
+            this.cachedBranch = this.resolveGitBranchSync();
+        }
+        return this.cachedBranch;
+    }
+    /** Extension status texts set via ctx.ui.setStatus() */
+    getExtensionStatuses() {
+        return this.extensionStatuses;
+    }
+    /** Subscribe to git branch changes. Returns unsubscribe function. */
+    onBranchChange(callback) {
+        this.branchChangeCallbacks.add(callback);
+        return () => this.branchChangeCallbacks.delete(callback);
+    }
+    /** Internal: set extension status */
+    setExtensionStatus(key, text) {
+        if (text === undefined) {
+            this.extensionStatuses.delete(key);
+        }
+        else {
+            this.extensionStatuses.set(key, text);
+        }
+    }
+    /** Internal: clear extension statuses */
+    clearExtensionStatuses() {
+        this.extensionStatuses.clear();
+    }
+    /** Number of unique providers with available models (for footer display) */
+    getAvailableProviderCount() {
+        return this.availableProviderCount;
+    }
+    /** Internal: update available provider count */
+    setAvailableProviderCount(count) {
+        this.availableProviderCount = count;
+    }
+    setCwd(cwd) {
+        if (this.cwd === cwd) {
+            return;
+        }
+        this.cwd = cwd;
+        if (this.refreshTimer) {
+            clearTimeout(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+        this.clearGitWatchers();
+        this.cachedBranch = undefined;
+        this.gitPaths = findGitPaths(cwd);
+        this.setupGitWatcher();
+        this.notifyBranchChange();
+    }
+    /** Internal: cleanup */
+    dispose() {
+        this.disposed = true;
+        if (this.refreshTimer) {
+            clearTimeout(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+        this.clearGitWatchers();
+        this.branchChangeCallbacks.clear();
+    }
+    notifyBranchChange() {
+        for (const cb of this.branchChangeCallbacks)
+            cb();
+    }
+    scheduleRefresh() {
+        if (this.disposed || this.refreshTimer)
+            return;
+        if (this.refreshInFlight) {
+            this.refreshPending = true;
+            return;
+        }
+        this.refreshTimer = setTimeout(() => {
+            this.refreshTimer = null;
+            void this.refreshGitBranchAsync();
+        }, FooterDataProvider.WATCH_DEBOUNCE_MS);
+    }
+    async refreshGitBranchAsync() {
+        if (this.disposed)
+            return;
+        if (this.refreshInFlight) {
+            this.refreshPending = true;
+            return;
+        }
+        this.refreshInFlight = true;
+        try {
+            const nextBranch = await this.resolveGitBranchAsync();
+            if (this.disposed)
+                return;
+            if (this.cachedBranch !== undefined && this.cachedBranch !== nextBranch) {
+                this.cachedBranch = nextBranch;
+                this.notifyBranchChange();
+                return;
+            }
+            this.cachedBranch = nextBranch;
+        }
+        finally {
+            this.refreshInFlight = false;
+            if (this.refreshPending && !this.disposed) {
+                this.refreshPending = false;
+                this.scheduleRefresh();
+            }
+        }
+    }
+    resolveGitBranchSync() {
+        try {
+            if (!this.gitPaths)
+                return null;
+            const content = readFileSync(this.gitPaths.headPath, "utf8").trim();
+            if (content.startsWith("ref: refs/heads/")) {
+                const branch = content.slice(16);
+                return branch === ".invalid" ? (resolveBranchWithGitSync(this.gitPaths.repoDir) ?? "detached") : branch;
+            }
+            return "detached";
+        }
+        catch {
+            return null;
+        }
+    }
+    async resolveGitBranchAsync() {
+        try {
+            if (!this.gitPaths)
+                return null;
+            const content = readFileSync(this.gitPaths.headPath, "utf8").trim();
+            if (content.startsWith("ref: refs/heads/")) {
+                const branch = content.slice(16);
+                return branch === ".invalid"
+                    ? ((await resolveBranchWithGitAsync(this.gitPaths.repoDir)) ?? "detached")
+                    : branch;
+            }
+            return "detached";
+        }
+        catch {
+            return null;
+        }
+    }
+    clearGitWatchers() {
+        closeWatcher(this.headWatcher);
+        this.headWatcher = null;
+        if (this.headWatchFilePath && this.headWatchFileListener) {
+            unwatchFile(this.headWatchFilePath, this.headWatchFileListener);
+            this.headWatchFilePath = null;
+            this.headWatchFileListener = null;
+        }
+        closeWatcher(this.reftableWatcher);
+        this.reftableWatcher = null;
+        closeWatcher(this.reftableTablesListWatcher);
+        this.reftableTablesListWatcher = null;
+        if (this.reftableTablesListPath) {
+            unwatchFile(this.reftableTablesListPath);
+            this.reftableTablesListPath = null;
+        }
+        if (this.gitWatcherRetryTimer) {
+            clearTimeout(this.gitWatcherRetryTimer);
+            this.gitWatcherRetryTimer = null;
+        }
+    }
+    scheduleGitWatcherRetry() {
+        if (this.disposed || this.gitWatcherRetryTimer) {
+            return;
+        }
+        this.gitWatcherRetryTimer = setTimeout(() => {
+            this.gitWatcherRetryTimer = null;
+            this.setupGitWatcher();
+        }, FS_WATCH_RETRY_DELAY_MS);
+    }
+    handleGitWatcherError() {
+        this.clearGitWatchers();
+        this.scheduleGitWatcherRetry();
+    }
+    setupGitWatcher() {
+        this.clearGitWatchers();
+        if (!this.gitPaths)
+            return;
+        const pollGitHead = shouldPollGitHead(this.gitPaths.repoDir);
+        // Watch the directory containing HEAD, not HEAD itself.
+        // Git uses atomic writes (write temp, rename over HEAD), which changes the inode.
+        // fs.watch on a file stops working after the inode changes.
+        this.headWatcher = watchWithErrorHandler(dirname(this.gitPaths.headPath), (_eventType, filename) => {
+            if (!filename || filename === "HEAD") {
+                this.scheduleRefresh();
+            }
+        }, () => this.handleGitWatcherError());
+        if (pollGitHead) {
+            this.headWatchFilePath = this.gitPaths.headPath;
+            this.headWatchFileListener = (current, previous) => {
+                if (current.mtimeMs !== previous.mtimeMs ||
+                    current.ctimeMs !== previous.ctimeMs ||
+                    current.size !== previous.size) {
+                    this.scheduleRefresh();
+                }
+            };
+            watchFile(this.headWatchFilePath, { interval: 1000 }, this.headWatchFileListener);
+        }
+        if (!this.headWatcher && !pollGitHead) {
+            return;
+        }
+        // In reftable repos, branch switches update files in the reftable directory
+        // instead of HEAD. Watch it separately so the footer picks up those changes.
+        const reftableDir = join(this.gitPaths.commonGitDir, "reftable");
+        if (existsSync(reftableDir)) {
+            this.reftableWatcher = watchWithErrorHandler(reftableDir, () => {
+                this.scheduleRefresh();
+            }, () => this.handleGitWatcherError());
+            if (!this.reftableWatcher) {
+                return;
+            }
+            const tablesListPath = join(reftableDir, "tables.list");
+            if (existsSync(tablesListPath)) {
+                this.reftableTablesListPath = tablesListPath;
+                this.reftableTablesListWatcher = watchWithErrorHandler(tablesListPath, () => {
+                    this.scheduleRefresh();
+                }, () => this.handleGitWatcherError());
+                if (!this.reftableTablesListWatcher) {
+                    return;
+                }
+                watchFile(tablesListPath, { interval: 250 }, (current, previous) => {
+                    if (current.mtimeMs !== previous.mtimeMs ||
+                        current.ctimeMs !== previous.ctimeMs ||
+                        current.size !== previous.size) {
+                        this.scheduleRefresh();
+                    }
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=footer-data-provider.js.map

package/dist/core/footer-data-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer-data-provider.js","sourceRoot":"","sources":["../../src/core/footer-data-provider.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ExecFileException, execFile, spawnSync } from \"child_process\";\nimport { existsSync, type FSWatcher, readFileSync, type Stats, statSync, unwatchFile, watchFile } from \"fs\";\nimport { dirname, join, resolve } from \"path\";\nimport { closeWatcher, FS_WATCH_RETRY_DELAY_MS, watchWithErrorHandler } from \"../utils/fs-watch.ts\";\n\ntype GitPaths = {\n\trepoDir: string;\n\tcommonGitDir: string;\n\theadPath: string;\n};\n\n/**\n * Find git metadata paths by walking up from cwd.\n * Handles both regular git repos (.git is a directory) and worktrees (.git is a file).\n */\nfunction findGitPaths(cwd: string): GitPaths | null {\n\tlet dir = cwd;\n\twhile (true) {\n\t\tconst gitPath = join(dir, \".git\");\n\t\tif (existsSync(gitPath)) {\n\t\t\ttry {\n\t\t\t\tconst stat = statSync(gitPath);\n\t\t\t\tif (stat.isFile()) {\n\t\t\t\t\tconst content = readFileSync(gitPath, \"utf8\").trim();\n\t\t\t\t\tif (content.startsWith(\"gitdir: \")) {\n\t\t\t\t\t\tconst gitDir = resolve(dir, content.slice(8).trim());\n\t\t\t\t\t\tconst headPath = join(gitDir, \"HEAD\");\n\t\t\t\t\t\tif (!existsSync(headPath)) return null;\n\t\t\t\t\t\tconst commonDirPath = join(gitDir, \"commondir\");\n\t\t\t\t\t\tconst commonGitDir = existsSync(commonDirPath)\n\t\t\t\t\t\t\t? resolve(gitDir, readFileSync(commonDirPath, \"utf8\").trim())\n\t\t\t\t\t\t\t: gitDir;\n\t\t\t\t\t\treturn { repoDir: dir, commonGitDir, headPath };\n\t\t\t\t\t}\n\t\t\t\t} else if (stat.isDirectory()) {\n\t\t\t\t\tconst headPath = join(gitPath, \"HEAD\");\n\t\t\t\t\tif (!existsSync(headPath)) return null;\n\t\t\t\t\treturn { repoDir: dir, commonGitDir: gitPath, headPath };\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t}\n\t\tconst parent = dirname(dir);\n\t\tif (parent === dir) return null;\n\t\tdir = parent;\n\t}\n}\n\n/** Ask git for the current branch. Returns null on detached HEAD or if git is unavailable. */\nfunction resolveBranchWithGitSync(repoDir: string): string | null {\n\tconst result = spawnSync(\"git\", [\"--no-optional-locks\", \"symbolic-ref\", \"--quiet\", \"--short\", \"HEAD\"], {\n\t\tcwd: repoDir,\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t});\n\tconst branch = result.status === 0 ? result.stdout.trim() : \"\";\n\treturn branch || null;\n}\n\n/** Ask git for the current branch asynchronously. Returns null on detached HEAD or if git is unavailable. */\nfunction resolveBranchWithGitAsync(repoDir: string): Promise<string | null> {\n\treturn new Promise((resolvePromise) => {\n\t\texecFile(\n\t\t\t\"git\",\n\t\t\t[\"--no-optional-locks\", \"symbolic-ref\", \"--quiet\", \"--short\", \"HEAD\"],\n\t\t\t{\n\t\t\t\tcwd: repoDir,\n\t\t\t\tencoding: \"utf8\",\n\t\t\t},\n\t\t\t(error: ExecFileException | null, stdout: string) => {\n\t\t\t\tif (error) {\n\t\t\t\t\tresolvePromise(null);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst branch = stdout.trim();\n\t\t\t\tresolvePromise(branch || null);\n\t\t\t},\n\t\t);\n\t});\n}\n\nfunction isWslEnvironment(): boolean {\n\treturn process.platform === \"linux\" && !!(process.env.WSL_DISTRO_NAME || process.env.WSL_INTEROP);\n}\n\nfunction isWindowsMountedRepoPath(repoDir: string): boolean {\n\treturn /^\\/mnt\\/[a-z](?:\\/|$)/i.test(repoDir);\n}\n\nfunction shouldPollGitHead(repoDir: string): boolean {\n\treturn isWslEnvironment() && isWindowsMountedRepoPath(repoDir);\n}\n\n/**\n * Provides git branch and extension statuses - data not otherwise accessible to extensions.\n * Token stats, model info available via ctx.sessionManager and ctx.model.\n */\nexport class FooterDataProvider {\n\tprivate cwd: string;\n\tprivate static readonly WATCH_DEBOUNCE_MS = 500;\n\n\tprivate extensionStatuses = new Map<string, string>();\n\tprivate cachedBranch: string | null | undefined = undefined;\n\tprivate gitPaths: GitPaths | null | undefined = undefined;\n\tprivate headWatcher: FSWatcher | null = null;\n\tprivate headWatchFilePath: string | null = null;\n\tprivate headWatchFileListener: ((current: Stats, previous: Stats) => void) | null = null;\n\tprivate reftableWatcher: FSWatcher | null = null;\n\tprivate reftableTablesListWatcher: FSWatcher | null = null;\n\tprivate reftableTablesListPath: string | null = null;\n\tprivate branchChangeCallbacks = new Set<() => void>();\n\tprivate availableProviderCount = 0;\n\tprivate refreshTimer: ReturnType<typeof setTimeout> | null = null;\n\tprivate gitWatcherRetryTimer: ReturnType<typeof setTimeout> | null = null;\n\tprivate refreshInFlight = false;\n\tprivate refreshPending = false;\n\tprivate disposed = false;\n\n\tconstructor(cwd: string) {\n\t\tthis.cwd = cwd;\n\t\tthis.gitPaths = findGitPaths(cwd);\n\t\tthis.setupGitWatcher();\n\t}\n\n\t/** Current git branch, null if not in repo, \"detached\" if detached HEAD */\n\tgetGitBranch(): string | null {\n\t\tif (this.cachedBranch === undefined) {\n\t\t\tthis.cachedBranch = this.resolveGitBranchSync();\n\t\t}\n\t\treturn this.cachedBranch;\n\t}\n\n\t/** Extension status texts set via ctx.ui.setStatus() */\n\tgetExtensionStatuses(): ReadonlyMap<string, string> {\n\t\treturn this.extensionStatuses;\n\t}\n\n\t/** Subscribe to git branch changes. Returns unsubscribe function. */\n\tonBranchChange(callback: () => void): () => void {\n\t\tthis.branchChangeCallbacks.add(callback);\n\t\treturn () => this.branchChangeCallbacks.delete(callback);\n\t}\n\n\t/** Internal: set extension status */\n\tsetExtensionStatus(key: string, text: string | undefined): void {\n\t\tif (text === undefined) {\n\t\t\tthis.extensionStatuses.delete(key);\n\t\t} else {\n\t\t\tthis.extensionStatuses.set(key, text);\n\t\t}\n\t}\n\n\t/** Internal: clear extension statuses */\n\tclearExtensionStatuses(): void {\n\t\tthis.extensionStatuses.clear();\n\t}\n\n\t/** Number of unique providers with available models (for footer display) */\n\tgetAvailableProviderCount(): number {\n\t\treturn this.availableProviderCount;\n\t}\n\n\t/** Internal: update available provider count */\n\tsetAvailableProviderCount(count: number): void {\n\t\tthis.availableProviderCount = count;\n\t}\n\n\tsetCwd(cwd: string): void {\n\t\tif (this.cwd === cwd) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.cwd = cwd;\n\t\tif (this.refreshTimer) {\n\t\t\tclearTimeout(this.refreshTimer);\n\t\t\tthis.refreshTimer = null;\n\t\t}\n\t\tthis.clearGitWatchers();\n\t\tthis.cachedBranch = undefined;\n\t\tthis.gitPaths = findGitPaths(cwd);\n\t\tthis.setupGitWatcher();\n\t\tthis.notifyBranchChange();\n\t}\n\n\t/** Internal: cleanup */\n\tdispose(): void {\n\t\tthis.disposed = true;\n\t\tif (this.refreshTimer) {\n\t\t\tclearTimeout(this.refreshTimer);\n\t\t\tthis.refreshTimer = null;\n\t\t}\n\t\tthis.clearGitWatchers();\n\t\tthis.branchChangeCallbacks.clear();\n\t}\n\n\tprivate notifyBranchChange(): void {\n\t\tfor (const cb of this.branchChangeCallbacks) cb();\n\t}\n\n\tprivate scheduleRefresh(): void {\n\t\tif (this.disposed || this.refreshTimer) return;\n\t\tif (this.refreshInFlight) {\n\t\t\tthis.refreshPending = true;\n\t\t\treturn;\n\t\t}\n\t\tthis.refreshTimer = setTimeout(() => {\n\t\t\tthis.refreshTimer = null;\n\t\t\tvoid this.refreshGitBranchAsync();\n\t\t}, FooterDataProvider.WATCH_DEBOUNCE_MS);\n\t}\n\n\tprivate async refreshGitBranchAsync(): Promise<void> {\n\t\tif (this.disposed) return;\n\t\tif (this.refreshInFlight) {\n\t\t\tthis.refreshPending = true;\n\t\t\treturn;\n\t\t}\n\n\t\tthis.refreshInFlight = true;\n\t\ttry {\n\t\t\tconst nextBranch = await this.resolveGitBranchAsync();\n\t\t\tif (this.disposed) return;\n\t\t\tif (this.cachedBranch !== undefined && this.cachedBranch !== nextBranch) {\n\t\t\t\tthis.cachedBranch = nextBranch;\n\t\t\t\tthis.notifyBranchChange();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.cachedBranch = nextBranch;\n\t\t} finally {\n\t\t\tthis.refreshInFlight = false;\n\t\t\tif (this.refreshPending && !this.disposed) {\n\t\t\t\tthis.refreshPending = false;\n\t\t\t\tthis.scheduleRefresh();\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate resolveGitBranchSync(): string | null {\n\t\ttry {\n\t\t\tif (!this.gitPaths) return null;\n\t\t\tconst content = readFileSync(this.gitPaths.headPath, \"utf8\").trim();\n\t\t\tif (content.startsWith(\"ref: refs/heads/\")) {\n\t\t\t\tconst branch = content.slice(16);\n\t\t\t\treturn branch === \".invalid\" ? (resolveBranchWithGitSync(this.gitPaths.repoDir) ?? \"detached\") : branch;\n\t\t\t}\n\t\t\treturn \"detached\";\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\tprivate async resolveGitBranchAsync(): Promise<string | null> {\n\t\ttry {\n\t\t\tif (!this.gitPaths) return null;\n\t\t\tconst content = readFileSync(this.gitPaths.headPath, \"utf8\").trim();\n\t\t\tif (content.startsWith(\"ref: refs/heads/\")) {\n\t\t\t\tconst branch = content.slice(16);\n\t\t\t\treturn branch === \".invalid\"\n\t\t\t\t\t? ((await resolveBranchWithGitAsync(this.gitPaths.repoDir)) ?? \"detached\")\n\t\t\t\t\t: branch;\n\t\t\t}\n\t\t\treturn \"detached\";\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\tprivate clearGitWatchers(): void {\n\t\tcloseWatcher(this.headWatcher);\n\t\tthis.headWatcher = null;\n\t\tif (this.headWatchFilePath && this.headWatchFileListener) {\n\t\t\tunwatchFile(this.headWatchFilePath, this.headWatchFileListener);\n\t\t\tthis.headWatchFilePath = null;\n\t\t\tthis.headWatchFileListener = null;\n\t\t}\n\t\tcloseWatcher(this.reftableWatcher);\n\t\tthis.reftableWatcher = null;\n\t\tcloseWatcher(this.reftableTablesListWatcher);\n\t\tthis.reftableTablesListWatcher = null;\n\t\tif (this.reftableTablesListPath) {\n\t\t\tunwatchFile(this.reftableTablesListPath);\n\t\t\tthis.reftableTablesListPath = null;\n\t\t}\n\t\tif (this.gitWatcherRetryTimer) {\n\t\t\tclearTimeout(this.gitWatcherRetryTimer);\n\t\t\tthis.gitWatcherRetryTimer = null;\n\t\t}\n\t}\n\n\tprivate scheduleGitWatcherRetry(): void {\n\t\tif (this.disposed || this.gitWatcherRetryTimer) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.gitWatcherRetryTimer = setTimeout(() => {\n\t\t\tthis.gitWatcherRetryTimer = null;\n\t\t\tthis.setupGitWatcher();\n\t\t}, FS_WATCH_RETRY_DELAY_MS);\n\t}\n\n\tprivate handleGitWatcherError(): void {\n\t\tthis.clearGitWatchers();\n\t\tthis.scheduleGitWatcherRetry();\n\t}\n\n\tprivate setupGitWatcher(): void {\n\t\tthis.clearGitWatchers();\n\t\tif (!this.gitPaths) return;\n\n\t\tconst pollGitHead = shouldPollGitHead(this.gitPaths.repoDir);\n\n\t\t// Watch the directory containing HEAD, not HEAD itself.\n\t\t// Git uses atomic writes (write temp, rename over HEAD), which changes the inode.\n\t\t// fs.watch on a file stops working after the inode changes.\n\t\tthis.headWatcher = watchWithErrorHandler(\n\t\t\tdirname(this.gitPaths.headPath),\n\t\t\t(_eventType, filename) => {\n\t\t\t\tif (!filename || filename === \"HEAD\") {\n\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => this.handleGitWatcherError(),\n\t\t);\n\t\tif (pollGitHead) {\n\t\t\tthis.headWatchFilePath = this.gitPaths.headPath;\n\t\t\tthis.headWatchFileListener = (current, previous) => {\n\t\t\t\tif (\n\t\t\t\t\tcurrent.mtimeMs !== previous.mtimeMs ||\n\t\t\t\t\tcurrent.ctimeMs !== previous.ctimeMs ||\n\t\t\t\t\tcurrent.size !== previous.size\n\t\t\t\t) {\n\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t}\n\t\t\t};\n\t\t\twatchFile(this.headWatchFilePath, { interval: 1000 }, this.headWatchFileListener);\n\t\t}\n\t\tif (!this.headWatcher && !pollGitHead) {\n\t\t\treturn;\n\t\t}\n\n\t\t// In reftable repos, branch switches update files in the reftable directory\n\t\t// instead of HEAD. Watch it separately so the footer picks up those changes.\n\t\tconst reftableDir = join(this.gitPaths.commonGitDir, \"reftable\");\n\t\tif (existsSync(reftableDir)) {\n\t\t\tthis.reftableWatcher = watchWithErrorHandler(\n\t\t\t\treftableDir,\n\t\t\t\t() => {\n\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t},\n\t\t\t\t() => this.handleGitWatcherError(),\n\t\t\t);\n\t\t\tif (!this.reftableWatcher) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst tablesListPath = join(reftableDir, \"tables.list\");\n\t\t\tif (existsSync(tablesListPath)) {\n\t\t\t\tthis.reftableTablesListPath = tablesListPath;\n\t\t\t\tthis.reftableTablesListWatcher = watchWithErrorHandler(\n\t\t\t\t\ttablesListPath,\n\t\t\t\t\t() => {\n\t\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t\t},\n\t\t\t\t\t() => this.handleGitWatcherError(),\n\t\t\t\t);\n\t\t\t\tif (!this.reftableTablesListWatcher) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\twatchFile(tablesListPath, { interval: 250 }, (current, previous) => {\n\t\t\t\t\tif (\n\t\t\t\t\t\tcurrent.mtimeMs !== previous.mtimeMs ||\n\t\t\t\t\t\tcurrent.ctimeMs !== previous.ctimeMs ||\n\t\t\t\t\t\tcurrent.size !== previous.size\n\t\t\t\t\t) {\n\t\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n}\n\n/** Read-only view for extensions - excludes setExtensionStatus, setAvailableProviderCount and dispose */\nexport type ReadonlyFooterDataProvider = Pick<\n\tFooterDataProvider,\n\t\"getGitBranch\" | \"getExtensionStatuses\" | \"getAvailableProviderCount\" | \"onBranchChange\"\n>;\n"]}

package/dist/core/host-actions.d.ts

@@ -0,0 +1,107 @@
+import type { ThinkingLevel } from "@hansjm10/volt-agent-core";
+import type { Api, Model } from "@hansjm10/volt-ai";
+import type { AgentSessionRuntime } from "./agent-session-runtime.ts";
+import type { ReviewTarget, ReviewWorkflowResult } from "./review.ts";
+import type { UiActionArgumentDescriptor, UiActionDescriptor, UiActionInvocationResponse, UiActionSlashAlias, UiActionStateDescriptor } from "./rpc/types.ts";
+type RuntimeNewSession = AgentSessionRuntime["newSession"];
+type RuntimeSession = AgentSessionRuntime["session"];
+export type HostActionNewSessionOptions = Parameters<RuntimeNewSession>[0];
+export type HostActionNewSessionResult = Awaited<ReturnType<RuntimeNewSession>>;
+export type HostActionCompactResult = Awaited<ReturnType<RuntimeSession["compact"]>>;
+export interface HostActionSessionState {
+    /** Falls back to isStreaming for legacy host integrations. */
+    isBusy?: boolean;
+    isStreaming: boolean;
+    isCompacting: boolean;
+    model?: Model<Api>;
+    thinkingLevel?: ThinkingLevel;
+    fastModeRestoreThinkingLevel?: ThinkingLevel;
+}
+export interface HostActionDescriptorContext {
+    session: HostActionSessionState;
+}
+export interface HostActionInvocationContext extends HostActionDescriptorContext {
+    abortRun(): Promise<void>;
+    compactContext(customInstructions?: string): Promise<HostActionCompactResult>;
+    newSession(options?: HostActionNewSessionOptions): Promise<HostActionNewSessionResult>;
+    afterSessionSwitch?: () => Promise<void>;
+    renameSession(name: string): void;
+    setThinkingLevel?(level: ThinkingLevel, options?: {
+        persistDefault?: boolean;
+        preserveFastMode?: boolean;
+    }): void;
+    setFastModeRestoreThinkingLevel?(level: ThinkingLevel | undefined): void;
+    runReviewAction?(target: ReviewTarget, options: HostActionReviewOptions): Promise<ReviewWorkflowResult>;
+}
+export type HostActionAvailability = {
+    enabled: true;
+    disabledReason?: null;
+} | {
+    enabled: false;
+    disabledReason: string;
+};
+export interface HostActionDefinition {
+    id: string;
+    label: string;
+    description?: string;
+    category: UiActionDescriptor["category"];
+    presentation: UiActionDescriptor["presentation"];
+    args?: ReadonlyArray<UiActionArgumentDescriptor>;
+    destructive?: boolean;
+    requiresConfirmation?: boolean;
+    streamingBehavior?: UiActionDescriptor["streamingBehavior"];
+    remoteSafe: boolean;
+    state?: UiActionStateDescriptor | ((context: HostActionDescriptorContext) => UiActionStateDescriptor | undefined);
+    slashAliases?: ReadonlyArray<UiActionSlashAlias>;
+    slash?: UiActionSlashAlias;
+    availability?: (context: HostActionDescriptorContext) => HostActionAvailability;
+    handler: (context: HostActionInvocationContext, args: unknown, options: HostActionInvokeOptions) => Promise<UiActionInvocationResponse>;
+}
+export interface HostActionInvokeOptions {
+    requireRemoteSafe?: boolean;
+}
+export interface HostActionSlashCommand {
+    name: string;
+    description: string;
+}
+export declare const CONTEXT_COMPACT_ACTION_ID = "context.compact";
+export declare const CONTEXT_COMPACT_SLASH_ALIAS = "compact";
+export declare const REVIEW_BRANCH_ACTION_ID = "review.branch";
+export declare const REVIEW_UNCOMMITTED_ACTION_ID = "review.uncommitted";
+export declare const RUN_CANCEL_ACTION_ID = "run.cancel";
+export declare const SESSION_NEW_ACTION_ID = "session.new";
+export declare const SESSION_NEW_SLASH_ALIAS = "clear";
+export declare const SESSION_RENAME_ACTION_ID = "session.rename";
+export declare const SESSION_RENAME_SLASH_ALIAS = "name";
+export declare const THINKING_FAST_MODE_ACTION_ID = "thinking.fast_mode";
+export interface HostActionReviewOptions {
+    remote: boolean;
+    requireConfirmation: boolean;
+}
+export declare class HostActionRegistry {
+    private readonly actionIds;
+    private readonly actions;
+    private readonly slashAliases;
+    register(definition: HostActionDefinition): this;
+    get(actionId: string): HostActionDefinition | undefined;
+    resolveSlashAlias(alias: string): HostActionDefinition | undefined;
+    getSlashCommand(alias: string): HostActionSlashCommand | undefined;
+    getSlashCommands(): HostActionSlashCommand[];
+    getDescriptor(actionId: string, context: HostActionDescriptorContext): UiActionDescriptor | undefined;
+    getDescriptors(context: HostActionDescriptorContext): UiActionDescriptor[];
+    invoke(actionId: string, context: HostActionInvocationContext, args: unknown, options?: HostActionInvokeOptions): Promise<UiActionInvocationResponse>;
+    invokeBySlashAlias(alias: string, context: HostActionInvocationContext, args?: unknown, options?: HostActionInvokeOptions): Promise<UiActionInvocationResponse>;
+}
+export declare function runSessionNewHostAction(context: HostActionInvocationContext, options?: HostActionNewSessionOptions): Promise<HostActionNewSessionResult>;
+export declare function runCancelHostAction(context: HostActionInvocationContext): Promise<void>;
+export declare function runContextCompactHostAction(context: HostActionInvocationContext, customInstructions?: string): Promise<HostActionCompactResult>;
+export declare function runSessionRenameHostAction(context: HostActionInvocationContext, name: string): string;
+export declare function runReviewHostAction(context: HostActionInvocationContext, target: ReviewTarget, options: HostActionReviewOptions): Promise<ReviewWorkflowResult>;
+export declare function registerBuiltinHostActions(registry: HostActionRegistry): HostActionRegistry;
+export declare function createBuiltinHostActionRegistry(): HostActionRegistry;
+export declare const BUILTIN_HOST_ACTION_REGISTRY: HostActionRegistry;
+export declare function getBuiltinHostActionSlashCommand(alias: string): HostActionSlashCommand | undefined;
+export declare function isRemoteSafeBuiltinHostActionId(actionId: string): boolean;
+export declare function runThinkingFastModeHostAction(context: HostActionInvocationContext, enabled: boolean): UiActionInvocationResponse;
+export {};
+//# sourceMappingURL=host-actions.d.ts.map

package/dist/core/host-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-actions.d.ts","sourceRoot":"","sources":["../../src/core/host-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EACX,0BAA0B,EAC1B,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,EACvB,MAAM,gBAAgB,CAAC;AAGxB,KAAK,iBAAiB,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;AAC3D,KAAK,cAAc,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAErD,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAErF,MAAM,WAAW,sBAAsB;IACtC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,4BAA4B,CAAC,EAAE,aAAa,CAAC;CAC7C;AAED,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC/E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,cAAc,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC9E,UAAU,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvF,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAClH,+BAA+B,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC;IACzE,eAAe,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACxG;AAED,MAAM,MAAM,sBAAsB,GAC/B;IACA,OAAO,EAAE,IAAI,CAAC;IACd,cAAc,CAAC,EAAE,IAAI,CAAC;CACrB,GACD;IACA,OAAO,EAAE,KAAK,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACtB,CAAC;AAEL,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACzC,YAAY,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACjD,IAAI,CAAC,EAAE,aAAa,CAAC,0BAA0B,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;IAC5D,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,uBAAuB,GAAG,CAAC,CAAC,OAAO,EAAE,2BAA2B,KAAK,uBAAuB,GAAG,SAAS,CAAC,CAAC;IAClH,YAAY,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,sBAAsB,CAAC;IAChF,OAAO,EAAE,CACR,OAAO,EAAE,2BAA2B,EACpC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,uBAAuB,KAC5B,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACvC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAC3D,eAAO,MAAM,2BAA2B,YAAY,CAAC;AACrD,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AACvD,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AACjE,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAC/C,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,0BAA0B,SAAS,CAAC;AACjD,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;CAC7B;AAUD,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAE1D,QAAQ,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAsB/C;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEtD;IAED,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAGjE;IAED,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAgBjE;IAED,gBAAgB,IAAI,sBAAsB,EAAE,CAW3C;IAED,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,GAAG,kBAAkB,GAAG,SAAS,CAGpG;IAED,cAAc,CAAC,OAAO,EAAE,2BAA2B,GAAG,kBAAkB,EAAE,CAKzE;IAEK,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,2BAA2B,EACpC,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,uBAA4B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAiBrC;IAED,kBAAkB,CACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,2BAA2B,EACpC,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,uBAAuB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CAMrC;CACD;AAED,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,2BAA2B,EACpC,OAAO,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAMrC;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7F;AAED,wBAAsB,2BAA2B,CAChD,OAAO,EAAE,2BAA2B,EACpC,kBAAkB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrG;AAED,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,2BAA2B,EACpC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,uBAAuB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAK/B;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB,CAyK3F;AAED,wBAAgB,+BAA+B,IAAI,kBAAkB,CAEpE;AAED,eAAO,MAAM,4BAA4B,oBAAoC,CAAC;AAE9E,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAElG;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzE;AAsED,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,OAAO,GACd,0BAA0B,CAoD5B","sourcesContent":["import type { ThinkingLevel } from \"@hansjm10/volt-agent-core\";\nimport type { Api, Model } from \"@hansjm10/volt-ai\";\nimport { getSupportedThinkingLevels } from \"@hansjm10/volt-ai\";\nimport type { AgentSessionRuntime } from \"./agent-session-runtime.ts\";\nimport type { ReviewTarget, ReviewWorkflowResult } from \"./review.ts\";\nimport type {\n\tUiActionArgumentDescriptor,\n\tUiActionDescriptor,\n\tUiActionInvocationResponse,\n\tUiActionSlashAlias,\n\tUiActionStateDescriptor,\n} from \"./rpc/types.ts\";\nimport { validateUiActionArgs } from \"./rpc/ui-action-args.ts\";\n\ntype RuntimeNewSession = AgentSessionRuntime[\"newSession\"];\ntype RuntimeSession = AgentSessionRuntime[\"session\"];\n\nexport type HostActionNewSessionOptions = Parameters<RuntimeNewSession>[0];\nexport type HostActionNewSessionResult = Awaited<ReturnType<RuntimeNewSession>>;\nexport type HostActionCompactResult = Awaited<ReturnType<RuntimeSession[\"compact\"]>>;\n\nexport interface HostActionSessionState {\n\t/** Falls back to isStreaming for legacy host integrations. */\n\tisBusy?: boolean;\n\tisStreaming: boolean;\n\tisCompacting: boolean;\n\tmodel?: Model<Api>;\n\tthinkingLevel?: ThinkingLevel;\n\tfastModeRestoreThinkingLevel?: ThinkingLevel;\n}\n\nexport interface HostActionDescriptorContext {\n\tsession: HostActionSessionState;\n}\n\nexport interface HostActionInvocationContext extends HostActionDescriptorContext {\n\tabortRun(): Promise<void>;\n\tcompactContext(customInstructions?: string): Promise<HostActionCompactResult>;\n\tnewSession(options?: HostActionNewSessionOptions): Promise<HostActionNewSessionResult>;\n\tafterSessionSwitch?: () => Promise<void>;\n\trenameSession(name: string): void;\n\tsetThinkingLevel?(level: ThinkingLevel, options?: { persistDefault?: boolean; preserveFastMode?: boolean }): void;\n\tsetFastModeRestoreThinkingLevel?(level: ThinkingLevel | undefined): void;\n\trunReviewAction?(target: ReviewTarget, options: HostActionReviewOptions): Promise<ReviewWorkflowResult>;\n}\n\nexport type HostActionAvailability =\n\t| {\n\t\t\tenabled: true;\n\t\t\tdisabledReason?: null;\n\t  }\n\t| {\n\t\t\tenabled: false;\n\t\t\tdisabledReason: string;\n\t  };\n\nexport interface HostActionDefinition {\n\tid: string;\n\tlabel: string;\n\tdescription?: string;\n\tcategory: UiActionDescriptor[\"category\"];\n\tpresentation: UiActionDescriptor[\"presentation\"];\n\targs?: ReadonlyArray<UiActionArgumentDescriptor>;\n\tdestructive?: boolean;\n\trequiresConfirmation?: boolean;\n\tstreamingBehavior?: UiActionDescriptor[\"streamingBehavior\"];\n\tremoteSafe: boolean;\n\tstate?: UiActionStateDescriptor | ((context: HostActionDescriptorContext) => UiActionStateDescriptor | undefined);\n\tslashAliases?: ReadonlyArray<UiActionSlashAlias>;\n\tslash?: UiActionSlashAlias;\n\tavailability?: (context: HostActionDescriptorContext) => HostActionAvailability;\n\thandler: (\n\t\tcontext: HostActionInvocationContext,\n\t\targs: unknown,\n\t\toptions: HostActionInvokeOptions,\n\t) => Promise<UiActionInvocationResponse>;\n}\n\nexport interface HostActionInvokeOptions {\n\trequireRemoteSafe?: boolean;\n}\n\nexport interface HostActionSlashCommand {\n\tname: string;\n\tdescription: string;\n}\n\nexport const CONTEXT_COMPACT_ACTION_ID = \"context.compact\";\nexport const CONTEXT_COMPACT_SLASH_ALIAS = \"compact\";\nexport const REVIEW_BRANCH_ACTION_ID = \"review.branch\";\nexport const REVIEW_UNCOMMITTED_ACTION_ID = \"review.uncommitted\";\nexport const RUN_CANCEL_ACTION_ID = \"run.cancel\";\nexport const SESSION_NEW_ACTION_ID = \"session.new\";\nexport const SESSION_NEW_SLASH_ALIAS = \"clear\";\nexport const SESSION_RENAME_ACTION_ID = \"session.rename\";\nexport const SESSION_RENAME_SLASH_ALIAS = \"name\";\nexport const THINKING_FAST_MODE_ACTION_ID = \"thinking.fast_mode\";\n\nexport interface HostActionReviewOptions {\n\tremote: boolean;\n\trequireConfirmation: boolean;\n}\n\nconst REMOTE_SAFE_BUILTIN_HOST_ACTION_IDS = new Set<string>([\n\tSESSION_NEW_ACTION_ID,\n\tRUN_CANCEL_ACTION_ID,\n\tTHINKING_FAST_MODE_ACTION_ID,\n\tREVIEW_UNCOMMITTED_ACTION_ID,\n\tREVIEW_BRANCH_ACTION_ID,\n]);\n\nexport class HostActionRegistry {\n\tprivate readonly actionIds: string[] = [];\n\tprivate readonly actions = new Map<string, HostActionDefinition>();\n\tprivate readonly slashAliases = new Map<string, string>();\n\n\tregister(definition: HostActionDefinition): this {\n\t\tif (definition.id.length === 0) {\n\t\t\tthrow new Error(\"Host action id must be a non-empty string\");\n\t\t}\n\t\tif (this.actions.has(definition.id)) {\n\t\t\tthrow new Error(`Host action already registered: ${definition.id}`);\n\t\t}\n\n\t\tfor (const alias of definition.slashAliases ?? []) {\n\t\t\tconst name = normalizeSlashAlias(alias.name);\n\t\t\tconst existingActionId = this.slashAliases.get(name);\n\t\t\tif (existingActionId) {\n\t\t\t\tthrow new Error(`Host action slash alias already registered: ${name}`);\n\t\t\t}\n\t\t}\n\n\t\tthis.actions.set(definition.id, definition);\n\t\tthis.actionIds.push(definition.id);\n\t\tfor (const alias of definition.slashAliases ?? []) {\n\t\t\tthis.slashAliases.set(normalizeSlashAlias(alias.name), definition.id);\n\t\t}\n\t\treturn this;\n\t}\n\n\tget(actionId: string): HostActionDefinition | undefined {\n\t\treturn this.actions.get(actionId);\n\t}\n\n\tresolveSlashAlias(alias: string): HostActionDefinition | undefined {\n\t\tconst actionId = this.slashAliases.get(normalizeSlashAlias(alias));\n\t\treturn actionId ? this.actions.get(actionId) : undefined;\n\t}\n\n\tgetSlashCommand(alias: string): HostActionSlashCommand | undefined {\n\t\tconst action = this.resolveSlashAlias(alias);\n\t\tif (!action) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst normalizedAlias = normalizeSlashAlias(alias);\n\t\tconst slashAlias = action.slashAliases?.find(\n\t\t\t(candidate) => normalizeSlashAlias(candidate.name) === normalizedAlias,\n\t\t);\n\t\tif (!slashAlias) {\n\t\t\treturn undefined;\n\t\t}\n\t\treturn {\n\t\t\tname: normalizedAlias,\n\t\t\tdescription: action.description ?? action.label,\n\t\t};\n\t}\n\n\tgetSlashCommands(): HostActionSlashCommand[] {\n\t\treturn this.actionIds.flatMap((actionId) => {\n\t\t\tconst action = this.actions.get(actionId);\n\t\t\tif (!action) {\n\t\t\t\treturn [];\n\t\t\t}\n\t\t\treturn (action.slashAliases ?? []).map((alias) => ({\n\t\t\t\tname: normalizeSlashAlias(alias.name),\n\t\t\t\tdescription: action.description ?? action.label,\n\t\t\t}));\n\t\t});\n\t}\n\n\tgetDescriptor(actionId: string, context: HostActionDescriptorContext): UiActionDescriptor | undefined {\n\t\tconst action = this.actions.get(actionId);\n\t\treturn action ? createDescriptor(action, context) : undefined;\n\t}\n\n\tgetDescriptors(context: HostActionDescriptorContext): UiActionDescriptor[] {\n\t\treturn this.actionIds.flatMap((actionId) => {\n\t\t\tconst action = this.actions.get(actionId);\n\t\t\treturn action ? [createDescriptor(action, context)] : [];\n\t\t});\n\t}\n\n\tasync invoke(\n\t\tactionId: string,\n\t\tcontext: HostActionInvocationContext,\n\t\targs: unknown,\n\t\toptions: HostActionInvokeOptions = {},\n\t): Promise<UiActionInvocationResponse> {\n\t\tif (actionId.length === 0) {\n\t\t\tthrow new Error(\"UI action id must be a non-empty string\");\n\t\t}\n\t\tconst action = this.actions.get(actionId);\n\t\tif (!action) {\n\t\t\tthrow new Error(`UI action not available: ${actionId}`);\n\t\t}\n\t\tconst descriptor = createDescriptor(action, context);\n\t\tif (options.requireRemoteSafe && !descriptor.remoteSafe) {\n\t\t\tthrow new Error(`UI action not available over remote host: ${actionId}`);\n\t\t}\n\t\tif (!descriptor.enabled) {\n\t\t\tthrow new Error(descriptor.disabledReason ?? `UI action is disabled: ${actionId}`);\n\t\t}\n\t\tconst validatedArgs = validateUiActionArgs(args, descriptor.args ?? []);\n\t\treturn action.handler(context, validatedArgs, options);\n\t}\n\n\tinvokeBySlashAlias(\n\t\talias: string,\n\t\tcontext: HostActionInvocationContext,\n\t\targs?: unknown,\n\t\toptions?: HostActionInvokeOptions,\n\t): Promise<UiActionInvocationResponse> {\n\t\tconst action = this.resolveSlashAlias(alias);\n\t\tif (!action) {\n\t\t\tthrow new Error(`Host action slash alias not available: ${normalizeSlashAlias(alias)}`);\n\t\t}\n\t\treturn this.invoke(action.id, context, args, options);\n\t}\n}\n\nexport async function runSessionNewHostAction(\n\tcontext: HostActionInvocationContext,\n\toptions?: HostActionNewSessionOptions,\n): Promise<HostActionNewSessionResult> {\n\tconst result = await context.newSession(options);\n\tif (!result.cancelled) {\n\t\tawait context.afterSessionSwitch?.();\n\t}\n\treturn result;\n}\n\nexport async function runCancelHostAction(context: HostActionInvocationContext): Promise<void> {\n\tawait context.abortRun();\n}\n\nexport async function runContextCompactHostAction(\n\tcontext: HostActionInvocationContext,\n\tcustomInstructions?: string,\n): Promise<HostActionCompactResult> {\n\treturn context.compactContext(customInstructions);\n}\n\nexport function runSessionRenameHostAction(context: HostActionInvocationContext, name: string): string {\n\tconst trimmedName = name.trim();\n\tif (!trimmedName) {\n\t\tthrow new Error(\"Session name cannot be empty\");\n\t}\n\tcontext.renameSession(trimmedName);\n\treturn trimmedName;\n}\n\nexport async function runReviewHostAction(\n\tcontext: HostActionInvocationContext,\n\ttarget: ReviewTarget,\n\toptions: HostActionReviewOptions,\n): Promise<ReviewWorkflowResult> {\n\tif (!context.runReviewAction) {\n\t\tthrow new Error(\"Review actions are not available in this host\");\n\t}\n\treturn context.runReviewAction(target, options);\n}\n\nexport function registerBuiltinHostActions(registry: HostActionRegistry): HostActionRegistry {\n\tregistry.register({\n\t\tid: SESSION_NEW_ACTION_ID,\n\t\tlabel: \"New session\",\n\t\tdescription: \"Start a new session\",\n\t\tcategory: \"session\",\n\t\tpresentation: { kind: \"palette\", group: \"Session\" },\n\t\targs: [],\n\t\tdestructive: false,\n\t\trequiresConfirmation: false,\n\t\tstreamingBehavior: \"disabled\",\n\t\tremoteSafe: true,\n\t\tslashAliases: [\n\t\t\t{\n\t\t\t\tname: SESSION_NEW_SLASH_ALIAS,\n\t\t\t\texample: `/${SESSION_NEW_SLASH_ALIAS}`,\n\t\t\t},\n\t\t],\n\t\tavailability: () => ({ enabled: true }),\n\t\thandler: invokeSessionNewAction,\n\t});\n\tregistry.register({\n\t\tid: RUN_CANCEL_ACTION_ID,\n\t\tlabel: \"Cancel run\",\n\t\tdescription: \"Abort the current agent operation\",\n\t\tcategory: \"session\",\n\t\tpresentation: { kind: \"button\", group: \"Session\" },\n\t\targs: [],\n\t\tdestructive: false,\n\t\trequiresConfirmation: false,\n\t\tstreamingBehavior: \"immediate\",\n\t\tremoteSafe: true,\n\t\tavailability: (context) =>\n\t\t\tisHostSessionBusy(context.session) || context.session.isCompacting\n\t\t\t\t? { enabled: true }\n\t\t\t\t: { enabled: false, disabledReason: \"No active run to cancel\" },\n\t\thandler: invokeRunCancelAction,\n\t});\n\tregistry.register({\n\t\tid: CONTEXT_COMPACT_ACTION_ID,\n\t\tlabel: \"Compact context\",\n\t\tdescription: \"Summarize the current session context\",\n\t\tcategory: \"context\",\n\t\tpresentation: { kind: \"palette\", group: \"Context\" },\n\t\targs: [\n\t\t\t{\n\t\t\t\tname: \"customInstructions\",\n\t\t\t\tlabel: \"Custom instructions\",\n\t\t\t\ttype: \"string\",\n\t\t\t\trequired: false,\n\t\t\t\tmultiline: true,\n\t\t\t},\n\t\t],\n\t\tdestructive: false,\n\t\trequiresConfirmation: false,\n\t\tstreamingBehavior: \"disabled\",\n\t\tremoteSafe: false,\n\t\tslashAliases: [\n\t\t\t{\n\t\t\t\tname: CONTEXT_COMPACT_SLASH_ALIAS,\n\t\t\t\texample: `/${CONTEXT_COMPACT_SLASH_ALIAS}`,\n\t\t\t},\n\t\t],\n\t\tavailability: (context) =>\n\t\t\tcontext.session.isCompacting\n\t\t\t\t? { enabled: false, disabledReason: \"Compaction is already running\" }\n\t\t\t\t: { enabled: true },\n\t\thandler: invokeContextCompactAction,\n\t});\n\tregistry.register({\n\t\tid: SESSION_RENAME_ACTION_ID,\n\t\tlabel: \"Rename session\",\n\t\tdescription: \"Set the current session display name\",\n\t\tcategory: \"session\",\n\t\tpresentation: { kind: \"palette\", group: \"Session\" },\n\t\targs: [\n\t\t\t{\n\t\t\t\tname: \"name\",\n\t\t\t\tlabel: \"Name\",\n\t\t\t\ttype: \"string\",\n\t\t\t\trequired: true,\n\t\t\t\tplaceholder: \"Session name\",\n\t\t\t},\n\t\t],\n\t\tdestructive: false,\n\t\trequiresConfirmation: false,\n\t\tstreamingBehavior: \"immediate\",\n\t\tremoteSafe: false,\n\t\tslashAliases: [\n\t\t\t{\n\t\t\t\tname: SESSION_RENAME_SLASH_ALIAS,\n\t\t\t\texample: `/${SESSION_RENAME_SLASH_ALIAS} <name>`,\n\t\t\t},\n\t\t],\n\t\tavailability: () => ({ enabled: true }),\n\t\thandler: invokeSessionRenameAction,\n\t});\n\tregistry.register({\n\t\tid: THINKING_FAST_MODE_ACTION_ID,\n\t\tlabel: \"Fast mode\",\n\t\tdescription: \"Prefer lower-latency thinking for the current session.\",\n\t\tcategory: \"model\",\n\t\tpresentation: { kind: \"toggle\", group: \"Model\", priority: 100 },\n\t\targs: [\n\t\t\t{\n\t\t\t\tname: \"enabled\",\n\t\t\t\tlabel: \"Enabled\",\n\t\t\t\ttype: \"boolean\",\n\t\t\t\trequired: true,\n\t\t\t},\n\t\t],\n\t\tdestructive: false,\n\t\trequiresConfirmation: false,\n\t\tstreamingBehavior: \"disabled\",\n\t\tremoteSafe: true,\n\t\tstate: createThinkingFastModeState,\n\t\tavailability: thinkingFastModeAvailability,\n\t\thandler: invokeThinkingFastModeAction,\n\t});\n\tregistry.register({\n\t\tid: REVIEW_UNCOMMITTED_ACTION_ID,\n\t\tlabel: \"Review changes\",\n\t\tdescription: \"Review uncommitted workspace changes.\",\n\t\tcategory: \"review\",\n\t\tpresentation: { kind: \"card\", group: \"Review\", priority: 100, icon: \"magnifyingglass\" },\n\t\targs: [],\n\t\tdestructive: false,\n\t\trequiresConfirmation: true,\n\t\tstreamingBehavior: \"disabled\",\n\t\tremoteSafe: true,\n\t\tslash: {\n\t\t\tname: \"review\",\n\t\t\texample: \"/review uncommitted\",\n\t\t},\n\t\tavailability: reviewAvailability,\n\t\thandler: invokeReviewUncommittedAction,\n\t});\n\tregistry.register({\n\t\tid: REVIEW_BRANCH_ACTION_ID,\n\t\tlabel: \"Review branch\",\n\t\tdescription: \"Review the current branch against its merge base.\",\n\t\tcategory: \"review\",\n\t\tpresentation: {\n\t\t\tkind: \"card\",\n\t\t\tgroup: \"Review\",\n\t\t\tpriority: 90,\n\t\t\ticon: \"point.topleft.down.curvedto.point.bottomright.up\",\n\t\t},\n\t\targs: [\n\t\t\t{\n\t\t\t\tname: \"base\",\n\t\t\t\tlabel: \"Base branch\",\n\t\t\t\ttype: \"string\",\n\t\t\t\trequired: false,\n\t\t\t\tplaceholder: \"main\",\n\t\t\t},\n\t\t],\n\t\tdestructive: false,\n\t\trequiresConfirmation: true,\n\t\tstreamingBehavior: \"disabled\",\n\t\tremoteSafe: true,\n\t\tslash: {\n\t\t\tname: \"review\",\n\t\t\texample: \"/review branch [base]\",\n\t\t},\n\t\tavailability: reviewAvailability,\n\t\thandler: invokeReviewBranchAction,\n\t});\n\treturn registry;\n}\n\nexport function createBuiltinHostActionRegistry(): HostActionRegistry {\n\treturn registerBuiltinHostActions(new HostActionRegistry());\n}\n\nexport const BUILTIN_HOST_ACTION_REGISTRY = createBuiltinHostActionRegistry();\n\nexport function getBuiltinHostActionSlashCommand(alias: string): HostActionSlashCommand | undefined {\n\treturn BUILTIN_HOST_ACTION_REGISTRY.getSlashCommand(alias);\n}\n\nexport function isRemoteSafeBuiltinHostActionId(actionId: string): boolean {\n\treturn REMOTE_SAFE_BUILTIN_HOST_ACTION_IDS.has(actionId);\n}\n\nasync function invokeSessionNewAction(\n\tcontext: HostActionInvocationContext,\n\targs: unknown,\n): Promise<UiActionInvocationResponse> {\n\tassertNoActionArgs(args);\n\tconst result = await runSessionNewHostAction(context);\n\tconst response: UiActionInvocationResponse = {\n\t\taction: SESSION_NEW_ACTION_ID,\n\t\tstatus: result.cancelled ? \"cancelled\" : \"completed\",\n\t};\n\tif (!result.cancelled) {\n\t\tresponse.stateChanged = true;\n\t\tresponse.actionsChanged = true;\n\t}\n\treturn response;\n}\n\nasync function invokeRunCancelAction(\n\tcontext: HostActionInvocationContext,\n\targs: unknown,\n): Promise<UiActionInvocationResponse> {\n\tassertNoActionArgs(args);\n\tawait runCancelHostAction(context);\n\treturn {\n\t\taction: RUN_CANCEL_ACTION_ID,\n\t\tstatus: \"completed\",\n\t\tstateChanged: true,\n\t\tactionsChanged: true,\n\t\tmessage: \"Run cancelled\",\n\t};\n}\n\nasync function invokeContextCompactAction(\n\tcontext: HostActionInvocationContext,\n\targs: unknown,\n): Promise<UiActionInvocationResponse> {\n\tconst customInstructions = getOptionalStringArg(args, \"customInstructions\");\n\tawait runContextCompactHostAction(context, customInstructions);\n\treturn {\n\t\taction: CONTEXT_COMPACT_ACTION_ID,\n\t\tstatus: \"completed\",\n\t\tstateChanged: true,\n\t\tactionsChanged: true,\n\t\tmessage: \"Context compacted\",\n\t};\n}\n\nasync function invokeSessionRenameAction(\n\tcontext: HostActionInvocationContext,\n\targs: unknown,\n): Promise<UiActionInvocationResponse> {\n\tconst name = getRequiredStringArg(args, \"name\");\n\tconst trimmedName = runSessionRenameHostAction(context, name);\n\treturn {\n\t\taction: SESSION_RENAME_ACTION_ID,\n\t\tstatus: \"completed\",\n\t\tstateChanged: true,\n\t\tmessage: `Session name set: ${trimmedName}`,\n\t};\n}\n\nfunction invokeThinkingFastModeAction(\n\tcontext: HostActionInvocationContext,\n\targs: unknown,\n): Promise<UiActionInvocationResponse> {\n\treturn Promise.resolve(runThinkingFastModeHostAction(context, getRequiredBooleanArg(args, \"enabled\")));\n}\n\nexport function runThinkingFastModeHostAction(\n\tcontext: HostActionInvocationContext,\n\tenabled: boolean,\n): UiActionInvocationResponse {\n\tif (!context.setThinkingLevel || !context.setFastModeRestoreThinkingLevel) {\n\t\tthrow new Error(\"Fast mode is not available in this host\");\n\t}\n\n\tconst isEnabled = isThinkingFastModeEnabled(context.session);\n\tif (enabled) {\n\t\tif (isEnabled) {\n\t\t\treturn {\n\t\t\t\taction: THINKING_FAST_MODE_ACTION_ID,\n\t\t\t\tstatus: \"completed\",\n\t\t\t\tstate: createThinkingFastModeState(context),\n\t\t\t\tstateChanged: false,\n\t\t\t\tactionsChanged: false,\n\t\t\t\tmessage: \"Fast mode already enabled\",\n\t\t\t};\n\t\t}\n\n\t\tconst restoreLevel = context.session.thinkingLevel;\n\t\tconst targetLevel = getFastModeTargetThinkingLevel(context.session);\n\t\tif (!restoreLevel || !targetLevel) {\n\t\t\tthrow new Error(getThinkingFastModeDisabledReason(context.session));\n\t\t}\n\n\t\tcontext.setThinkingLevel(targetLevel, { persistDefault: false, preserveFastMode: true });\n\t\tcontext.setFastModeRestoreThinkingLevel(restoreLevel);\n\t\treturn {\n\t\t\taction: THINKING_FAST_MODE_ACTION_ID,\n\t\t\tstatus: \"completed\",\n\t\t\tstate: createThinkingFastModeState(context),\n\t\t\tstateChanged: true,\n\t\t\tactionsChanged: true,\n\t\t\tmessage: `Fast mode enabled: ${formatThinkingLevelLabel(context.session.thinkingLevel ?? targetLevel)}`,\n\t\t};\n\t}\n\n\tconst restoreLevel = context.session.fastModeRestoreThinkingLevel;\n\tif (restoreLevel !== undefined) {\n\t\tcontext.setThinkingLevel(restoreLevel, { persistDefault: false, preserveFastMode: true });\n\t}\n\tcontext.setFastModeRestoreThinkingLevel(undefined);\n\treturn {\n\t\taction: THINKING_FAST_MODE_ACTION_ID,\n\t\tstatus: \"completed\",\n\t\tstate: createThinkingFastModeState(context),\n\t\tstateChanged: restoreLevel !== undefined,\n\t\tactionsChanged: restoreLevel !== undefined,\n\t\tmessage:\n\t\t\trestoreLevel === undefined\n\t\t\t\t? \"Fast mode already disabled\"\n\t\t\t\t: `Fast mode disabled: restored ${formatThinkingLevelLabel(context.session.thinkingLevel ?? restoreLevel)}`,\n\t};\n}\n\nasync function invokeReviewUncommittedAction(\n\tcontext: HostActionInvocationContext,\n\targs: unknown,\n\toptions: HostActionInvokeOptions,\n): Promise<UiActionInvocationResponse> {\n\tassertNoActionArgs(args);\n\treturn createReviewInvocationResponse(\n\t\tREVIEW_UNCOMMITTED_ACTION_ID,\n\t\tawait runReviewHostAction(context, { kind: \"uncommitted\" }, createReviewOptions(options)),\n\t);\n}\n\nasync function invokeReviewBranchAction(\n\tcontext: HostActionInvocationContext,\n\targs: unknown,\n\toptions: HostActionInvokeOptions,\n): Promise<UiActionInvocationResponse> {\n\tconst base = getOptionalStringArg(args, \"base\")?.trim() || undefined;\n\treturn createReviewInvocationResponse(\n\t\tREVIEW_BRANCH_ACTION_ID,\n\t\tawait runReviewHostAction(context, { kind: \"branch\", base }, createReviewOptions(options)),\n\t);\n}\n\nfunction reviewAvailability(context: HostActionDescriptorContext): HostActionAvailability {\n\tif (context.session.isStreaming) {\n\t\treturn { enabled: false, disabledReason: \"Review is not available while the agent is streaming\" };\n\t}\n\tif (isHostSessionBusy(context.session)) {\n\t\treturn { enabled: false, disabledReason: \"Review is not available while an agent operation is running\" };\n\t}\n\tif (context.session.isCompacting) {\n\t\treturn { enabled: false, disabledReason: \"Review is not available while compaction is running\" };\n\t}\n\treturn { enabled: true };\n}\n\nfunction thinkingFastModeAvailability(context: HostActionDescriptorContext): HostActionAvailability {\n\tif (context.session.isStreaming) {\n\t\treturn { enabled: false, disabledReason: \"Fast mode is not available while the agent is streaming\" };\n\t}\n\tif (isHostSessionBusy(context.session)) {\n\t\treturn { enabled: false, disabledReason: \"Fast mode is not available while an agent operation is running\" };\n\t}\n\tif (context.session.isCompacting) {\n\t\treturn { enabled: false, disabledReason: \"Fast mode is not available while compaction is running\" };\n\t}\n\tif (isThinkingFastModeEnabled(context.session)) {\n\t\treturn { enabled: true };\n\t}\n\tconst targetLevel = getFastModeTargetThinkingLevel(context.session);\n\tif (!targetLevel) {\n\t\treturn { enabled: false, disabledReason: getThinkingFastModeDisabledReason(context.session) };\n\t}\n\treturn { enabled: true };\n}\n\nfunction createReviewOptions(options: HostActionInvokeOptions): HostActionReviewOptions {\n\treturn {\n\t\tremote: options.requireRemoteSafe === true,\n\t\trequireConfirmation: options.requireRemoteSafe === true,\n\t};\n}\n\nfunction createReviewInvocationResponse(action: string, result: ReviewWorkflowResult): UiActionInvocationResponse {\n\tif (result.status === \"cancelled\") {\n\t\treturn {\n\t\t\taction,\n\t\t\tstatus: \"cancelled\",\n\t\t\tactionsChanged: true,\n\t\t\tmessage: \"Review cancelled\",\n\t\t};\n\t}\n\tconst findingCount = result.findingsCount;\n\tconst summary =\n\t\tfindingCount === undefined\n\t\t\t? \"Review complete\"\n\t\t\t: findingCount === 0\n\t\t\t\t? \"Review complete: no issues found\"\n\t\t\t\t: `Review complete: ${findingCount} finding${findingCount === 1 ? \"\" : \"s\"}`;\n\treturn {\n\t\taction,\n\t\tstatus: \"completed\",\n\t\tstateChanged: true,\n\t\tactionsChanged: true,\n\t\tmessage: result.sessionSwitchCancelled\n\t\t\t? `${summary}; findings added to the current session`\n\t\t\t: `${summary}; fresh session created with findings`,\n\t};\n}\n\nfunction createDescriptor(action: HostActionDefinition, context: HostActionDescriptorContext): UiActionDescriptor {\n\tconst availability = action.availability?.(context) ?? { enabled: true };\n\tconst state = typeof action.state === \"function\" ? action.state(context) : action.state;\n\tconst descriptor: UiActionDescriptor = {\n\t\tschemaVersion: 1,\n\t\tid: action.id,\n\t\tlabel: action.label,\n\t\tdescription: action.description,\n\t\tsource: \"builtin\",\n\t\tsourceLabel: \"Built in\",\n\t\tcategory: action.category,\n\t\tpresentation: action.presentation,\n\t\targs: [...(action.args ?? [])],\n\t\tenabled: availability.enabled,\n\t\tdisabledReason: availability.enabled ? null : availability.disabledReason,\n\t\tdestructive: action.destructive ?? false,\n\t\trequiresConfirmation: action.requiresConfirmation ?? false,\n\t\tstreamingBehavior: action.streamingBehavior ?? \"disabled\",\n\t\tremoteSafe: action.remoteSafe,\n\t\tslash: action.slashAliases?.[0] ?? action.slash,\n\t};\n\tif (state) {\n\t\tdescriptor.state = state;\n\t}\n\treturn descriptor;\n}\n\nconst THINKING_LEVEL_ORDER: ThinkingLevel[] = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"];\nconst FAST_MODE_TARGET_ORDER: ThinkingLevel[] = [\"off\", \"minimal\", \"low\"];\n\nfunction createThinkingFastModeState(context: HostActionDescriptorContext): UiActionStateDescriptor {\n\tconst enabled = isThinkingFastModeEnabled(context.session);\n\treturn {\n\t\ttype: \"boolean\",\n\t\tvalue: enabled,\n\t\tlabel: enabled ? `Fast: ${formatThinkingLevelLabel(context.session.thinkingLevel)}` : \"Normal reasoning\",\n\t};\n}\n\nfunction isHostSessionBusy(session: HostActionSessionState): boolean {\n\treturn session.isBusy ?? session.isStreaming;\n}\n\nfunction isThinkingFastModeEnabled(session: HostActionSessionState): boolean {\n\treturn session.fastModeRestoreThinkingLevel !== undefined;\n}\n\nfunction getFastModeTargetThinkingLevel(session: HostActionSessionState): ThinkingLevel | undefined {\n\tif (!session.model || !session.thinkingLevel) {\n\t\treturn undefined;\n\t}\n\tconst currentRank = getThinkingLevelRank(session.thinkingLevel);\n\tif (currentRank <= 0) {\n\t\treturn undefined;\n\t}\n\tconst supportedLevels = getSupportedThinkingLevels(session.model) as ThinkingLevel[];\n\treturn FAST_MODE_TARGET_ORDER.find((level) => {\n\t\tconst targetRank = getThinkingLevelRank(level);\n\t\treturn supportedLevels.includes(level) && targetRank >= 0 && targetRank < currentRank;\n\t});\n}\n\nfunction getThinkingFastModeDisabledReason(session: HostActionSessionState): string {\n\tif (!session.model) {\n\t\treturn \"No model is selected.\";\n\t}\n\tif (!session.thinkingLevel) {\n\t\treturn \"No thinking level is selected.\";\n\t}\n\treturn \"Current model is already at its fastest supported thinking level.\";\n}\n\nfunction getThinkingLevelRank(level: ThinkingLevel): number {\n\treturn THINKING_LEVEL_ORDER.indexOf(level);\n}\n\nfunction formatThinkingLevelLabel(level: ThinkingLevel | undefined): string {\n\tif (level === undefined) {\n\t\treturn \"current thinking\";\n\t}\n\treturn level === \"off\" ? \"thinking off\" : `${level} thinking`;\n}\n\nfunction normalizeSlashAlias(alias: string): string {\n\tconst normalized = alias.startsWith(\"/\") ? alias.slice(1) : alias;\n\tif (normalized.length === 0) {\n\t\tthrow new Error(\"Host action slash alias must be a non-empty string\");\n\t}\n\treturn normalized;\n}\n\nfunction assertNoActionArgs(args: unknown): void {\n\tif (args === undefined) {\n\t\treturn;\n\t}\n\tif (typeof args !== \"object\" || args === null || Array.isArray(args)) {\n\t\tthrow new Error(\"UI action args must be an object\");\n\t}\n\tconst unknownKeys = Object.keys(args);\n\tif (unknownKeys.length > 0) {\n\t\tthrow new Error(`Unsupported UI action argument: ${unknownKeys[0]}`);\n\t}\n}\n\nfunction getArgsRecord(args: unknown): Record<string, unknown> {\n\tif (args === undefined) {\n\t\treturn {};\n\t}\n\tif (typeof args !== \"object\" || args === null || Array.isArray(args)) {\n\t\tthrow new Error(\"UI action args must be an object\");\n\t}\n\treturn args as Record<string, unknown>;\n}\n\nfunction getOptionalStringArg(args: unknown, name: string): string | undefined {\n\tconst record = getArgsRecord(args);\n\tconst unknownKeys = Object.keys(record).filter((key) => key !== name);\n\tif (unknownKeys.length > 0) {\n\t\tthrow new Error(`Unsupported UI action argument: ${unknownKeys[0]}`);\n\t}\n\tconst value = record[name];\n\tif (value === undefined || value === null) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(`UI action argument \"${name}\" must be a string`);\n\t}\n\treturn value;\n}\n\nfunction getRequiredStringArg(args: unknown, name: string): string {\n\tconst value = getOptionalStringArg(args, name);\n\tif (value === undefined) {\n\t\tthrow new Error(`Missing required UI action argument: ${name}`);\n\t}\n\treturn value;\n}\n\nfunction getOptionalBooleanArg(args: unknown, name: string): boolean | undefined {\n\tconst record = getArgsRecord(args);\n\tconst unknownKeys = Object.keys(record).filter((key) => key !== name);\n\tif (unknownKeys.length > 0) {\n\t\tthrow new Error(`Unsupported UI action argument: ${unknownKeys[0]}`);\n\t}\n\tconst value = record[name];\n\tif (value === undefined || value === null) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"boolean\") {\n\t\tthrow new Error(`UI action argument \"${name}\" must be a boolean`);\n\t}\n\treturn value;\n}\n\nfunction getRequiredBooleanArg(args: unknown, name: string): boolean {\n\tconst value = getOptionalBooleanArg(args, name);\n\tif (value === undefined) {\n\t\tthrow new Error(`UI action argument \"${name}\" is required`);\n\t}\n\treturn value;\n}\n"]}