@shareai-lab/kode 1.0.69 → 1.0.71

package/package.json

@@ -1,33 +1,43 @@
 {
   "name": "@shareai-lab/kode",
-  "version": "1.0.69",
+  "version": "1.0.71",
   "bin": {
-    "kode": "cli.mjs"
+    "kode": "cli.js",
+    "kwa": "cli.js",
+    "kd": "cli.js"
   },
   "engines": {
     "node": ">=18.0.0"
   },
-  "type": "module",
+  "main": "cli.js",
   "author": "ShareAI-lab <ai-lab@foxmail.com>",
-  "license": "",
-  "description": "Use Agent Kode, Last's AI assistant, right from your terminal. Agent Kode can understand your codebase, edit files, run terminal commands, and handle entire workflows for you.",
-  "homepage": "https://github.com/shareAI-lab/agent-kode",
+  "license": "ISC",
+  "description": "AI-powered terminal assistant that understands your codebase, edits files, runs commands, and automates development workflows.",
+  "homepage": "https://github.com/shareAI-lab/kode",
   "repository": {
     "type": "git",
-    "url": "https://github.com/shareAI-lab/agent-kode.git"
+    "url": "git+https://github.com/shareAI-lab/kode.git"
   },
   "bugs": {
-    "url": "https://github.com/shareAI-lab/agent-kode/issues"
+    "url": "https://github.com/shareAI-lab/kode/issues"
   },
   "files": [
-    "cli.mjs",
-    "yoga.wasm"
+    "cli.js",
+    "yoga.wasm",
+    "src/**/*",
+    "scripts/postinstall.js",
+    ".npmrc"
   ],
   "scripts": {
-    "dev": "tsx ./src/entrypoints/cli.tsx --verbose",
-    "build": "bun build src/entrypoints/cli.tsx --minify --outfile cli.mjs --target=node",
+    "dev": "bun run ./src/entrypoints/cli.tsx --verbose",
+    "build": "bun run scripts/build.ts",
+    "clean": "rm -rf cli.js",
+    "prepublishOnly": "bun run build && node scripts/prepublish-check.js",
+    "postinstall": "node scripts/postinstall.js || true",
     "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json}\"",
-    "format:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx,json}\""
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx,json}\"",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
   },
   "optionalDependencies": {
     "@img/sharp-darwin-arm64": "^0.33.5",
@@ -68,25 +78,35 @@
     "semver": "^7.7.2",
     "shell-quote": "^1.8.3",
     "spawn-rx": "^5.1.2",
+    "tsx": "^4.20.3",
     "undici": "^7.11.0",
     "wrap-ansi": "^9.0.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6"
   },
   "devDependencies": {
+    "@types/bun": "latest",
     "@types/node": "^24.1.0",
+    "bun-types": "latest",
     "prettier": "^3.6.2",
-    "react-devtools-core": "^6.1.5",
-    "tsx": "^4.20.3",
     "typescript": "^5.9.2"
   },
