fss-link 1.2.0 → 1.2.1

package/dist/src/ui/commands/setupGithubCommand.js

@@ -0,0 +1,154 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import path from 'node:path';
+import * as fs from 'node:fs';
+import { Writable } from 'node:stream';
+import { ProxyAgent } from 'undici';
+import { getGitRepoRoot, getLatestGitHubRelease, isGitHubRepository, getGitHubRepoInfo, } from '../../utils/gitUtils.js';
+import { CommandKind, } from './types.js';
+import { getUrlOpenCommand } from '../../ui/utils/commandUtils.js';
+export const GITHUB_WORKFLOW_PATHS = [
+    'gemini-dispatch/gemini-dispatch.yml',
+    'gemini-assistant/gemini-invoke.yml',
+    'issue-triage/gemini-triage.yml',
+    'issue-triage/gemini-scheduled-triage.yml',
+    'pr-review/gemini-review.yml',
+];
+// Generate OS-specific commands to open the GitHub pages needed for setup.
+function getOpenUrlsCommands(readmeUrl) {
+    // Determine the OS-specific command to open URLs, ex: 'open', 'xdg-open', etc
+    const openCmd = getUrlOpenCommand();
+    // Build a list of URLs to open
+    const urlsToOpen = [readmeUrl];
+    const repoInfo = getGitHubRepoInfo();
+    if (repoInfo) {
+        urlsToOpen.push(`https://github.com/${repoInfo.owner}/${repoInfo.repo}/settings/secrets/actions`);
+    }
+    // Create and join the individual commands
+    const commands = urlsToOpen.map((url) => `${openCmd} "${url}"`);
+    return commands;
+}
+// Add Gemini CLI specific entries to .gitignore file
+export async function updateGitignore(gitRepoRoot) {
+    const gitignoreEntries = ['.gemini/', 'gha-creds-*.json'];
+    const gitignorePath = path.join(gitRepoRoot, '.gitignore');
+    try {
+        // Check if .gitignore exists and read its content
+        let existingContent = '';
+        let fileExists = true;
+        try {
+            existingContent = await fs.promises.readFile(gitignorePath, 'utf8');
+        }
+        catch (_error) {
+            // File doesn't exist
+            fileExists = false;
+        }
+        if (!fileExists) {
+            // Create new .gitignore file with the entries
+            const contentToWrite = gitignoreEntries.join('\n') + '\n';
+            await fs.promises.writeFile(gitignorePath, contentToWrite);
+        }
+        else {
+            // Check which entries are missing
+            const missingEntries = gitignoreEntries.filter((entry) => !existingContent
+                .split(/\r?\n/)
+                .some((line) => line.split('#')[0].trim() === entry));
+            if (missingEntries.length > 0) {
+                const contentToAdd = '\n' + missingEntries.join('\n') + '\n';
+                await fs.promises.appendFile(gitignorePath, contentToAdd);
+            }
+        }
+    }
+    catch (error) {
+        console.debug('Failed to update .gitignore:', error);
+        // Continue without failing the whole command
+    }
+}
+export const setupGithubCommand = {
+    name: 'setup-github',
+    description: 'Set up GitHub Actions',
+    kind: CommandKind.BUILT_IN,
+    action: async (context) => {
+        const abortController = new AbortController();
+        if (!isGitHubRepository()) {
+            throw new Error('Unable to determine the GitHub repository. /setup-github must be run from a git repository.');
+        }
+        // Find the root directory of the repo
+        let gitRepoRoot;
+        try {
+            gitRepoRoot = getGitRepoRoot();
+        }
+        catch (_error) {
+            console.debug(`Failed to get git repo root:`, _error);
+            throw new Error('Unable to determine the GitHub repository. /setup-github must be run from a git repository.');
+        }
+        // Get the latest release tag from GitHub
+        const proxy = context?.services?.config?.getProxy();
+        const releaseTag = await getLatestGitHubRelease(proxy);
+        const readmeUrl = `https://github.com/google-github-actions/run-gemini-cli/blob/${releaseTag}/README.md#quick-start`;
+        // Create the .github/workflows directory to download the files into
+        const githubWorkflowsDir = path.join(gitRepoRoot, '.github', 'workflows');
+        try {
+            await fs.promises.mkdir(githubWorkflowsDir, { recursive: true });
+        }
+        catch (_error) {
+            console.debug(`Failed to create ${githubWorkflowsDir} directory:`, _error);
+            throw new Error(`Unable to create ${githubWorkflowsDir} directory. Do you have file permissions in the current directory?`);
+        }
+        // Download each workflow in parallel - there aren't enough files to warrant
+        // a full workerpool model here.
+        const downloads = [];
+        for (const workflow of GITHUB_WORKFLOW_PATHS) {
+            downloads.push((async () => {
+                const endpoint = `https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/refs/tags/${releaseTag}/examples/workflows/${workflow}`;
+                const response = await fetch(endpoint, {
+                    method: 'GET',
+                    dispatcher: proxy ? new ProxyAgent(proxy) : undefined,
+                    signal: AbortSignal.any([
+                        AbortSignal.timeout(30_000),
+                        abortController.signal,
+                    ]),
+                });
+                if (!response.ok) {
+                    throw new Error(`Invalid response code downloading ${endpoint}: ${response.status} - ${response.statusText}`);
+                }
+                const body = response.body;
+                if (!body) {
+                    throw new Error(`Empty body while downloading ${endpoint}: ${response.status} - ${response.statusText}`);
+                }
+                const destination = path.resolve(githubWorkflowsDir, path.basename(workflow));
+                const fileStream = fs.createWriteStream(destination, {
+                    mode: 0o644, // -rw-r--r--, user(rw), group(r), other(r)
+                    flags: 'w', // write and overwrite
+                    flush: true,
+                });
+                await body.pipeTo(Writable.toWeb(fileStream));
+            })());
+        }
+        // Wait for all downloads to complete
+        await Promise.all(downloads).finally(() => {
+            // Stop existing downloads
+            abortController.abort();
+        });
+        // Add entries to .gitignore file
+        await updateGitignore(gitRepoRoot);
+        // Print out a message
+        const commands = [];
+        commands.push('set -eEuo pipefail');
+        commands.push(`echo "Successfully downloaded ${GITHUB_WORKFLOW_PATHS.length} workflows and updated .gitignore. Follow the steps in ${readmeUrl} (skipping the /setup-github step) to complete setup."`);
+        commands.push(...getOpenUrlsCommands(readmeUrl));
+        const command = `(${commands.join(' && ')})`;
+        return {
+            type: 'tool',
+            toolName: 'run_shell_command',
+            toolArgs: {
+                description: 'Setting up GitHub Actions to triage issues and review PRs with Gemini.',
+                command,
+            },
+        };
+    },
+};
+//# sourceMappingURL=setupGithubCommand.js.map

