@shareai-lab/kode 1.0.69 → 1.0.71

package/src/utils/PersistentShell.ts

@@ -0,0 +1,373 @@
+import * as fs from 'fs'
+import { homedir } from 'os'
+import { existsSync } from 'fs'
+import shellquote from 'shell-quote'
+import { spawn, execSync, type ChildProcess } from 'child_process'
+import { isAbsolute, resolve, join } from 'path'
+import { logError } from './log'
+import * as os from 'os'
+import { logEvent } from '../services/statsig'
+import { PRODUCT_COMMAND } from '../constants/product'
+
+type ExecResult = {
+  stdout: string
+  stderr: string
+  code: number
+  interrupted: boolean
+}
+type QueuedCommand = {
+  command: string
+  abortSignal?: AbortSignal
+  timeout?: number
+  resolve: (result: ExecResult) => void
+  reject: (error: Error) => void
+}
+
+const TEMPFILE_PREFIX = os.tmpdir() + `/${PRODUCT_COMMAND}-`
+const DEFAULT_TIMEOUT = 30 * 60 * 1000
+const SIGTERM_CODE = 143 // Standard exit code for SIGTERM
+const FILE_SUFFIXES = {
+  STATUS: '-status',
+  STDOUT: '-stdout',
+  STDERR: '-stderr',
+  CWD: '-cwd',
+}
+const SHELL_CONFIGS: Record<string, string> = {
+  '/bin/bash': '.bashrc',
+  '/bin/zsh': '.zshrc',
+}
+
+export class PersistentShell {
+  private commandQueue: QueuedCommand[] = []
+  private isExecuting: boolean = false
+  private shell: ChildProcess
+  private isAlive: boolean = true
+  private commandInterrupted: boolean = false
+  private statusFile: string
+  private stdoutFile: string
+  private stderrFile: string
+  private cwdFile: string
+  private cwd: string
+  private binShell: string
+
+  constructor(cwd: string) {
+    this.binShell = process.env.SHELL || '/bin/bash'
+    this.shell = spawn(this.binShell, ['-l'], {
+      stdio: ['pipe', 'pipe', 'pipe'],
+      cwd,
+      env: {
+        ...process.env,
+        GIT_EDITOR: 'true',
+      },
+    })
+
+    this.cwd = cwd
+
+    this.shell.on('exit', (code, signal) => {
+      if (code) {
+        // TODO: It would be nice to alert the user that shell crashed
+        logError(`Shell exited with code ${code} and signal ${signal}`)
+        logEvent('persistent_shell_exit', {
+          code: code?.toString() || 'null',
+          signal: signal || 'null',
+        })
+      }
+      for (const file of [
+        this.statusFile,
+        this.stdoutFile,
+        this.stderrFile,
+        this.cwdFile,
+      ]) {
+        if (fs.existsSync(file)) {
+          fs.unlinkSync(file)
+        }
+      }
+      this.isAlive = false
+    })
+
+    const id = Math.floor(Math.random() * 0x10000)
+      .toString(16)
+      .padStart(4, '0')
+
+    this.statusFile = TEMPFILE_PREFIX + id + FILE_SUFFIXES.STATUS
+    this.stdoutFile = TEMPFILE_PREFIX + id + FILE_SUFFIXES.STDOUT
+    this.stderrFile = TEMPFILE_PREFIX + id + FILE_SUFFIXES.STDERR
+    this.cwdFile = TEMPFILE_PREFIX + id + FILE_SUFFIXES.CWD
+    for (const file of [this.statusFile, this.stdoutFile, this.stderrFile]) {
+      fs.writeFileSync(file, '')
+    }
+    // Initialize CWD file with initial directory
+    fs.writeFileSync(this.cwdFile, cwd)
+    const configFile = SHELL_CONFIGS[this.binShell]
+    if (configFile) {
+      const configFilePath = join(homedir(), configFile)
+      if (existsSync(configFilePath)) {
+        this.sendToShell(`source ${configFilePath}`)
+      }
+    }
+  }
+
+  private static instance: PersistentShell | null = null
+
+  static restart() {
+    if (PersistentShell.instance) {
+      PersistentShell.instance.close()
+      PersistentShell.instance = null
+    }
+  }
+
+  static getInstance(): PersistentShell {
+    if (!PersistentShell.instance || !PersistentShell.instance.isAlive) {
+      PersistentShell.instance = new PersistentShell(process.cwd())
+    }
+    return PersistentShell.instance
+  }
+
+  killChildren() {
+    const parentPid = this.shell.pid
+    try {
+      const childPids = execSync(`pgrep -P ${parentPid}`)
+        .toString()
+        .trim()
+        .split('\n')
+        .filter(Boolean) // Filter out empty strings
+
+      if (childPids.length > 0) {
+        logEvent('persistent_shell_command_interrupted', {
+          numChildProcesses: childPids.length.toString(),
+        })
+      }
+
+      childPids.forEach(pid => {
+        try {
+          process.kill(Number(pid), 'SIGTERM')
+        } catch (error) {
+          logError(`Failed to kill process ${pid}: ${error}`)
+          logEvent('persistent_shell_kill_process_error', {
+            error: (error as Error).message.substring(0, 10),
+          })
+        }
+      })
+    } catch {
+      // pgrep returns non-zero when no processes are found - this is expected
+    } finally {
+      this.commandInterrupted = true
+    }
+  }
+
+  private async processQueue() {
+    /**
+     * Processes commands from the queue one at a time.
+     * Concurrency invariants:
+     * - Only one instance runs at a time (controlled by isExecuting)
+     * - Is the only caller of updateCwd() in the system
+     * - Calls updateCwd() after each command completes
+     * - Ensures commands execute serially via the queue
+     * - Handles interruption via abortSignal by calling killChildren()
+     * - Cleans up abortSignal listeners after command completion or interruption
+     */
+    if (this.isExecuting || this.commandQueue.length === 0) return
+
+    this.isExecuting = true
+    const { command, abortSignal, timeout, resolve, reject } =
+      this.commandQueue.shift()!
+
+    const killChildren = () => this.killChildren()
+    if (abortSignal) {
+      abortSignal.addEventListener('abort', killChildren)
+    }
+
+    try {
+      const result = await this.exec_(command, timeout)
+
+      // No need to update cwd - it's handled in exec_ via the CWD file
+
+      resolve(result)
+    } catch (error) {
+      logEvent('persistent_shell_command_error', {
+        error: (error as Error).message.substring(0, 10),
+      })
+      reject(error as Error)
+    } finally {
+      this.isExecuting = false
+      if (abortSignal) {
+        abortSignal.removeEventListener('abort', killChildren)
+      }
+      // Process next command in queue
+      this.processQueue()
+    }
+  }
+
+  async exec(
+    command: string,
+    abortSignal?: AbortSignal,
+    timeout?: number,
+  ): Promise<ExecResult> {
+    return new Promise((resolve, reject) => {
+      this.commandQueue.push({ command, abortSignal, timeout, resolve, reject })
+      this.processQueue()
+    })
+  }
+
+  private async exec_(command: string, timeout?: number): Promise<ExecResult> {
+    /**
+     * Direct command execution without going through the queue.
+     * Concurrency invariants:
+     * - Not safe for concurrent calls (uses shared files)
+     * - Called only when queue is idle
+     * - Relies on file-based IPC to handle shell interaction
+     * - Does not modify the command queue state
+     * - Tracks interruption state via commandInterrupted flag
+     * - Resets interruption state at start of new command
+     * - Reports interruption status in result object
+     *
+     * Exit Code & CWD Handling:
+     * - Executes command and immediately captures its exit code into a shell variable
+     * - Updates the CWD file with the working directory after capturing exit code
+     * - Writes the preserved exit code to the status file as the final step
+     * - This sequence eliminates race conditions between exit code capture and CWD updates
+     * - The pwd() method reads the CWD file directly for current directory info
+     */
+    const quotedCommand = shellquote.quote([command])
+
+    // Check the syntax of the command
+    try {
+      execSync(`${this.binShell} -n -c ${quotedCommand}`, {
+        stdio: 'ignore',
+        timeout: 1000,
+      })
+    } catch (stderr) {
+      // If there's a syntax error, return an error and log it
+      const errorStr =
+        typeof stderr === 'string' ? stderr : String(stderr || '')
+      logEvent('persistent_shell_syntax_error', {
+        error: errorStr.substring(0, 10),
+      })
+      return Promise.resolve({
+        stdout: '',
+        stderr: errorStr,
+        code: 128,
+        interrupted: false,
+      })
+    }
+
+    const commandTimeout = timeout || DEFAULT_TIMEOUT
+    // Reset interrupted state for new command
+    this.commandInterrupted = false
+    return new Promise<ExecResult>(resolve => {
+      // Truncate output files
+      fs.writeFileSync(this.stdoutFile, '')
+      fs.writeFileSync(this.stderrFile, '')
+      fs.writeFileSync(this.statusFile, '')
+      // Break up the command sequence for clarity using an array of commands
+      const commandParts = []
+
+      // 1. Execute the main command with redirections
+      commandParts.push(
+        `eval ${quotedCommand} < /dev/null > ${this.stdoutFile} 2> ${this.stderrFile}`,
+      )
+
+      // 2. Capture exit code immediately after command execution to avoid losing it
+      commandParts.push(`EXEC_EXIT_CODE=$?`)
+
+      // 3. Update CWD file
+      commandParts.push(`pwd > ${this.cwdFile}`)
+
+      // 4. Write the preserved exit code to status file to avoid race with pwd
+      commandParts.push(`echo $EXEC_EXIT_CODE > ${this.statusFile}`)
+
+      // Send the combined commands as a single operation to maintain atomicity
+      this.sendToShell(commandParts.join('\n'))
+
+      // Check for command completion or timeout
+      const start = Date.now()
+      const checkCompletion = setInterval(() => {
+        try {
+          let statusFileSize = 0
+          if (fs.existsSync(this.statusFile)) {
+            statusFileSize = fs.statSync(this.statusFile).size
+          }
+
+          if (
+            statusFileSize > 0 ||
+            Date.now() - start > commandTimeout ||
+            this.commandInterrupted
+          ) {
+            clearInterval(checkCompletion)
+            const stdout = fs.existsSync(this.stdoutFile)
+              ? fs.readFileSync(this.stdoutFile, 'utf8')
+              : ''
+            let stderr = fs.existsSync(this.stderrFile)
+              ? fs.readFileSync(this.stderrFile, 'utf8')
+              : ''
+            let code: number
+            if (statusFileSize) {
+              code = Number(fs.readFileSync(this.statusFile, 'utf8'))
+            } else {
+              // Timeout occurred - kill any running processes
+              this.killChildren()
+              code = SIGTERM_CODE
+              stderr += (stderr ? '\n' : '') + 'Command execution timed out'
+              logEvent('persistent_shell_command_timeout', {
+                command: command.substring(0, 10),
+                timeout: commandTimeout.toString(),
+              })
+            }
+            resolve({
+              stdout,
+              stderr,
+              code,
+              interrupted: this.commandInterrupted,
+            })
+          }
+        } catch {
+          // Ignore file system errors during polling - they are expected
+          // as we check for completion before files exist
+        }
+      }, 10) // increasing this will introduce latency
+    })
+  }
+
+  private sendToShell(command: string) {
+    try {
+      this.shell!.stdin!.write(command + '\n')
+    } catch (error) {
+      const errorString =
+        error instanceof Error
+          ? error.message
+          : String(error || 'Unknown error')
+      logError(`Error in sendToShell: ${errorString}`)
+      logEvent('persistent_shell_write_error', {
+        error: errorString.substring(0, 100),
+        command: command.substring(0, 30),
+      })
+      throw error
+    }
+  }
+
+  pwd(): string {
+    try {
+      const newCwd = fs.readFileSync(this.cwdFile, 'utf8').trim()
+      if (newCwd) {
+        this.cwd = newCwd
+      }
+    } catch (error) {
+      logError(`Shell pwd error ${error}`)
+    }
+    // Always return the cached value
+    return this.cwd
+  }
+
+  async setCwd(cwd: string) {
+    const resolved = isAbsolute(cwd) ? cwd : resolve(process.cwd(), cwd)
+    if (!existsSync(resolved)) {
+      throw new Error(`Path "${resolved}" does not exist`)
+    }
+    await this.exec(`cd ${resolved}`)
+  }
+
+  close(): void {
+    this.shell!.stdin!.end()
+    this.shell.kill()
+  }
+}

