@shareai-lab/kode 1.0.71 → 1.0.73

package/src/commands/help.tsx

@@ -8,8 +8,8 @@ const help = {
   description: 'Show help and available commands',
   isEnabled: true,
   isHidden: false,
-  async call(onDone, { options: { commands } }) {
-    return <Help commands={commands} onClose={onDone} />
+  async call(onDone, context) {
+    return <Help commands={context.options?.commands || []} onClose={onDone} />
   },
   userFacingName() {
     return 'help'

package/src/commands/resume.tsx

@@ -13,7 +13,8 @@ export default {
   userFacingName() {
     return 'resume'
   },
-  async call(onDone, { options: { commands, tools, verbose } }) {
+  async call(onDone, context) {
+    const { commands = [], tools = [], verbose = false } = context.options || {}
     const logs = await loadLogList(CACHE_PATHS.messages())
     render(
       <ResumeConversation

package/src/commands/terminalSetup.ts

@@ -52,17 +52,17 @@ export function isShiftEnterKeyBindingInstalled(): boolean {
 }
 
 export function handleHashCommand(interpreted: string): void {
-  // Appends the AI-interpreted content to both KODE.md and CLAUDE.md (if exists)
+  // Appends the AI-interpreted content to both AGENTS.md and CLAUDE.md (if exists)
   try {
     const cwd = process.cwd()
-    const codeContextPath = join(cwd, 'KODE.md')
+    const codeContextPath = join(cwd, 'AGENTS.md')
     const claudePath = join(cwd, 'CLAUDE.md')
 
     // Check which files exist and update them
     const filesToUpdate = []
 
-    // Always try to update KODE.md (create if not exists)
-    filesToUpdate.push({ path: codeContextPath, name: 'KODE.md' })
+    // Always try to update AGENTS.md (create if not exists)
+    filesToUpdate.push({ path: codeContextPath, name: 'AGENTS.md' })
 
     // Update CLAUDE.md only if it exists
     try {

package/src/commands.ts

@@ -1,3 +1,4 @@
+import React from 'react'
 import bug from './commands/bug'
 import clear from './commands/clear'
 import compact from './commands/compact'
@@ -21,6 +22,7 @@ import review from './commands/review'
 import terminalSetup from './commands/terminalSetup'
 import { Tool, ToolUseContext } from './Tool'
 import resume from './commands/resume'
+import agents from './commands/agents'
 import { getMCPCommands } from './services/mcpClient'
 import { loadCustomCommands } from './services/customCommands'
 import type { MessageParam } from '@anthropic-ai/sdk/resources/index.mjs'
@@ -79,6 +81,7 @@ const INTERNAL_ONLY_COMMANDS = [ctx_viz, resume, listen]
 // Declared as a function so that we don't run this until getCommands is called,
 // since underlying functions read from config, which can't be read at module initialization time
 const COMMANDS = memoize((): Command[] => [
+  agents,
   clear,
   compact,
   config,

package/src/components/ApproveApiKey.tsx

@@ -2,7 +2,7 @@ import React from 'react'
 import { Box, Text } from 'ink'
 import { getGlobalConfig, saveGlobalConfig } from '../utils/config'
 import { getTheme } from '../utils/theme'
-import { Select } from '@inkjs/ui'
+import { Select } from './CustomSelect/select'
 import { useExitOnCtrlCD } from '../hooks/useExitOnCtrlCD'
 import chalk from 'chalk'
 

package/src/components/Config.tsx

@@ -214,13 +214,17 @@ export function Config({ onClose }: Props): React.ReactNode {
           ) : (
             <Box flexDirection="column" marginLeft={2}>
               {activeProfiles.map(profile => (
-                <Text key={profile.modelName} color={theme.secondaryText}>
-                  • {profile.name} ({profile.provider})
-                </Text>
+                <React.Fragment key={profile.modelName}>
+                  <Text color={theme.secondaryText}>
+                    • {profile.name} ({profile.provider})
+                  </Text>
+                </React.Fragment>
               ))}
-              <Text color={theme.suggestion} marginTop={1}>
-                Use /model to manage model configurations
-              </Text>
+              <Box marginTop={1}>
+                <Text color={theme.suggestion}>
+                  Use /model to manage model configurations
+                </Text>
+              </Box>
             </Box>
           )}
         </Box>

package/src/components/ConsoleOAuthFlow.tsx

@@ -288,7 +288,7 @@ export function ConsoleOAuthFlow({ onDone }: Props): React.ReactNode {
   // We need to render the copy-able URL statically to prevent Ink <Text> from inserting
   // newlines in the middle of the URL (this breaks Safari). Because <Static> components are
   // only rendered once top-to-bottom, we also need to make everything above the URL static.
-  const staticItems: Record<string, JSX.Element> = {}
+  const staticItems: Record<string, React.JSX.Element> = {}
   if (!isClearing) {
     staticItems.header = (
       <Box key="header" flexDirection="column" gap={1}>
@@ -315,9 +315,10 @@ export function ConsoleOAuthFlow({ onDone }: Props): React.ReactNode {
   }
   return (
     <Box flexDirection="column" gap={1}>
-      <Static items={Object.keys(staticItems)}>
-        {item => staticItems[item]}
-      </Static>
+      <Static 
+        items={Object.keys(staticItems)}
+        children={(item: string) => staticItems[item]}
+      />
       <Box paddingLeft={1} flexDirection="column" gap={1}>
         {renderStatusMessage()}
       </Box>

package/src/components/CustomSelect/select-option.tsx

@@ -2,7 +2,7 @@ import figures from 'figures'
 import { Box, Text } from 'ink'
 import React, { type ReactNode } from 'react'
 import { type Theme } from './theme'
-import { useComponentTheme } from '@inkjs/ui'
+import { getTheme } from '../../utils/theme'
 
 export type SelectOptionProps = {
   /**
@@ -24,6 +24,11 @@ export type SelectOptionProps = {
    * Option label.
    */
   readonly children: ReactNode
+
+  /**
+   * React key prop (handled internally by React)
+   */
+  readonly key?: React.Key
 }
 
 export function SelectOption({
@@ -31,8 +36,29 @@ export function SelectOption({
   isSelected,
   smallPointer,
   children,
+  ...props
 }: SelectOptionProps) {
-  const { styles } = useComponentTheme<Theme>('Select')
+  const appTheme = getTheme()
+  const styles = {
+    option: ({ isFocused }: { isFocused: boolean }) => ({
+      paddingLeft: 2,
+      paddingRight: 1,
+    }),
+    focusIndicator: () => ({
+      color: appTheme.claude,
+    }),
+    label: ({ isFocused, isSelected }: { isFocused: boolean; isSelected: boolean }) => ({
+      color: isSelected 
+        ? appTheme.success 
+        : isFocused 
+          ? appTheme.claude 
+          : appTheme.text,
+      bold: isSelected,
+    }),
+    selectedIndicator: () => ({
+      color: appTheme.success,
+    }),
+  }
 
   return (
     <Box {...styles.option({ isFocused })}>

package/src/components/CustomSelect/select.tsx

@@ -4,7 +4,8 @@ import { SelectOption } from './select-option'
 import { type Theme } from './theme'
 import { useSelectState } from './use-select-state'
 import { useSelect } from './use-select'
-import { Option, useComponentTheme } from '@inkjs/ui'
+import { Option } from '@inkjs/ui'
+import { getTheme } from '../../utils/theme'
 
 export type OptionSubtree = {
   /**
@@ -94,7 +95,16 @@ export function Select({
 
   useSelect({ isDisabled, state })
 
-  const { styles } = useComponentTheme<Theme>('Select')
+  const appTheme = getTheme()
+  const styles = {
+    container: () => ({
+      flexDirection: 'column' as const,
+    }),
+    highlightedText: () => ({
+      color: appTheme.text,
+      backgroundColor: appTheme.warning,
+    }),
+  }
 
   return (
     <Box {...styles.container()}>
@@ -133,9 +143,8 @@ export function Select({
             isFocused={isFocused}
             isSelected={isSelected}
             smallPointer={smallPointer}
-          >
-            {label}
-          </SelectOption>
+            children={label}
+          />
         )
       })}
     </Box>

package/src/components/CustomSelect/theme.ts

@@ -0,0 +1,45 @@
+// Theme type definitions for CustomSelect components
+// Used by select.tsx and select-option.tsx
+
+import type { BoxProps, TextProps } from 'ink'
+
+/**
+ * Theme interface for CustomSelect components
+ * Defines the style functions used by the select components
+ */
+export interface Theme {
+  /**
+   * Collection of style functions
+   */
+  styles: {
+    /**
+     * Container styles for the select box
+     */
+    container(): BoxProps
+
+    /**
+     * Styles for individual option containers
+     */
+    option(props: { isFocused: boolean }): BoxProps
+
+    /**
+     * Styles for the focus indicator (arrow/pointer)
+     */
+    focusIndicator(): TextProps
+
+    /**
+     * Styles for option labels
+     */
+    label(props: { isFocused: boolean; isSelected: boolean }): TextProps
+
+    /**
+     * Styles for the selected indicator (checkmark)
+     */
+    selectedIndicator(): TextProps
+
+    /**
+     * Styles for highlighted text in option labels
+     */
+    highlightedText(): TextProps
+  }
+}

package/src/components/Help.tsx

@@ -175,10 +175,10 @@ export function Help({
                 Custom commands loaded from:
               </Text>
               <Text color={theme.secondaryText}>
-                • {getCustomCommandDirectories().user} (user: prefix)
+                • {getCustomCommandDirectories().userClaude} (user: prefix)
               </Text>
               <Text color={theme.secondaryText}>
-                • {getCustomCommandDirectories().project} (project: prefix)
+                • {getCustomCommandDirectories().projectClaude} (project: prefix)
               </Text>
               <Text color={theme.secondaryText}>
                 Use /refresh-commands to reload after changes
@@ -190,10 +190,10 @@ export function Help({
                 Create custom commands by adding .md files to:
               </Text>
               <Text color={theme.secondaryText}>
-                • {getCustomCommandDirectories().user} (user: prefix)
+                • {getCustomCommandDirectories().userClaude} (user: prefix)
               </Text>
               <Text color={theme.secondaryText}>
-                • {getCustomCommandDirectories().project} (project: prefix)
+                • {getCustomCommandDirectories().projectClaude} (project: prefix)
               </Text>
               <Text color={theme.secondaryText}>
                 Use /refresh-commands to reload after creation

package/src/components/InvalidConfigDialog.tsx

@@ -1,7 +1,7 @@
 import React from 'react'
 import { Box, Newline, Text, useInput } from 'ink'
 import { getTheme } from '../utils/theme'
-import { Select } from '@inkjs/ui'
+import { Select } from './CustomSelect/select'
 import { render } from 'ink'
 import { writeFileSync } from 'fs'
 import { ConfigParseError } from '../utils/errors'

package/src/components/LogSelector.tsx

@@ -1,6 +1,6 @@
 import React from 'react'
 import { Box, Text } from 'ink'
-import { Select } from '@inkjs/ui'
+import { Select } from './CustomSelect/select'
 import type { LogOption } from '../types/logs'
 import { getTheme } from '../utils/theme'
 import { useTerminalSize } from '../hooks/useTerminalSize'

package/src/components/MCPServerApprovalDialog.tsx

@@ -1,7 +1,7 @@
 import React from 'react'
 import { Box, Text, useInput } from 'ink'
 import { getTheme } from '../utils/theme'
-import { Select } from '@inkjs/ui'
+import { Select } from './CustomSelect/select'
 import {
   saveCurrentProjectConfig,
   getCurrentProjectConfig,

package/src/components/Message.tsx

@@ -121,6 +121,7 @@ function UserMessage({
   options: {
     verbose: boolean
   }
+  key?: React.Key
 }): React.ReactNode {
   const { columns } = useTerminalSize()
   switch (param.type) {
@@ -176,6 +177,7 @@ function AssistantMessage({
   shouldAnimate: boolean
   shouldShowDot: boolean
   width?: number | string
+  key?: React.Key
 }): React.ReactNode {
   switch (param.type) {
     case 'tool_use':

package/src/components/ModelListManager.tsx

@@ -173,14 +173,18 @@ export function ModelListManager({ onClose }: Props): React.ReactNode {
                   <>
                     <Text color={theme.secondaryText}>({item.provider})</Text>
                     {item.usedBy.length > 0 && (
-                      <Text color={theme.success} marginLeft={1}>
-                        [Active: {item.usedBy.join(', ')}]
-                      </Text>
+                      <Box marginLeft={1}>
+                        <Text color={theme.success}>
+                          [Active: {item.usedBy.join(', ')}]
+                        </Text>
+                      </Box>
                     )}
                     {item.usedBy.length === 0 && (
-                      <Text color={theme.secondaryText} marginLeft={1}>
-                        [Available]
-                      </Text>
+                      <Box marginLeft={1}>
+                        <Text color={theme.secondaryText}>
+                          [Available]
+                        </Text>
+                      </Box>
                     )}
                   </>
                 )}

package/src/components/ModelSelector.tsx

@@ -48,13 +48,15 @@ import TextInput from './TextInput'
 import OpenAI from 'openai'
 import chalk from 'chalk'
 import { fetchAnthropicModels, verifyApiKey } from '../services/claude'
-import { fetchCustomModels } from '../services/openai'
+import { fetchCustomModels, getModelFeatures } from '../services/openai'
+import { testGPT5Connection, validateGPT5Config } from '../services/gpt5ConnectionTest'
 type Props = {
   onDone: () => void
   abortController?: AbortController
   targetPointer?: ModelPointerType // NEW: Target pointer for configuration
   isOnboarding?: boolean // NEW: Whether this is first-time setup
   onCancel?: () => void // NEW: Cancel callback (different from onDone)
+  skipModelType?: boolean // NEW: Skip model type selection
 }
 
 type ModelInfo = {
@@ -154,6 +156,7 @@ export function ModelSelector({
   targetPointer,
   isOnboarding = false,
   onCancel,
+  skipModelType = false,
 }: Props): React.ReactNode {
   const config = getGlobalConfig()
   const theme = getTheme()
@@ -1252,7 +1255,7 @@ export function ModelSelector({
       // Transform the response into our ModelInfo format
       const fetchedModels = []
       for (const model of response.data) {
-        const modelName = model.modelName || model.id || model.name || model.model || 'unknown'
+        const modelName = (model as any).modelName || (model as any).id || (model as any).name || (model as any).model || 'unknown'
         const modelInfo = models[selectedProvider as keyof typeof models]?.find(
           m => m.model === modelName,
         )
@@ -1477,7 +1480,42 @@ export function ModelSelector({
       ].includes(selectedProvider)
 
       if (isOpenAICompatible) {
-        // Define endpoints to try in order of preference
+        // 🔥 Use specialized GPT-5 connection test for GPT-5 models
+        const isGPT5 = selectedModel?.toLowerCase().includes('gpt-5')
+        
+        if (isGPT5) {
+          console.log(`🚀 Using specialized GPT-5 connection test for model: ${selectedModel}`)
+          
+          // Validate configuration first
+          const configValidation = validateGPT5Config({
+            model: selectedModel,
+            apiKey: apiKey,
+            baseURL: testBaseURL,
+            maxTokens: parseInt(maxTokens) || 8192,
+            provider: selectedProvider,
+          })
+          
+          if (!configValidation.valid) {
+            return {
+              success: false,
+              message: '❌ GPT-5 configuration validation failed',
+              details: configValidation.errors.join('\n'),
+            }
+          }
+          
+          // Use specialized GPT-5 test service
+          const gpt5Result = await testGPT5Connection({
+            model: selectedModel,
+            apiKey: apiKey,
+            baseURL: testBaseURL,
+            maxTokens: parseInt(maxTokens) || 8192,
+            provider: selectedProvider,
+          })
+          
+          return gpt5Result
+        }
+        
+        // For non-GPT-5 OpenAI-compatible models, use existing logic
         const endpointsToTry = []
 
         if (selectedProvider === 'minimax') {
@@ -1503,6 +1541,7 @@ export function ModelSelector({
               endpoint.path,
               endpoint.name,
             )
+            
             if (testResult.success) {
               return testResult
             }
@@ -1552,7 +1591,7 @@ export function ModelSelector({
     const testURL = `${baseURL.replace(/\/+$/, '')}${endpointPath}`
 
     // Create a test message that expects a specific response
-    const testPayload = {
+    const testPayload: any = {
       model: selectedModel,
       messages: [
         {
@@ -1566,6 +1605,24 @@ export function ModelSelector({
       stream: false,
     }
 
+    // GPT-5 parameter compatibility fix
+    if (selectedModel && selectedModel.toLowerCase().includes('gpt-5')) {
+      console.log(`Applying GPT-5 parameter fix for model: ${selectedModel}`)
+      
+      // GPT-5 requires max_completion_tokens instead of max_tokens
+      if (testPayload.max_tokens) {
+        testPayload.max_completion_tokens = testPayload.max_tokens
+        delete testPayload.max_tokens
+        console.log(`Transformed max_tokens → max_completion_tokens: ${testPayload.max_completion_tokens}`)
+      }
+      
+      // GPT-5 temperature handling - ensure it's 1 or undefined
+      if (testPayload.temperature !== undefined && testPayload.temperature !== 1) {
+        console.log(`Adjusting temperature from ${testPayload.temperature} to 1 for GPT-5`)
+        testPayload.temperature = 1
+      }
+    }
+
     const headers: Record<string, string> = {
       'Content-Type': 'application/json',
     }
@@ -1646,6 +1703,123 @@ export function ModelSelector({
     }
   }
 
+  async function testResponsesEndpoint(
+    baseURL: string,
+    endpointPath: string,
+    endpointName: string,
+  ): Promise<{
+    success: boolean
+    message: string
+    endpoint?: string
+    details?: string
+  }> {
+    const testURL = `${baseURL.replace(/\/+$/, '')}${endpointPath}`
+
+    // 🔧 Enhanced GPT-5 Responses API test payload
+    const testPayload: any = {
+      model: selectedModel,
+      input: [
+        {
+          role: 'user',
+          content:
+            'Please respond with exactly "YES" (in capital letters) to confirm this connection is working.',
+        },
+      ],
+      max_completion_tokens: Math.max(parseInt(maxTokens) || 8192, 8192),
+      temperature: 1, // GPT-5 only supports temperature=1
+      // 🚀 Add reasoning configuration for better GPT-5 performance
+      reasoning: {
+        effort: 'low', // Fast response for connection test
+      },
+    }
+
+    console.log(`🔧 Testing GPT-5 Responses API for model: ${selectedModel}`)
+    console.log(`🔧 Test URL: ${testURL}`)
+    console.log(`🔧 Test payload:`, JSON.stringify(testPayload, null, 2))
+
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${apiKey}`,
+    }
+
+    try {
+      const response = await fetch(testURL, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(testPayload),
+      })
+
+      if (response.ok) {
+        const data = await response.json()
+        console.log(
+          '[DEBUG] Responses API connection test response:',
+          JSON.stringify(data, null, 2),
+        )
+
+        // Extract content from Responses API format
+        let responseContent = ''
+        
+        if (data.output_text) {
+          responseContent = data.output_text
+        } else if (data.output) {
+          responseContent = typeof data.output === 'string' ? data.output : data.output.text || ''
+        }
+
+        console.log('[DEBUG] Extracted response content:', responseContent)
+
+        // Check if response contains "YES" (case insensitive)
+        const containsYes = responseContent.toLowerCase().includes('yes')
+
+        if (containsYes) {
+          return {
+            success: true,
+            message: `✅ Connection test passed with ${endpointName}`,
+            endpoint: endpointPath,
+            details: `GPT-5 responded correctly via Responses API: "${responseContent.trim()}"`,
+          }
+        } else {
+          return {
+            success: false,
+            message: `⚠️ ${endpointName} connected but model response unexpected`,
+            endpoint: endpointPath,
+            details: `Expected "YES" but got: "${responseContent.trim() || '(empty response)'}"`,
+          }
+        }
+      } else {
+        // 🔧 Enhanced error handling with detailed debugging
+        const errorData = await response.json().catch(() => null)
+        const errorMessage =
+          errorData?.error?.message || errorData?.message || response.statusText
+        
+        console.log(`🚨 GPT-5 Responses API Error (${response.status}):`, errorData)
+        
+        // 🔧 Provide specific guidance for common GPT-5 errors
+        let details = `Responses API Error: ${errorMessage}`
+        if (response.status === 400 && errorMessage.includes('max_tokens')) {
+          details += '\n🔧 Note: This appears to be a parameter compatibility issue. The fallback to Chat Completions should handle this.'
+        } else if (response.status === 404) {
+          details += '\n🔧 Note: Responses API endpoint may not be available for this model or provider.'
+        } else if (response.status === 401) {
+          details += '\n🔧 Note: API key authentication failed.'
+        }
+        
+        return {
+          success: false,
+          message: `❌ ${endpointName} failed (${response.status})`,
+          endpoint: endpointPath,
+          details: details,
+        }
+      }
+    } catch (error) {
+      return {
+        success: false,
+        message: `❌ ${endpointName} connection failed`,
+        endpoint: endpointPath,
+        details: error instanceof Error ? error.message : String(error),
+      }
+    }
+  }
+
   async function testProviderSpecificEndpoint(baseURL: string): Promise<{
     success: boolean
     message: string
@@ -3181,28 +3355,32 @@ export function ModelSelector({
 
   // Render Provider Selection Screen
   return (
-    <ScreenContainer title="Provider Selection" exitState={exitState}>
-      <Box flexDirection="column" gap={1}>
-        <Text bold>
-          Select your preferred AI provider for this model profile:
-        </Text>
-        <Box flexDirection="column" width={70}>
-          <Text color={theme.secondaryText}>
-            Choose the provider you want to use for this model profile.
-            <Newline />
-            This will determine which models are available to you.
+    <ScreenContainer 
+      title="Provider Selection" 
+      exitState={exitState}
+      children={
+        <Box flexDirection="column" gap={1}>
+          <Text bold>
+            Select your preferred AI provider for this model profile:
           </Text>
-        </Box>
+          <Box flexDirection="column" width={70}>
+            <Text color={theme.secondaryText}>
+              Choose the provider you want to use for this model profile.
+              <Newline />
+              This will determine which models are available to you.
+            </Text>
+          </Box>
 
-        <Select options={providerOptions} onChange={handleProviderSelection} />
+          <Select options={providerOptions} onChange={handleProviderSelection} />
 
-        <Box marginTop={1}>
-          <Text dimColor>
-            You can change this later by running{' '}
-            <Text color={theme.suggestion}>/model</Text> again
-          </Text>
+          <Box marginTop={1}>
+            <Text dimColor>
+              You can change this later by running{' '}
+              <Text color={theme.suggestion}>/model</Text> again
+            </Text>
+          </Box>
         </Box>
-      </Box>
-    </ScreenContainer>
+      }
+    />
   )
 }