fss-link 1.0.40 → 1.0.45

package/dist/ui/commands/types.ts

@@ -0,0 +1,204 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { type ReactNode } from 'react';
+import { Content } from '@google/genai';
+import { HistoryItemWithoutId } from '../types.js';
+import { Config, GitService, Logger } from 'fss-link-core';
+import { LoadedSettings } from '../../config/settings.js';
+import { UseHistoryManagerReturn } from '../hooks/useHistoryManager.js';
+import type { HistoryItem } from '../types.js';
+import { SessionStatsState } from '../contexts/SessionContext.js';
+
+// Grouped dependencies for clarity and easier mocking
+export interface CommandContext {
+  // Invocation properties for when commands are called.
+  invocation?: {
+    /** The raw, untrimmed input string from the user. */
+    raw: string;
+    /** The primary name of the command that was matched. */
+    name: string;
+    /** The arguments string that follows the command name. */
+    args: string;
+  };
+  // Core services and configuration
+  services: {
+    // TODO(abhipatel12): Ensure that config is never null.
+    config: Config | null;
+    settings: LoadedSettings;
+    git: GitService | undefined;
+    logger: Logger;
+  };
+  // UI state and history management
+  ui: {
+    /** Adds a new item to the history display. */
+    addItem: UseHistoryManagerReturn['addItem'];
+    /** Clears all history items and the console screen. */
+    clear: () => void;
+    /**
+     * Sets the transient debug message displayed in the application footer in debug mode.
+     */
+    setDebugMessage: (message: string) => void;
+    /** The currently pending history item, if any. */
+    pendingItem: HistoryItemWithoutId | null;
+    /**
+     * Sets a pending item in the history, which is useful for indicating
+     * that a long-running operation is in progress.
+     *
+     * @param item The history item to display as pending, or `null` to clear.
+     */
+    setPendingItem: (item: HistoryItemWithoutId | null) => void;
+    /**
+     * Loads a new set of history items, replacing the current history.
+     *
+     * @param history The array of history items to load.
+     */
+    loadHistory: UseHistoryManagerReturn['loadHistory'];
+    /** Toggles a special display mode. */
+    toggleCorgiMode: () => void;
+    toggleVimEnabled: () => Promise<boolean>;
+    setGeminiMdFileCount: (count: number) => void;
+    reloadCommands: () => void;
+    /** Set the TTS voice for the current session */
+    setTtsVoice: (voice: string) => void;
+    /** Enable or disable TTS for the current session */
+    setTtsEnabled: (enabled: boolean) => void;
+  };
+  // Session-specific data
+  session: {
+    stats: SessionStatsState;
+    /** A transient list of shell commands the user has approved for this session. */
+    sessionShellAllowlist: Set<string>;
+    /** TTS voice selection for this session */
+    ttsVoice?: string;
+    /** Whether TTS is enabled for this session */
+    ttsEnabled?: boolean;
+  };
+  // Flag to indicate if an overwrite has been confirmed
+  overwriteConfirmed?: boolean;
+}
+
+/**
+ * The return type for a command action that results in scheduling a tool call.
+ */
+export interface ToolActionReturn {
+  type: 'tool';
+  toolName: string;
+  toolArgs: Record<string, unknown>;
+}
+
+/** The return type for a command action that results in the app quitting. */
+export interface QuitActionReturn {
+  type: 'quit';
+  messages: HistoryItem[];
+}
+
+/**
+ * The return type for a command action that results in a simple message
+ * being displayed to the user.
+ */
+export interface MessageActionReturn {
+  type: 'message';
+  messageType: 'info' | 'error';
+  content: string;
+}
+
+/**
+ * The return type for a command action that needs to open a dialog.
+ */
+export interface OpenDialogActionReturn {
+  type: 'dialog';
+
+  dialog: 'help' | 'auth' | 'theme' | 'editor' | 'privacy' | 'settings' | 'search';
+}
+
+/**
+ * The return type for a command action that results in replacing
+ * the entire conversation history.
+ */
+export interface LoadHistoryActionReturn {
+  type: 'load_history';
+  history: HistoryItemWithoutId[];
+  clientHistory: Content[]; // The history for the generative client
+}
+
+/**
+ * The return type for a command action that should immediately submit
+ * content as a prompt to the Gemini model.
+ */
+export interface SubmitPromptActionReturn {
+  type: 'submit_prompt';
+  content: string;
+}
+
+/**
+ * The return type for a command action that needs to pause and request
+ * confirmation for a set of shell commands before proceeding.
+ */
+export interface ConfirmShellCommandsActionReturn {
+  type: 'confirm_shell_commands';
+  /** The list of shell commands that require user confirmation. */
+  commandsToConfirm: string[];
+  /** The original invocation context to be re-run after confirmation. */
+  originalInvocation: {
+    raw: string;
+  };
+}
+
+export interface ConfirmActionReturn {
+  type: 'confirm_action';
+  /** The React node to display as the confirmation prompt. */
+  prompt: ReactNode;
+  /** The original invocation context to be re-run after confirmation. */
+  originalInvocation: {
+    raw: string;
+  };
+}
+
+export type SlashCommandActionReturn =
+  | ToolActionReturn
+  | MessageActionReturn
+  | QuitActionReturn
+  | OpenDialogActionReturn
+  | LoadHistoryActionReturn
+  | SubmitPromptActionReturn
+  | ConfirmShellCommandsActionReturn
+  | ConfirmActionReturn;
+
+export enum CommandKind {
+  BUILT_IN = 'built-in',
+  FILE = 'file',
+  MCP_PROMPT = 'mcp-prompt',
+}
+
+// The standardized contract for any command in the system.
+export interface SlashCommand {
+  name: string;
+  altNames?: string[];
+  description: string;
+
+  kind: CommandKind;
+
+  // Optional metadata for extension commands
+  extensionName?: string;
+
+  // The action to run. Optional for parent commands that only group sub-commands.
+  action?: (
+    context: CommandContext,
+    args: string, // TODO: Remove args. CommandContext now contains the complete invocation.
+  ) =>
+    | void
+    | SlashCommandActionReturn
+    | Promise<void | SlashCommandActionReturn>;
+
+  // Provides argument completion (e.g., completing a tag for `/chat resume <tag>`).
+  completion?: (
+    context: CommandContext,
+    partialArg: string,
+  ) => Promise<string[]>;
+
+  subCommands?: SlashCommand[];
+}