package/dist/src/ui/commands/setupGithubCommand.js.map

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

package/dist/src/ui/commands/setupGithubCommand.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/ui/commands/setupGithubCommand.test.js

@@ -0,0 +1,167 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { vi, describe, expect, it, afterEach, beforeEach } from 'vitest';
+import * as gitUtils from '../../utils/gitUtils.js';
+import { setupGithubCommand, updateGitignore, GITHUB_WORKFLOW_PATHS, } from './setupGithubCommand.js';
+import * as commandUtils from '../utils/commandUtils.js';
+vi.mock('child_process');
+// Mock fetch globally
+global.fetch = vi.fn();
+vi.mock('../../utils/gitUtils.js', () => ({
+    isGitHubRepository: vi.fn(),
+    getGitRepoRoot: vi.fn(),
+    getLatestGitHubRelease: vi.fn(),
+    getGitHubRepoInfo: vi.fn(),
+}));
+vi.mock('../utils/commandUtils.js', () => ({
+    getUrlOpenCommand: vi.fn(),
+}));
+describe('setupGithubCommand', async () => {
+    let scratchDir = '';
+    beforeEach(async () => {
+        vi.resetAllMocks();
+        scratchDir = await fs.mkdtemp(path.join(os.tmpdir(), 'setup-github-command-'));
+    });
+    afterEach(async () => {
+        vi.restoreAllMocks();
+        if (scratchDir)
+            await fs.rm(scratchDir, { recursive: true });
+    });
+    it('returns a tool action to download github workflows and handles paths', async () => {
+        const fakeRepoOwner = 'fake';
+        const fakeRepoName = 'repo';
+        const fakeRepoRoot = scratchDir;
+        const fakeReleaseVersion = 'v1.2.3';
+        const workflows = GITHUB_WORKFLOW_PATHS.map((p) => path.basename(p));
+        for (const workflow of workflows) {
+            vi.mocked(global.fetch).mockReturnValueOnce(Promise.resolve(new Response(workflow)));
+        }
+        vi.mocked(gitUtils.isGitHubRepository).mockReturnValueOnce(true);
+        vi.mocked(gitUtils.getGitRepoRoot).mockReturnValueOnce(fakeRepoRoot);
+        vi.mocked(gitUtils.getLatestGitHubRelease).mockResolvedValueOnce(fakeReleaseVersion);
+        vi.mocked(gitUtils.getGitHubRepoInfo).mockReturnValue({
+            owner: fakeRepoOwner,
+            repo: fakeRepoName,
+        });
+        vi.mocked(commandUtils.getUrlOpenCommand).mockReturnValueOnce('fakeOpenCommand');
+        const result = (await setupGithubCommand.action?.({}, ''));
+        const { command } = result.toolArgs;
+        const expectedSubstrings = [
+            `set -eEuo pipefail`,
+            `fakeOpenCommand "https://github.com/google-github-actions/run-gemini-cli`,
+        ];
+        for (const substring of expectedSubstrings) {
+            expect(command).toContain(substring);
+        }
+        for (const workflow of workflows) {
+            const workflowFile = path.join(scratchDir, '.github', 'workflows', workflow);
+            const contents = await fs.readFile(workflowFile, 'utf8');
+            expect(contents).toContain(workflow);
+        }
+        // Verify that .gitignore was created with the expected entries
+        const gitignorePath = path.join(scratchDir, '.gitignore');
+        const gitignoreExists = await fs
+            .access(gitignorePath)
+            .then(() => true)
+            .catch(() => false);
+        expect(gitignoreExists).toBe(true);
+        if (gitignoreExists) {
+            const gitignoreContent = await fs.readFile(gitignorePath, 'utf8');
+            expect(gitignoreContent).toContain('.gemini/');
+            expect(gitignoreContent).toContain('gha-creds-*.json');
+        }
+    });
+});
+describe('updateGitignore', () => {
+    let scratchDir = '';
+    beforeEach(async () => {
+        scratchDir = await fs.mkdtemp(path.join(os.tmpdir(), 'update-gitignore-'));
+    });
+    afterEach(async () => {
+        if (scratchDir)
+            await fs.rm(scratchDir, { recursive: true });
+    });
+    it('creates a new .gitignore file when none exists', async () => {
+        await updateGitignore(scratchDir);
+        const gitignorePath = path.join(scratchDir, '.gitignore');
+        const content = await fs.readFile(gitignorePath, 'utf8');
+        expect(content).toBe('.gemini/\ngha-creds-*.json\n');
+    });
+    it('appends entries to existing .gitignore file', async () => {
+        const gitignorePath = path.join(scratchDir, '.gitignore');
+        const existingContent = '# Existing content\nnode_modules/\n';
+        await fs.writeFile(gitignorePath, existingContent);
+        await updateGitignore(scratchDir);
+        const content = await fs.readFile(gitignorePath, 'utf8');
+        expect(content).toBe('# Existing content\nnode_modules/\n\n.gemini/\ngha-creds-*.json\n');
+    });
+    it('does not add duplicate entries', async () => {
+        const gitignorePath = path.join(scratchDir, '.gitignore');
+        const existingContent = '.gemini/\nsome-other-file\ngha-creds-*.json\n';
+        await fs.writeFile(gitignorePath, existingContent);
+        await updateGitignore(scratchDir);
+        const content = await fs.readFile(gitignorePath, 'utf8');
+        expect(content).toBe(existingContent);
+    });
+    it('adds only missing entries when some already exist', async () => {
+        const gitignorePath = path.join(scratchDir, '.gitignore');
+        const existingContent = '.gemini/\nsome-other-file\n';
+        await fs.writeFile(gitignorePath, existingContent);
+        await updateGitignore(scratchDir);
+        const content = await fs.readFile(gitignorePath, 'utf8');
+        // Should add only the missing gha-creds-*.json entry
+        expect(content).toBe('.gemini/\nsome-other-file\n\ngha-creds-*.json\n');
+        expect(content).toContain('gha-creds-*.json');
+        // Should not duplicate .gemini/ entry
+        expect((content.match(/\.gemini\//g) || []).length).toBe(1);
+    });
+    it('does not get confused by entries in comments or as substrings', async () => {
+        const gitignorePath = path.join(scratchDir, '.gitignore');
+        const existingContent = [
+            '# This is a comment mentioning .gemini/ folder',
+            'my-app.gemini/config',
+            '# Another comment with gha-creds-*.json pattern',
+            'some-other-gha-creds-file.json',
+            '',
+        ].join('\n');
+        await fs.writeFile(gitignorePath, existingContent);
+        await updateGitignore(scratchDir);
+        const content = await fs.readFile(gitignorePath, 'utf8');
+        // Should add both entries since they don't actually exist as gitignore rules
+        expect(content).toContain('.gemini/');
+        expect(content).toContain('gha-creds-*.json');
+        // Verify the entries were added (not just mentioned in comments)
+        const lines = content
+            .split('\n')
+            .map((line) => line.split('#')[0].trim())
+            .filter((line) => line);
+        expect(lines).toContain('.gemini/');
+        expect(lines).toContain('gha-creds-*.json');
+        expect(lines).toContain('my-app.gemini/config');
+        expect(lines).toContain('some-other-gha-creds-file.json');
+    });
+    it('handles file system errors gracefully', async () => {
+        // Try to update gitignore in a non-existent directory
+        const nonExistentDir = path.join(scratchDir, 'non-existent');
+        // This should not throw an error
+        await expect(updateGitignore(nonExistentDir)).resolves.toBeUndefined();
+    });
+    it('handles permission errors gracefully', async () => {
+        const consoleSpy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        const fsModule = await import('node:fs');
+        const writeFileSpy = vi
+            .spyOn(fsModule.promises, 'writeFile')
+            .mockRejectedValue(new Error('Permission denied'));
+        await expect(updateGitignore(scratchDir)).resolves.toBeUndefined();
+        expect(consoleSpy).toHaveBeenCalledWith('Failed to update .gitignore:', expect.any(Error));
+        writeFileSpy.mockRestore();
+        consoleSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=setupGithubCommand.test.js.map

package/dist/src/ui/commands/setupGithubCommand.test.js.map

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

package/dist/src/ui/commands/speakCommand.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SlashCommand } from './types.js';
+export declare const speakCommand: SlashCommand;

package/dist/src/ui/commands/speakCommand.js

@@ -0,0 +1,136 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CommandKind } from './types.js';
+import { MessageType } from '../types.js';
+// Simple text cleaning for speech synthesis
+function cleanTextForSpeech(text) {
+    let cleaned = text.trim();
+    // Conservative approach - only remove obvious machine-generated garbage
+    cleaned = cleaned.replace(/\b[a-f0-9]{16,}\b/gi, 'hash'); // Only very long hashes
+    cleaned = cleaned.replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, 'UUID'); // UUIDs
+    // Clean up markdown formatting for speech
+    cleaned = cleaned.replace(/```[\s\S]*?```/g, 'code block');
+    cleaned = cleaned.replace(/`([^`]+)`/g, '$1');
+    cleaned = cleaned.replace(/\*\*([^*]+)\*\*/g, '$1');
+    cleaned = cleaned.replace(/\*([^*]+)\*/g, '$1');
+    // Clean excessive whitespace
+    cleaned = cleaned.replace(/\s+/g, ' ').trim();
+    return cleaned;
+}
+async function executeSpeech(text, voice, progress) {
+    try {
+        // Phase 1: Text cleaning
+        progress?.setPhase('cleaning');
+        await new Promise(resolve => setTimeout(resolve, 300)); // Brief delay to show animation
+        const cleanedText = cleanTextForSpeech(text);
+        // Phase 2: Sending to server
+        progress?.setPhase('sending');
+        await new Promise(resolve => setTimeout(resolve, 200));
+        const response = await fetch('http://192.168.1.5:11450/api/v1/synthesize', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                text: cleanedText,
+                voice: voice || 'Bella',
+                format: 'wav',
+                output_mode: 'computer'
+            }),
+        });
+        if (!response.ok) {
+            progress?.setError(`Server returned ${response.status}: ${response.statusText}`);
+            progress?.setPhase('error');
+            return;
+        }
+        // Phase 3: Processing response
+        progress?.setPhase('processing');
+        await response.json(); // Process the response
+        await new Promise(resolve => setTimeout(resolve, 400));
+        // Phase 4: Speaking (simulate audio duration)
+        progress?.setPhase('speaking');
+        const estimatedDuration = Math.max(1000, Math.min(text.length * 50, 5000));
+        await new Promise(resolve => setTimeout(resolve, estimatedDuration));
+        // Phase 5: Completed
+        progress?.setPhase('completed');
+    }
+    catch (error) {
+        progress?.setError(error instanceof Error ? error.message : 'Unknown error');
+        progress?.setPhase('error');
+    }
+}
+// Voice personality emojis
+const VOICE_EMOJIS = {
+    'Bella': '👩‍💼',
+    'Emma': '👩‍🎨',
+    'George': '👨‍🔧',
+    'Lewis': '👨‍💻',
+    'Sarah': '👩‍🏫',
+    'Michael': '👨‍⚖️'
+};
+export const speakCommand = {
+    name: 'speak',
+    description: 'speak text using text-to-speech',
+    kind: CommandKind.BUILT_IN,
+    action: async (context, args) => {
+        const text = args.trim();
+        // Basic validation
+        if (!text) {
+            context.ui.addItem({
+                type: MessageType.ERROR,
+                text: '❌ Usage: /speak "your message here"',
+            }, Date.now());
+            return;
+        }
+        if (text.length > 1000) {
+            context.ui.addItem({
+                type: MessageType.INFO,
+                text: '⚠️ Text too long (max 1000 chars), will be truncated',
+            }, Date.now());
+        }
+        const voice = context.session.ttsVoice || 'Bella';
+        const voiceEmoji = VOICE_EMOJIS[voice] || '🗣️';
+        const truncatedText = text.length > 1000 ? text.substring(0, 1000) : text;
+        // Create progress tracker
+        let errorMessage = '';
+        // Simple progress indicators - just loading bar and icons
+        const updateProgress = (phase, error) => {
+            const phaseConfig = {
+                cleaning: { icon: '🧹', bar: '▓░░░░' },
+                sending: { icon: '📡', bar: '▓▓░░░' },
+                processing: { icon: '⚙️', bar: '▓▓▓░░' },
+                speaking: { icon: '🎵', bar: '▓▓▓▓░' },
+                completed: { icon: '✅', bar: '▓▓▓▓▓' },
+                error: { icon: '❌', bar: '░░░░░' }
+            };
+            const config = phaseConfig[phase] || phaseConfig['cleaning'];
+            let statusText = `${config.icon} ${config.bar} ${voiceEmoji}`;
+            if (error && phase === 'error') {
+                statusText += ` ${error}`;
+            }
+            context.ui.addItem({
+                type: phase === 'error' ? MessageType.ERROR : MessageType.INFO,
+                text: statusText,
+            }, Date.now());
+        };
+        // Initial progress display
+        updateProgress('cleaning');
+        // Execute speech with rich progress tracking
+        const progress = {
+            setPhase: (phase) => {
+                updateProgress(phase, errorMessage);
+            },
+            setError: (error) => {
+                errorMessage = error;
+            }
+        };
+        // Execute in background with progress updates
+        executeSpeech(truncatedText, voice, progress).catch(() => {
+            // Error handling is done through progress callbacks
+        });
+    },
+};
+//# sourceMappingURL=speakCommand.js.map

package/dist/src/ui/commands/speakCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speakCommand.js","sourceRoot":"","sources":["../../../../src/ui/commands/speakCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,4CAA4C;AAC5C,SAAS,kBAAkB,CAAC,IAAY;IACtC,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE1B,wEAAwE;IACxE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,wBAAwB;IAClF,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,oEAAoE,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ;IAEjH,0CAA0C;IAC1C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;IAC3D,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC9C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACpD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAEhD,6BAA6B;IAC7B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAE9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAOD,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,KAAc,EAAE,QAAsB;IAC/E,IAAI,CAAC;QACH,yBAAyB;QACzB,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC/B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,gCAAgC;QACxF,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAE7C,6BAA6B;QAC7B,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,4CAA4C,EAAE;YACzE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,KAAK,IAAI,OAAO;gBACvB,MAAM,EAAE,KAAK;gBACb,WAAW,EAAE,UAAU;aACxB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACjF,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QACjC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,uBAAuB;QAC9C,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAEvD,8CAA8C;QAC9C,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC/B,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3E,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAErE,qBAAqB;QACrB,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAElC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,EAAE,QAAQ,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAC7E,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,2BAA2B;AAC3B,MAAM,YAAY,GAA2B;IAC3C,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,OAAO;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,iCAAiC;IAC9C,IAAI,EAAE,WAAW,CAAC,QAAQ;IAC1B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAEzB,mBAAmB;QACnB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;gBACE,IAAI,EAAE,WAAW,CAAC,KAAK;gBACvB,IAAI,EAAE,qCAAqC;aAC5C,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;gBACE,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,IAAI,EAAE,sDAAsD;aAC7D,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;QAClD,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;QAChD,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAE1E,0BAA0B;QAC1B,IAAI,YAAY,GAAG,EAAE,CAAC;QAEtB,0DAA0D;QAC1D,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,KAAc,EAAE,EAAE;YACvD,MAAM,WAAW,GAAgD;gBAC/D,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE;gBACtC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE;gBACrC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE;gBACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE;gBACtC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE;gBACtC,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE;aACnC,CAAC;YAEF,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,CAAC;YAC7D,IAAI,UAAU,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,GAAG,IAAI,UAAU,EAAE,CAAC;YAE9D,IAAI,KAAK,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBAC/B,UAAU,IAAI,IAAI,KAAK,EAAE,CAAC;YAC5B,CAAC;YAED,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;gBACE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI;gBAC9D,IAAI,EAAE,UAAU;aACjB,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;QACJ,CAAC,CAAC;QAEF,2BAA2B;QAC3B,cAAc,CAAC,UAAU,CAAC,CAAC;QAE3B,6CAA6C;QAC7C,MAAM,QAAQ,GAAgB;YAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClB,cAAc,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YACtC,CAAC;YACD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClB,YAAY,GAAG,KAAK,CAAC;YACvB,CAAC;SACF,CAAC;QAEF,8CAA8C;QAC9C,aAAa,CAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACvD,oDAAoD;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/src/ui/commands/statsCommand.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type SlashCommand } from './types.js';
+export declare const statsCommand: SlashCommand;

package/dist/src/ui/commands/statsCommand.js

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MessageType } from '../types.js';
+import { formatDuration } from '../utils/formatters.js';
+import { CommandKind, } from './types.js';
+export const statsCommand = {
+    name: 'stats',
+    altNames: ['usage'],
+    description: 'check session stats. Usage: /stats [model|tools]',
+    kind: CommandKind.BUILT_IN,
+    action: (context) => {
+        const now = new Date();
+        const { sessionStartTime } = context.session.stats;
+        if (!sessionStartTime) {
+            context.ui.addItem({
+                type: MessageType.ERROR,
+                text: 'Session start time is unavailable, cannot calculate stats.',
+            }, Date.now());
+            return;
+        }
+        const wallDuration = now.getTime() - sessionStartTime.getTime();
+        const statsItem = {
+            type: MessageType.STATS,
+            duration: formatDuration(wallDuration),
+        };
+        context.ui.addItem(statsItem, Date.now());
+    },
+    subCommands: [
+        {
+            name: 'model',
+            description: 'Show model-specific usage statistics.',
+            kind: CommandKind.BUILT_IN,
+            action: (context) => {
+                context.ui.addItem({
+                    type: MessageType.MODEL_STATS,
+                }, Date.now());
+            },
+        },
+        {
+            name: 'tools',
+            description: 'Show tool-specific usage statistics.',
+            kind: CommandKind.BUILT_IN,
+            action: (context) => {
+                context.ui.addItem({
+                    type: MessageType.TOOL_STATS,
+                }, Date.now());
+            },
+        },
+    ],
+};
+//# sourceMappingURL=statsCommand.js.map

package/dist/src/ui/commands/statsCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statsCommand.js","sourceRoot":"","sources":["../../../../src/ui/commands/statsCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAoB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAGL,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,WAAW,EAAE,kDAAkD;IAC/D,IAAI,EAAE,WAAW,CAAC,QAAQ;IAC1B,MAAM,EAAE,CAAC,OAAuB,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QACnD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;gBACE,IAAI,EAAE,WAAW,CAAC,KAAK;gBACvB,IAAI,EAAE,4DAA4D;aACnE,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAEhE,MAAM,SAAS,GAAqB;YAClC,IAAI,EAAE,WAAW,CAAC,KAAK;YACvB,QAAQ,EAAE,cAAc,CAAC,YAAY,CAAC;SACvC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,WAAW,EAAE;QACX;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,uCAAuC;YACpD,IAAI,EAAE,WAAW,CAAC,QAAQ;YAC1B,MAAM,EAAE,CAAC,OAAuB,EAAE,EAAE;gBAClC,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;oBACE,IAAI,EAAE,WAAW,CAAC,WAAW;iBAC9B,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;YACJ,CAAC;SACF;QACD;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,sCAAsC;YACnD,IAAI,EAAE,WAAW,CAAC,QAAQ;YAC1B,MAAM,EAAE,CAAC,OAAuB,EAAE,EAAE;gBAClC,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;oBACE,IAAI,EAAE,WAAW,CAAC,UAAU;iBAC7B,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;YACJ,CAAC;SACF;KACF;CACF,CAAC"}

package/dist/src/ui/commands/terminalSetupCommand.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SlashCommand } from './types.js';
+/**
+ * Command to configure terminal keybindings for multiline input support.
+ *
+ * This command automatically detects and configures VS Code, Cursor, and Windsurf
+ * to support Shift+Enter and Ctrl+Enter for multiline input.
+ */
+export declare const terminalSetupCommand: SlashCommand;

package/dist/src/ui/commands/terminalSetupCommand.js

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CommandKind } from './types.js';
+import { terminalSetup } from '../utils/terminalSetup.js';
+/**
+ * Command to configure terminal keybindings for multiline input support.
+ *
+ * This command automatically detects and configures VS Code, Cursor, and Windsurf
+ * to support Shift+Enter and Ctrl+Enter for multiline input.
+ */
+export const terminalSetupCommand = {
+    name: 'terminal-setup',
+    description: 'Configure terminal keybindings for multiline input (VS Code, Cursor, Windsurf)',
+    kind: CommandKind.BUILT_IN,
+    action: async () => {
+        try {
+            const result = await terminalSetup();
+            let content = result.message;
+            if (result.requiresRestart) {
+                content +=
+                    '\n\nPlease restart your terminal for the changes to take effect.';
+            }
+            return {
+                type: 'message',
+                content,
+                messageType: result.success ? 'info' : 'error',
+            };
+        }
+        catch (error) {
+            return {
+                type: 'message',
+                content: `Failed to configure terminal: ${error}`,
+                messageType: 'error',
+            };
+        }
+    },
+};
+//# sourceMappingURL=terminalSetupCommand.js.map

package/dist/src/ui/commands/terminalSetupCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalSetupCommand.js","sourceRoot":"","sources":["../../../../src/ui/commands/terminalSetupCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAqC,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAiB;IAChD,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,gFAAgF;IAClF,IAAI,EAAE,WAAW,CAAC,QAAQ;IAE1B,MAAM,EAAE,KAAK,IAAkC,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;YAErC,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC7B,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC3B,OAAO;oBACL,kEAAkE,CAAC;YACvE,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO;gBACP,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;aAC/C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,iCAAiC,KAAK,EAAE;gBACjD,WAAW,EAAE,OAAO;aACrB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/src/ui/commands/themeCommand.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SlashCommand } from './types.js';
+export declare const themeCommand: SlashCommand;