package/src/utils/agentStorage.ts

@@ -0,0 +1,97 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs'
+import { join } from 'path'
+import { homedir } from 'os'
+import { randomUUID } from 'crypto'
+
+/**
+ * Agent Storage Utilities
+ * Provides file-based state isolation for different agents
+ * Based on Kode's Agent ID architecture
+ */
+
+/**
+ * Get the kode config directory
+ */
+function getConfigDirectory(): string {
+  return process.env.KODE_CONFIG_DIR ?? process.env.ANYKODE_CONFIG_DIR ?? join(homedir(), '.kode')
+}
+
+/**
+ * Get the current session ID
+ */
+function getSessionId(): string {
+  // This should be set when the session starts
+  return process.env.ANYKODE_SESSION_ID ?? 'default-session'
+}
+
+/**
+ * Generate agent-specific file path
+ * Pattern: ${sessionId}-agent-${agentId}.json
+ * Stored in ~/.kode/ directory
+ */
+export function getAgentFilePath(agentId: string): string {
+  const sessionId = getSessionId()
+  const filename = `${sessionId}-agent-${agentId}.json`
+  const configDir = getConfigDirectory()
+
+  // Ensure kode config directory exists
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true })
+  }
+
+  return join(configDir, filename)
+}
+
+/**
+ * Read agent-specific data from storage
+ */
+export function readAgentData<T = any>(agentId: string): T | null {
+  const filePath = getAgentFilePath(agentId)
+
+  if (!existsSync(filePath)) {
+    return null
+  }
+
+  try {
+    const content = readFileSync(filePath, 'utf-8')
+    return JSON.parse(content) as T
+  } catch (error) {
+    console.error(`Failed to read agent data for ${agentId}:`, error)
+    return null
+  }
+}
+
+/**
+ * Write agent-specific data to storage
+ */
+export function writeAgentData<T = any>(agentId: string, data: T): void {
+  const filePath = getAgentFilePath(agentId)
+
+  try {
+    writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8')
+  } catch (error) {
+    console.error(`Failed to write agent data for ${agentId}:`, error)
+    throw error
+  }
+}
+
+/**
+ * Get default agent ID if none is provided
+ */
+export function getDefaultAgentId(): string {
+  return 'default'
+}
+
+/**
+ * Resolve agent ID from context
+ */
+export function resolveAgentId(agentId?: string): string {
+  return agentId || getDefaultAgentId()
+}
+
+/**
+ * Generate a new unique Agent ID
+ */
+export function generateAgentId(): string {
+  return randomUUID()
+}