package/dist/ui/commands/vimCommand.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { CommandKind, SlashCommand } from './types.js';
+
+export const vimCommand: SlashCommand = {
+  name: 'vim',
+  description: 'toggle vim mode on/off',
+  kind: CommandKind.BUILT_IN,
+  action: async (context, _args) => {
+    const newVimState = await context.ui.toggleVimEnabled();
+
+    const message = newVimState
+      ? 'Entered Vim mode. Run /vim again to exit.'
+      : 'Exited Vim mode.';
+    return {
+      type: 'message',
+      messageType: 'info',
+      content: message,
+    };
+  },
+};

package/dist/ui/commands/voiceCommand.ts

@@ -0,0 +1,125 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { CommandKind, SlashCommand } from './types.js';
+import { MessageType } from '../types.js';
+
+const AVAILABLE_VOICES = [
+  'Bella',
+  'Emma', 
+  'George',
+  'Lewis',
+  'Sarah',
+  'Michael'
+];
+
+export const voiceCommand: SlashCommand = {
+  name: 'voice',
+  description: 'set TTS voice',
+  kind: CommandKind.BUILT_IN,
+  action: async (context, args) => {
+    const voiceName = args.trim();
+    
+    // Show available voices if no argument
+    if (!voiceName) {
+      const currentVoice = context.session.ttsVoice || 'Bella';
+      
+      // Voice personality emojis and descriptions
+      const voiceDetails: Record<string, {emoji: string, description: string}> = {
+        'Bella': { emoji: '👩‍💼', description: 'Warm, supportive colleague' },
+        'Emma': { emoji: '👩‍🎨', description: 'Versatile development specialist' }, 
+        'George': { emoji: '👨‍🔧', description: 'Casual Australian practical mate' },
+        'Lewis': { emoji: '👨‍💻', description: 'Enthusiastic technical consultant' },
+        'Sarah': { emoji: '👩‍🏫', description: 'Accessibility-focused clear communication' },
+        'Michael': { emoji: '👨‍⚖️', description: 'Technical precision professional' }
+      };
+      
+      // Header with FSS Link styling
+      let message = `┌─────────────────────────────────┐\n`;
+      message += `│  🎙️ Voice Selection             │\n`;
+      message += `└─────────────────────────────────┘\n\n`;
+      
+      // Current voice status
+      message += `Current Voice:\n`;
+      message += `  ${voiceDetails[currentVoice]?.emoji || '🗣️'} ${currentVoice} - ${voiceDetails[currentVoice]?.description || 'Standard voice'}\n\n`;
+      
+      message += `Available Voices:\n`;
+      
+      AVAILABLE_VOICES.forEach((voice, _index) => {
+        const details = voiceDetails[voice];
+        const marker = voice === currentVoice ? '▶' : ' ';
+        const emoji = details?.emoji || '🗣️';
+        const desc = details?.description || 'Standard voice';
+        message += `${marker} ${emoji} ${voice} - ${desc}\n`;
+      });
+      
+      message += `\n┌─────────────────────────────────────────────────────────┐\n`;
+      message += `│ Usage: /voice <VoiceName>                              │\n`;
+      message += `│ Test:  /speak "Hello, this is my new voice!"           │\n`;
+      message += `└─────────────────────────────────────────────────────────┘`;
+      
+      context.ui.addItem(
+        {
+          type: MessageType.INFO,
+          text: message,
+        },
+        Date.now()
+      );
+      return;
+    }
+    
+    // Validate voice name
+    const voice = AVAILABLE_VOICES.find(v => 
+      v.toLowerCase() === voiceName.toLowerCase()
+    );
+    
+    if (!voice) {
+      context.ui.addItem(
+        {
+          type: MessageType.ERROR,
+          text: `❌ Unknown voice: ${voiceName}\nAvailable: ${AVAILABLE_VOICES.join(', ')}`,
+        },
+        Date.now()
+      );
+      return;
+    }
+    
+    // Set voice using setter
+    context.ui.setTtsVoice(voice);
+    
+    // Rich confirmation with voice details
+    const voiceDetails: Record<string, {emoji: string, description: string}> = {
+      'Bella': { emoji: '👩‍💼', description: 'Warm, supportive colleague' },
+      'Emma': { emoji: '👩‍🎨', description: 'Versatile development specialist' }, 
+      'George': { emoji: '👨‍🔧', description: 'Casual Australian practical mate' },
+      'Lewis': { emoji: '👨‍💻', description: 'Enthusiastic technical consultant' },
+      'Sarah': { emoji: '👩‍🏫', description: 'Accessibility-focused clear communication' },
+      'Michael': { emoji: '👨‍⚖️', description: 'Technical precision professional' }
+    };
+    
+    const details = voiceDetails[voice];
+    let confirmation = `┌─────────────────────────────────┐\n`;
+    confirmation += `│  🎙️ Voice Changed Successfully  │\n`;
+    confirmation += `└─────────────────────────────────┘\n\n`;
+    confirmation += `${details?.emoji || '🗣️'} Now using: ${voice}\n`;
+    confirmation += `${details?.description || 'Standard voice'}\n\n`;
+    confirmation += `💡 Test: /speak "Hello, this is my new voice!"`;
+    
+    context.ui.addItem(
+      {
+        type: MessageType.INFO,
+        text: confirmation,
+      },
+      Date.now()
+    );
+  },
+  
+  completion: async (context, partialArg) => 
+    // Provide voice name completion
+    AVAILABLE_VOICES.filter(voice => 
+      voice.toLowerCase().startsWith(partialArg.toLowerCase())
+    ),
+};