-  "pnpm": {
-    "overrides": {
-      "slice-ansi": "^7.1.0",
-      "ansi-styles": "^6.2.1",
-      "chalk": "^5.4.1",
-      "string-width": "^7.1.0",
-      "strip-ansi": "^7.1.0"
-    }
-  }
-}
+  "overrides": {
+    "string-width": "^7.2.0",
+    "strip-ansi": "^7.1.0"
+  },
+  "directories": {
+    "doc": "docs",
+    "test": "test"
+  },
+  "keywords": [
+    "cli",
+    "ai",
+    "assistant",
+    "agent",
+    "kode",
+    "shareai",
+    "terminal",
+    "command-line"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const primaryCommand = 'kode';
+const alternativeCommands = ['kwa', 'kd'];
+
+function commandExists(cmd) {
+  try {
+    execSync(`which ${cmd}`, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function setupCommand() {
+  // Check if primary command exists
+  if (!commandExists(primaryCommand)) {
+    console.log(`✅ '${primaryCommand}' command is available and has been set up.`);
+    return;
+  }
+
+  console.log(`⚠️  '${primaryCommand}' command already exists on your system.`);
+  
+  // Find an available alternative
+  for (const alt of alternativeCommands) {
+    if (!commandExists(alt)) {
+      // Create alternative command
+      const binPath = path.join(__dirname, '..', 'cli.js');
+      const altBinPath = path.join(__dirname, '..', '..', '..', '.bin', alt);
+      
+      try {
+        fs.symlinkSync(binPath, altBinPath);
+        console.log(`✅ Created alternative command '${alt}' instead.`);
+        console.log(`   You can run the tool using: ${alt}`);
+        return;
+      } catch (err) {
+        // Continue to next alternative
+      }
+    }
+  }
+
+  console.log(`
+⚠️  All common command names are taken. You can still run the tool using:
+   - npx @shareai-lab/kode
+   - Or create your own alias: alias myai='npx @shareai-lab/kode'
+`);
+}
+
+// Only run in postinstall, not in development
+if (process.env.npm_lifecycle_event === 'postinstall') {
+  setupCommand();
+}

package/src/ProjectOnboarding.tsx

@@ -0,0 +1,180 @@
+import * as React from 'react'
+import { OrderedList } from '@inkjs/ui'
+import { Box, Text } from 'ink'
+import {
+  getCurrentProjectConfig,
+  getGlobalConfig,
+  saveCurrentProjectConfig,
+  saveGlobalConfig,
+} from './utils/config.js'
+import { existsSync } from 'fs'
+import { join } from 'path'
+import { homedir } from 'os'
+import terminalSetup from './commands/terminalSetup'
+import { getTheme } from './utils/theme'
+import { RELEASE_NOTES } from './constants/releaseNotes'
+import { gt } from 'semver'
+import { isDirEmpty } from './utils/file'
+import { MACRO } from './constants/macros'
+import { PROJECT_FILE, PRODUCT_NAME } from './constants/product'
+
+// Function to mark onboarding as complete
+export function markProjectOnboardingComplete(): void {
+  const projectConfig = getCurrentProjectConfig()
+  if (!projectConfig.hasCompletedProjectOnboarding) {
+    saveCurrentProjectConfig({
+      ...projectConfig,
+      hasCompletedProjectOnboarding: true,
+    })
+  }
+}
+
+function markReleaseNotesSeen(): void {
+  const config = getGlobalConfig()
+  saveGlobalConfig({
+    ...config,
+    lastReleaseNotesSeen: MACRO.VERSION,
+  })
+}
+
+type Props = {
+  workspaceDir: string
+}
+
+export default function ProjectOnboarding({
+  workspaceDir,
+}: Props): React.ReactNode {
+  // Check if project onboarding has already been completed
+  const projectConfig = getCurrentProjectConfig()
+  const showOnboarding = !projectConfig.hasCompletedProjectOnboarding
+
+  // Get previous version from config
+  const config = getGlobalConfig()
+  const previousVersion = config.lastReleaseNotesSeen
+
+  // Get release notes to show
+  let releaseNotesToShow: string[] = []
+  if (!previousVersion || gt(MACRO.VERSION, previousVersion)) {
+    releaseNotesToShow = RELEASE_NOTES[MACRO.VERSION] || []
+  }
+  const hasReleaseNotes = releaseNotesToShow.length > 0
+
+  // Mark release notes as seen when they're displayed without onboarding
+  React.useEffect(() => {
+    if (hasReleaseNotes && !showOnboarding) {
+      markReleaseNotesSeen()
+    }
+  }, [hasReleaseNotes, showOnboarding])
+
+  // We only want to show either onboarding OR release notes (with preference for onboarding)
+  // If there's no onboarding to show and no release notes, return null
+  if (!showOnboarding && !hasReleaseNotes) {
+    return null
+  }
+
+  // Load what we need for onboarding
+  // NOTE: This whole component is statically rendered Once
+  const hasClaudeMd = existsSync(join(workspaceDir, PROJECT_FILE))
+  const isWorkspaceDirEmpty = isDirEmpty(workspaceDir)
+  const needsClaudeMd = !hasClaudeMd && !isWorkspaceDirEmpty
+  const showTerminalTip =
+    terminalSetup.isEnabled && !getGlobalConfig().shiftEnterKeyBindingInstalled
+
+  const theme = getTheme()
+
+  return (
+    <Box flexDirection="column" gap={1} padding={1} paddingBottom={0}>
+      {showOnboarding && (
+        <>
+          <Text color={theme.secondaryText}>Tips for getting started:</Text>
+          <OrderedList>
+            {/* Collect all the items that should be displayed */}
+            {(() => {
+              const items = []
+
+              if (isWorkspaceDirEmpty) {
+                items.push(
+                  <OrderedList.Item key="workspace">
+                    <Text color={theme.secondaryText}>
+                      Ask {PRODUCT_NAME} to create a new app or clone a
+                      repository.
+                    </Text>
+                  </OrderedList.Item>,
+                )
+              }
+              if (needsClaudeMd) {
+                items.push(
+                  <OrderedList.Item key="claudemd">
+                    <Text color={theme.secondaryText}>
+                      Run <Text color={theme.text}>/init</Text> to create
+                      a&nbsp;
+                      {PROJECT_FILE} file with instructions for {PRODUCT_NAME}.
+                    </Text>
+                  </OrderedList.Item>,
+                )
+              }
+
+              if (showTerminalTip) {
+                items.push(
+                  <OrderedList.Item key="terminal">
+                    <Text color={theme.secondaryText}>
+                      Run <Text color={theme.text}>/terminal-setup</Text>
+                      <Text bold={false}> to set up terminal integration</Text>
+                    </Text>
+                  </OrderedList.Item>,
+                )
+              }
+
+              items.push(
+                <OrderedList.Item key="questions">
+                  <Text color={theme.secondaryText}>
+                    Ask {PRODUCT_NAME} questions about your codebase.
+                  </Text>
+                </OrderedList.Item>,
+              )
+
+              items.push(
+                <OrderedList.Item key="changes">
+                  <Text color={theme.secondaryText}>
+                    Ask {PRODUCT_NAME} to implement changes to your codebase.
+                  </Text>
+                </OrderedList.Item>,
+              )
+
+              return items
+            })()}
+          </OrderedList>
+        </>
+      )}
+
+      {!showOnboarding && hasReleaseNotes && (
+        <Box
+          borderColor={getTheme().secondaryBorder}
+          flexDirection="column"
+          marginRight={1}
+        >
+          <Box flexDirection="column" gap={0}>
+            <Box marginBottom={1}>
+              <Text>🆕 What&apos;s new in v{MACRO.VERSION}:</Text>
+            </Box>
+            <Box flexDirection="column" marginLeft={1}>
+              {releaseNotesToShow.map((note, noteIndex) => (
+                <Text key={noteIndex} color={getTheme().secondaryText}>
+                  • {note}
+                </Text>
+              ))}
+            </Box>
+          </Box>
+        </Box>
+      )}
+
+      {workspaceDir === homedir() && (
+        <Text color={getTheme().warning}>
+          Note: You have launched <Text bold>anon-code</Text> in your home
+          directory. For the best experience, launch it in a project directory
+          instead.
+        </Text>
+      )}
+    </Box>
+  )
+}

package/src/Tool.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod'
+import { UUID } from 'crypto'
+import * as React from 'react'
+
+export interface ToolUseContext {
+  messageId: UUID
+  agentId?: string
+  safeMode?: boolean
+}
+
+export interface ValidationResult {
+  result: boolean
+  message?: string
+  errorCode?: number
+  meta?: any
+}
+
+export interface Tool<
+  TInput extends z.ZodObject<any> = z.ZodObject<any>,
+  TOutput = any,
+> {
+  name: string
+  description?: () => Promise<string>
+  inputSchema: TInput
+  inputJSONSchema?: Record<string, unknown>
+  prompt: (options?: { safeMode?: boolean }) => Promise<string>
+  userFacingName?: () => string
+  isEnabled: () => Promise<boolean>
+  isReadOnly: () => boolean
+  isConcurrencySafe: () => boolean
+  needsPermissions: (input?: z.infer<TInput>) => boolean
+  validateInput?: (
+    input: z.infer<TInput>,
+    context?: ToolUseContext,
+  ) => Promise<ValidationResult>
+  renderResultForAssistant: (output: TOutput) => string
+  renderToolUseMessage: (
+    input: z.infer<TInput>,
+    options: { verbose: boolean },
+  ) => string
+  renderToolUseRejectedMessage: () => React.ReactElement
+  renderToolResultMessage?: (output: TOutput) => React.ReactElement
+  call: (
+    input: z.infer<TInput>,
+    context: ToolUseContext,
+  ) => AsyncGenerator<
+    { type: 'result'; data: TOutput; resultForAssistant?: string },
+    void,
+    unknown
+  >
+}
+
+export type { ToolUseContext, ValidationResult }

package/src/commands/approvedTools.ts

@@ -0,0 +1,53 @@
+import {
+  ProjectConfig,
+  getCurrentProjectConfig as getCurrentProjectConfigDefault,
+  saveCurrentProjectConfig as saveCurrentProjectConfigDefault,
+} from '../utils/config.js'
+
+export type ProjectConfigHandler = {
+  getCurrentProjectConfig: () => ProjectConfig
+  saveCurrentProjectConfig: (config: ProjectConfig) => void
+}
+
+// Default config handler using the real implementation
+const defaultConfigHandler: ProjectConfigHandler = {
+  getCurrentProjectConfig: getCurrentProjectConfigDefault,
+  saveCurrentProjectConfig: saveCurrentProjectConfigDefault,
+}
+
+/**
+ * Handler for the 'approved-tools list' command
+ */
+export function handleListApprovedTools(
+  cwd: string,
+  projectConfigHandler: ProjectConfigHandler = defaultConfigHandler,
+): string {
+  const projectConfig = projectConfigHandler.getCurrentProjectConfig()
+  return `Allowed tools for ${cwd}:\n${projectConfig.allowedTools.join('\n')}`
+}
+
+/**
+ * Handler for the 'approved-tools remove' command
+ */
+export function handleRemoveApprovedTool(
+  tool: string,
+  projectConfigHandler: ProjectConfigHandler = defaultConfigHandler,
+): { success: boolean; message: string } {
+  const projectConfig = projectConfigHandler.getCurrentProjectConfig()
+  const originalToolCount = projectConfig.allowedTools.length
+  const updatedAllowedTools = projectConfig.allowedTools.filter(t => t !== tool)
+
+  if (originalToolCount !== updatedAllowedTools.length) {
+    projectConfig.allowedTools = updatedAllowedTools
+    projectConfigHandler.saveCurrentProjectConfig(projectConfig)
+    return {
+      success: true,
+      message: `Removed ${tool} from the list of approved tools`,
+    }
+  } else {
+    return {
+      success: false,
+      message: `${tool} was not in the list of approved tools`,
+    }
+  }
+}

package/src/commands/bug.tsx

@@ -0,0 +1,20 @@
+import { Command } from '../commands'
+import { Bug } from '../components/Bug'
+import * as React from 'react'
+import { PRODUCT_NAME } from '../constants/product'
+
+const bug = {
+  type: 'local-jsx',
+  name: 'bug',
+  description: `Submit feedback about ${PRODUCT_NAME}`,
+  isEnabled: true,
+  isHidden: false,
+  async call(onDone) {
+    return <Bug onDone={onDone} />
+  },
+  userFacingName() {
+    return 'bug'
+  },
+} satisfies Command
+
+export default bug

package/src/commands/clear.ts

@@ -0,0 +1,43 @@
+import { Command } from '../commands'
+import { getMessagesSetter } from '../messages'
+import { getContext } from '../context'
+import { getCodeStyle } from '../utils/style'
+import { clearTerminal } from '../utils/terminal'
+import { getOriginalCwd, setCwd } from '../utils/state'
+import { Message } from '../query'
+import { resetReminderSession } from '../services/systemReminder'
+import { resetFileFreshnessSession } from '../services/fileFreshness'
+
+export async function clearConversation(context: {
+  setForkConvoWithMessagesOnTheNextRender: (
+    forkConvoWithMessages: Message[],
+  ) => void
+}) {
+  await clearTerminal()
+  getMessagesSetter()([])
+  context.setForkConvoWithMessagesOnTheNextRender([])
+  getContext.cache.clear?.()
+  getCodeStyle.cache.clear?.()
+  await setCwd(getOriginalCwd())
+
+  // Reset reminder and file freshness sessions to clean up state
+  resetReminderSession()
+  resetFileFreshnessSession()
+}
+
+const clear = {
+  type: 'local',
+  name: 'clear',
+  description: 'Clear conversation history and free up context',
+  isEnabled: true,
+  isHidden: false,
+  async call(_, context) {
+    clearConversation(context)
+    return ''
+  },
+  userFacingName() {
+    return 'clear'
+  },
+} satisfies Command
+
+export default clear

package/src/commands/compact.ts

@@ -0,0 +1,120 @@
+import { Command } from '../commands'
+import { getContext } from '../context'
+import { getMessagesGetter, getMessagesSetter } from '../messages'
+import { API_ERROR_MESSAGE_PREFIX, queryLLM } from '../services/claude'
+import {
+  createUserMessage,
+  normalizeMessagesForAPI,
+} from '../utils/messages.js'
+import { getCodeStyle } from '../utils/style'
+import { clearTerminal } from '../utils/terminal'
+import { resetReminderSession } from '../services/systemReminder'
+import { resetFileFreshnessSession } from '../services/fileFreshness'
+
+const COMPRESSION_PROMPT = `Please provide a comprehensive summary of our conversation structured as follows:
+
+## Technical Context
+Development environment, tools, frameworks, and configurations in use. Programming languages, libraries, and technical constraints. File structure, directory organization, and project architecture.
+
+## Project Overview  
+Main project goals, features, and scope. Key components, modules, and their relationships. Data models, APIs, and integration patterns.
+
+## Code Changes
+Files created, modified, or analyzed during our conversation. Specific code implementations, functions, and algorithms added. Configuration changes and structural modifications.
+
+## Debugging & Issues
+Problems encountered and their root causes. Solutions implemented and their effectiveness. Error messages, logs, and diagnostic information.
+
+## Current Status
+What we just completed successfully. Current state of the codebase and any ongoing work. Test results, validation steps, and verification performed.
+
+## Pending Tasks
+Immediate next steps and priorities. Planned features, improvements, and refactoring. Known issues, technical debt, and areas needing attention.
+
+## User Preferences
+Coding style, formatting, and organizational preferences. Communication patterns and feedback style. Tool choices and workflow preferences.
+
+## Key Decisions
+Important technical decisions made and their rationale. Alternative approaches considered and why they were rejected. Trade-offs accepted and their implications.
+
+Focus on information essential for continuing the conversation effectively, including specific details about code, files, errors, and plans.`
+
+const compact = {
+  type: 'local',
+  name: 'compact',
+  description: 'Clear conversation history but keep a summary in context',
+  isEnabled: true,
+  isHidden: false,
+  async call(
+    _,
+    {
+      options: { tools },
+      abortController,
+      setForkConvoWithMessagesOnTheNextRender,
+    },
+  ) {
+    const messages = getMessagesGetter()()
+
+    const summaryRequest = createUserMessage(COMPRESSION_PROMPT)
+
+    const summaryResponse = await queryLLM(
+      normalizeMessagesForAPI([...messages, summaryRequest]),
+      [
+        'You are a helpful AI assistant tasked with creating comprehensive conversation summaries that preserve all essential context for continuing development work.',
+      ],
+      0,
+      tools,
+      abortController.signal,
+      {
+        safeMode: false,
+        model: 'main', // 使用模型指针，让queryLLM统一解析
+        prependCLISysprompt: true,
+      },
+    )
+
+    const content = summaryResponse.message.content
+    const summary =
+      typeof content === 'string'
+        ? content
+        : content.length > 0 && content[0]?.type === 'text'
+          ? content[0].text
+          : null
+
+    if (!summary) {
+      throw new Error(
+        `Failed to generate conversation summary - response did not contain valid text content - ${summaryResponse}`,
+      )
+    } else if (summary.startsWith(API_ERROR_MESSAGE_PREFIX)) {
+      throw new Error(summary)
+    }
+
+    summaryResponse.message.usage = {
+      input_tokens: 0,
+      output_tokens: summaryResponse.message.usage.output_tokens,
+      cache_creation_input_tokens: 0,
+      cache_read_input_tokens: 0,
+    }
+
+    await clearTerminal()
+    getMessagesSetter()([])
+    setForkConvoWithMessagesOnTheNextRender([
+      createUserMessage(
+        `Context has been compressed using structured 8-section algorithm. All essential information has been preserved for seamless continuation.`,
+      ),
+      summaryResponse,
+    ])
+    getContext.cache.clear?.()
+    getCodeStyle.cache.clear?.()
+    resetFileFreshnessSession()
+
+    // Reset reminder and file freshness sessions to clean up state
+    resetReminderSession()
+
+    return '' // not used, just for typesafety. TODO: avoid this hack
+  },
+  userFacingName() {
+    return 'compact'
+  },
+} satisfies Command
+
+export default compact

package/src/commands/config.tsx

@@ -0,0 +1,19 @@
+import { Command } from '../commands'
+import { Config } from '../components/Config'
+import * as React from 'react'
+
+const config = {
+  type: 'local-jsx',
+  name: 'config',
+  description: 'Open config panel',
+  isEnabled: true,
+  isHidden: false,
+  async call(onDone) {
+    return <Config onClose={onDone} />
+  },
+  userFacingName() {
+    return 'config'
+  },
+} satisfies Command
+
+export default config

package/src/commands/cost.ts

@@ -0,0 +1,18 @@
+import type { Command } from '../commands'
+import { formatTotalCost } from '../cost-tracker'
+
+const cost = {
+  type: 'local',
+  name: 'cost',
+  description: 'Show the total cost and duration of the current session',
+  isEnabled: true,
+  isHidden: false,
+  async call() {
+    return formatTotalCost()
+  },
+  userFacingName() {
+    return 'cost'
+  },
+} satisfies Command
+
+export default cost