package/src/utils/array.ts

@@ -0,0 +1,3 @@
+export function intersperse<A>(as: A[], separator: (index: number) => A): A[] {
+  return as.flatMap((a, i) => (i ? [separator(i), a] : [a]))
+}

package/src/utils/ask.tsx

@@ -0,0 +1,98 @@
+import { last } from 'lodash-es'
+import { Command } from '../commands'
+import { getSystemPrompt } from '../constants/prompts'
+import { getContext } from '../context'
+import { getTotalCost } from '../cost-tracker'
+import { Message, query } from '../query'
+import { CanUseToolFn } from '../hooks/useCanUseTool'
+import { Tool } from '../Tool'
+import { getModelManager } from '../utils/model'
+import { setCwd } from './state'
+import { getMessagesPath, overwriteLog } from './log'
+import { createUserMessage } from './messages'
+
+type Props = {
+  commands: Command[]
+  safeMode?: boolean
+  hasPermissionsToUseTool: CanUseToolFn
+  messageLogName: string
+  prompt: string
+  cwd: string
+  tools: Tool[]
+  verbose?: boolean
+}
+
+// Sends a single prompt to the Claude API and returns the response.
+// Assumes that claude is being used non-interactively -- will not
+// ask the user for permissions or further input.
+export async function ask({
+  commands,
+  safeMode,
+  hasPermissionsToUseTool,
+  messageLogName,
+  prompt,
+  cwd,
+  tools,
+  verbose = false,
+}: Props): Promise<{
+  resultText: string
+  totalCost: number
+  messageHistoryFile: string
+}> {
+  await setCwd(cwd)
+  const message = createUserMessage(prompt)
+  const messages: Message[] = [message]
+
+  const [systemPrompt, context, model] = await Promise.all([
+    getSystemPrompt(),
+    getContext(),
+    getModelManager().getModelName('main'),
+  ])
+
+  for await (const m of query(
+    messages,
+    systemPrompt,
+    context,
+    hasPermissionsToUseTool,
+    {
+      options: {
+        commands,
+        tools,
+        verbose,
+        safeMode,
+        forkNumber: 0,
+        messageLogName: 'unused',
+        maxThinkingTokens: 0,
+      },
+      abortController: new AbortController(),
+      messageId: undefined,
+      readFileTimestamps: {},
+    },
+  )) {
+    messages.push(m)
+  }
+
+  const result = last(messages)
+  if (!result || result.type !== 'assistant') {
+    throw new Error('Expected content to be an assistant message')
+  }
+  if (result.message.content[0]?.type !== 'text') {
+    throw new Error(
+      `Expected first content item to be text, but got ${JSON.stringify(
+        result.message.content[0],
+        null,
+        2,
+      )}`,
+    )
+  }
+
+  // Write log that can be retrieved with `claude log`
+  const messageHistoryFile = getMessagesPath(messageLogName, 0, 0)
+  overwriteLog(messageHistoryFile, messages)
+
+  return {
+    resultText: result.message.content[0].text,
+    totalCost: getTotalCost(),
+    messageHistoryFile,
+  }
+}

package/src/utils/auth.ts

@@ -0,0 +1,13 @@
+import { USE_BEDROCK, USE_VERTEX } from './model'
+import { getGlobalConfig } from './config'
+
+export function isAnthropicAuthEnabled(): boolean {
+  return false
+  // return !(USE_BEDROCK || USE_VERTEX)
+}
+
+export function isLoggedInToAnthropic(): boolean {
+  return false
+  // const config = getGlobalConfig()
+  // return !!config.primaryApiKey
+}