package/dist/ui/components/AboutBox.tsx

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import React from 'react';
+import { Box, Text } from 'ink';
+import { Colors } from '../colors.js';
+import { GIT_COMMIT_INFO } from '../../generated/git-commit.js';
+
+interface AboutBoxProps {
+  cliVersion: string;
+  osVersion: string;
+  sandboxEnv: string;
+  modelVersion: string;
+  selectedAuthType: string;
+  gcpProject: string;
+  ideClient: string;
+}
+
+export const AboutBox: React.FC<AboutBoxProps> = ({
+  cliVersion,
+  osVersion,
+  sandboxEnv,
+  modelVersion,
+  selectedAuthType,
+  gcpProject,
+  ideClient,
+}) => (
+  <Box
+    borderStyle="round"
+    borderColor={Colors.Gray}
+    flexDirection="column"
+    padding={1}
+    marginY={1}
+    width="100%"
+  >
+    <Box marginBottom={1}>
+      <Text bold color={Colors.AccentPurple}>
+        About FSS Link
+      </Text>
+    </Box>
+    <Box flexDirection="row">
+      <Box width="35%">
+        <Text bold color={Colors.LightBlue}>
+          CLI Version
+        </Text>
+      </Box>
+      <Box>
+        <Text>{cliVersion}</Text>
+      </Box>
+    </Box>
+    {GIT_COMMIT_INFO && !['N/A'].includes(GIT_COMMIT_INFO) && (
+      <Box flexDirection="row">
+        <Box width="35%">
+          <Text bold color={Colors.LightBlue}>
+            Git Commit
+          </Text>
+        </Box>
+        <Box>
+          <Text>{GIT_COMMIT_INFO}</Text>
+        </Box>
+      </Box>
+    )}
+    <Box flexDirection="row">
+      <Box width="35%">
+        <Text bold color={Colors.LightBlue}>
+          Model
+        </Text>
+      </Box>
+      <Box>
+        <Text>{modelVersion}</Text>
+      </Box>
+    </Box>
+    <Box flexDirection="row">
+      <Box width="35%">
+        <Text bold color={Colors.LightBlue}>
+          Sandbox
+        </Text>
+      </Box>
+      <Box>
+        <Text>{sandboxEnv}</Text>
+      </Box>
+    </Box>
+    <Box flexDirection="row">
+      <Box width="35%">
+        <Text bold color={Colors.LightBlue}>
+          OS
+        </Text>
+      </Box>
+      <Box>
+        <Text>{osVersion}</Text>
+      </Box>
+    </Box>
+    <Box flexDirection="row">
+      <Box width="35%">
+        <Text bold color={Colors.LightBlue}>
+          Auth Method
+        </Text>
+      </Box>
+      <Box>
+        <Text>
+          {selectedAuthType.startsWith('oauth') ? 'OAuth' : selectedAuthType}
+        </Text>
+      </Box>
+    </Box>
+    {gcpProject && (
+      <Box flexDirection="row">
+        <Box width="35%">
+          <Text bold color={Colors.LightBlue}>
+            GCP Project
+          </Text>
+        </Box>
+        <Box>
+          <Text>{gcpProject}</Text>
+        </Box>
+      </Box>
+    )}
+    {ideClient && (
+      <Box flexDirection="row">
+        <Box width="35%">
+          <Text bold color={Colors.LightBlue}>
+            IDE Client
+          </Text>
+        </Box>
+        <Box>
+          <Text>{ideClient}</Text>
+        </Box>
+      </Box>
+    )}
+  </Box>
+);

package/dist/ui/components/AsciiArt.ts

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export const shortAsciiLogo = `
+ ███████╗███████╗███████╗
+ ██╔════╝██╔════╝██╔════╝
+ █████╗  ███████╗███████╗
+ ██╔══╝  ╚════██║╚════██║
+ ██║     ███████║███████║
+ ╚═╝     ╚══════╝╚══════╝
+ 
+ ██╗     ██╗███╗   ██╗██╗  ██╗
+ ██║     ██║████╗  ██║██║ ██╔╝
+ ██║     ██║██╔██╗ ██║█████╔╝ 
+ ██║     ██║██║╚██╗██║██╔═██╗ 
+ ███████╗██║██║ ╚████║██║  ██╗
+ ╚══════╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝
+`;
+export const longAsciiLogo = `
+╔════════════════════════════════╗
+║                                ║
+║ ███████╗███████╗███████╗       ║
+║ ██╔════╝██╔════╝██╔════╝       ║
+║ █████╗  ███████╗███████╗       ║
+║ ██╔══╝  ╚════██║╚════██║       ║
+║ ██║     ███████║███████║       ║
+║ ╚═╝     ╚══════╝╚══════╝       ║
+║                                ║
+║ ██╗     ██╗███╗   ██╗██╗  ██╗  ║
+║ ██║     ██║████╗  ██║██║ ██╔╝  ║
+║ ██║     ██║██╔██╗ ██║█████╔╝   ║
+║ ██║     ██║██║╚██╗██║██╔═██╗   ║
+║ ███████╗██║██║ ╚████║██║  ██╗  ║
+║ ╚══════╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝  ║
+║                                ║
+╚════════════════════════════════╝
+`;
+
+export const tinyAsciiLogo = `
+███████ ███████ ███████
+██      ██      ██     
+█████   ███████ ███████
+██           ██      ██
+██      ███████ ███████
+
+██      ██ ███  ██ ██   ██
+██      ██ ████ ██ ██  ██ 
+██      ██ ██ ████ █████  
+██      ██ ██  ███ ██  ██ 
+███████ ██ ██   ██ ██   ██
+`;