@akiojin/gwt 4.8.0 → 4.9.1

package/src/services/{customToolResolver.ts → codingAgentCommandResolver.ts}

@@ -1,10 +1,10 @@
 import { execa } from "execa";
-import type { CustomAITool, LaunchOptions } from "../types/tools.js";
+import type { CodingAgent, CodingAgentLaunchOptions } from "../types/tools.js";
 import { createLogger } from "../logging/logger.js";
 
-const logger = createLogger({ category: "custom-resolver" });
+const logger = createLogger({ category: "agent-resolver" });
 
-export interface CustomToolExecutionPlan {
+export interface CodingAgentExecutionPlan {
   command: string;
   args: string[];
   env?: NodeJS.ProcessEnv;
@@ -35,24 +35,24 @@ export async function resolveCommandPath(commandName: string): Promise<string> {
   }
 }
 
-export function buildCustomToolArgs(
-  tool: CustomAITool,
-  options: LaunchOptions = {},
+export function buildCodingAgentArgs(
+  agent: CodingAgent,
+  options: CodingAgentLaunchOptions = {},
 ): string[] {
   const args: string[] = [];
 
-  if (tool.defaultArgs?.length) {
-    args.push(...tool.defaultArgs);
+  if (agent.defaultArgs?.length) {
+    args.push(...agent.defaultArgs);
   }
 
   const mode = options.mode ?? "normal";
-  const modeArgs = tool.modeArgs?.[mode];
+  const modeArgs = agent.modeArgs?.[mode];
   if (modeArgs?.length) {
     args.push(...modeArgs);
   }
 
-  if (options.skipPermissions && tool.permissionSkipArgs?.length) {
-    args.push(...tool.permissionSkipArgs);
+  if (options.skipPermissions && agent.permissionSkipArgs?.length) {
+    args.push(...agent.permissionSkipArgs);
   }
 
   if (options.extraArgs?.length) {
@@ -60,49 +60,54 @@ export function buildCustomToolArgs(
   }
 
   logger.debug(
-    { toolId: tool.id, argsCount: args.length },
-    "Custom tool args built",
+    { agentId: agent.id, argsCount: args.length },
+    "Coding agent args built",
   );
   return args;
 }
 
-export async function prepareCustomToolExecution(
-  tool: CustomAITool,
-  options: LaunchOptions = {},
-): Promise<CustomToolExecutionPlan> {
-  const baseArgs = buildCustomToolArgs(tool, options);
-  const envOverrides: NodeJS.ProcessEnv | undefined = tool.env
-    ? ({ ...tool.env } as NodeJS.ProcessEnv)
+export async function prepareCodingAgentExecution(
+  agent: CodingAgent,
+  options: CodingAgentLaunchOptions = {},
+): Promise<CodingAgentExecutionPlan> {
+  const baseArgs = buildCodingAgentArgs(agent, options);
+  const envOverrides: NodeJS.ProcessEnv | undefined = agent.env
+    ? ({ ...agent.env } as NodeJS.ProcessEnv)
     : undefined;
 
   let command: string;
   let args: string[];
 
-  switch (tool.type) {
+  switch (agent.type) {
     case "path": {
-      command = tool.command;
+      command = agent.command;
       args = baseArgs;
       break;
     }
     case "bunx": {
       command = "bunx";
-      args = [tool.command, ...baseArgs];
+      args = [agent.command, ...baseArgs];
       break;
     }
     case "command": {
-      command = await resolveCommandPath(tool.command);
+      command = await resolveCommandPath(agent.command);
       args = baseArgs;
       break;
     }
     default: {
-      const exhaustive: never = tool.type;
-      throw new Error(`Unknown custom tool type: ${exhaustive as string}`);
+      const exhaustive: never = agent.type;
+      throw new Error(`Unknown coding agent type: ${exhaustive as string}`);
     }
   }
 
   logger.debug(
-    { toolId: tool.id, toolType: tool.type, command, hasEnv: !!envOverrides },
-    "Custom tool execution prepared",
+    {
+      agentId: agent.id,
+      agentType: agent.type,
+      command,
+      hasEnv: !!envOverrides,
+    },
+    "Coding agent execution prepared",
   );
 
   return {

package/src/services/{aiToolResolver.ts → codingAgentResolver.ts}

@@ -1,13 +1,13 @@
 import { execa } from "execa";
 import { platform } from "os";
-import { getToolById } from "../config/tools.js";
-import { CLAUDE_CODE_TOOL } from "../config/builtin-tools.js";
+import { getCodingAgentById } from "../config/tools.js";
+import { CLAUDE_CODE_TOOL } from "../config/builtin-coding-agents.js";
 import {
   CODEX_DEFAULT_ARGS,
   CLAUDE_PERMISSION_SKIP_ARGS,
-} from "../shared/aiToolConstants.js";
-import { prepareCustomToolExecution } from "./customToolResolver.js";
-import type { LaunchOptions } from "../types/tools.js";
+} from "../shared/codingAgentConstants.js";
+import { prepareCodingAgentExecution } from "./codingAgentCommandResolver.js";
+import type { CodingAgentLaunchOptions } from "../types/tools.js";
 import { createLogger } from "../logging/logger.js";
 
 const logger = createLogger({ category: "resolver" });
@@ -31,14 +31,14 @@ export interface ResolvedCommand {
   env?: NodeJS.ProcessEnv;
 }
 
-export class AIToolResolutionError extends Error {
+export class CodingAgentResolutionError extends Error {
   constructor(
     public code: ResolverErrorCode,
     message: string,
     public hints?: string[],
   ) {
     super(message);
-    this.name = "AIToolResolutionError";
+    this.name = "CodingAgentResolutionError";
   }
 }
 
@@ -78,7 +78,7 @@ async function ensureBunxAvailable(): Promise<void> {
     bunxCheckPromise = (async () => {
       const bunxExists = await commandExists("bunx");
       if (!bunxExists) {
-        throw new AIToolResolutionError(
+        throw new CodingAgentResolutionError(
           "BUNX_NOT_FOUND",
           "bunx command not found. Install Bun 1.0+ so bunx is available on PATH.",
           [
@@ -94,7 +94,7 @@ async function ensureBunxAvailable(): Promise<void> {
         logger.debug({ bunVersion: version }, "Bun version detected");
         const major = parseInt(version.split(".")[0] ?? "0", 10);
         if (!Number.isFinite(major) || major < MIN_BUN_MAJOR) {
-          throw new AIToolResolutionError(
+          throw new CodingAgentResolutionError(
             "BUN_TOO_OLD",
             `Detected Bun ${version}. Bun ${MIN_BUN_MAJOR}.0+ is required for bunx fallback execution.`,
             [
@@ -104,12 +104,12 @@ async function ensureBunxAvailable(): Promise<void> {
           );
         }
       } catch (error: unknown) {
-        if (error instanceof AIToolResolutionError) {
+        if (error instanceof CodingAgentResolutionError) {
           throw error;
         }
         const err = error as NodeJS.ErrnoException;
         if (err?.code === "ENOENT") {
-          throw new AIToolResolutionError(
+          throw new CodingAgentResolutionError(
             "BUNX_NOT_FOUND",
             "bun command not found while verifying bunx. Install Bun 1.0+ and ensure it is on PATH.",
             [
@@ -118,7 +118,7 @@ async function ensureBunxAvailable(): Promise<void> {
             ],
           );
         }
-        throw new AIToolResolutionError(
+        throw new CodingAgentResolutionError(
           "BUN_TOO_OLD",
           `Failed to verify Bun version: ${err?.message ?? "unknown error"}`,
         );
@@ -274,37 +274,37 @@ export async function resolveCodexCommand(
   };
 }
 
-export interface CustomToolCommandOptions extends LaunchOptions {
-  toolId: string;
+export interface CodingAgentCommandOptions extends CodingAgentLaunchOptions {
+  agentId: string;
 }
 
-export async function resolveCustomToolCommand(
-  options: CustomToolCommandOptions,
+export async function resolveCodingAgentCommand(
+  options: CodingAgentCommandOptions,
 ): Promise<ResolvedCommand> {
-  const tool = await getToolById(options.toolId);
-  if (!tool) {
-    logger.error({ toolId: options.toolId }, "Custom tool not found");
-    throw new AIToolResolutionError(
+  const agent = await getCodingAgentById(options.agentId);
+  if (!agent) {
+    logger.error({ agentId: options.agentId }, "Coding agent not found");
+    throw new CodingAgentResolutionError(
       "CUSTOM_TOOL_NOT_FOUND",
-      `Custom tool not found: ${options.toolId}`,
+      `Coding agent not found: ${options.agentId}`,
       [
         "Update ~/.gwt/tools.json to include this ID",
-        "Reload the Web UI after editing the tools list",
+        "Reload the Web UI after editing the agents list",
       ],
     );
   }
 
-  const execution = await prepareCustomToolExecution(tool, options);
+  const execution = await prepareCodingAgentExecution(agent, options);
 
   logger.info(
-    { toolId: options.toolId, command: execution.command },
-    "Custom tool command resolved",
+    { agentId: options.agentId, command: execution.command },
+    "Coding agent command resolved",
   );
 
   return {
     command: execution.command,
     args: execution.args,
-    usesFallback: tool.type === "bunx",
+    usesFallback: agent.type === "bunx",
     ...(execution.env ? { env: execution.env } : {}),
   };
 }
@@ -314,7 +314,7 @@ export async function isClaudeCodeAvailable(): Promise<boolean> {
     await resolveClaudeCommand();
     return true;
   } catch (error) {
-    if (error instanceof AIToolResolutionError) {
+    if (error instanceof CodingAgentResolutionError) {
       return false;
     }
     return false;
@@ -326,7 +326,7 @@ export async function isCodexAvailable(): Promise<boolean> {
     await resolveCodexCommand();
     return true;
   } catch (error) {
-    if (error instanceof AIToolResolutionError) {
+    if (error instanceof CodingAgentResolutionError) {
       return false;
     }
     return false;

package/src/shared/{aiToolConstants.ts → codingAgentConstants.ts}

@@ -1,5 +1,5 @@
 /**
- * Shared constants for AI tool integrations.
+ * Shared constants for Coding Agent integrations.
  *
  * These values are consumed by both the CLI (Node) runtime and the Web UI so
  * that command previews, permission flags, and default arguments stay in sync.

package/src/types/api.ts

@@ -51,12 +51,12 @@ export interface Worktree {
 }
 
 /**
- * AIToolSession - AI Tool実行セッション
+ * CodingAgentSession - Coding Agent実行セッション
  */
-export interface AIToolSession {
+export interface CodingAgentSession {
   sessionId: string; // UUID v4
-  toolType: "claude-code" | "codex-cli" | "custom";
-  toolName?: string | null;
+  agentType: "claude-code" | "codex-cli" | "custom";
+  agentName?: string | null;
   mode: "normal" | "continue" | "resume";
   worktreePath: string;
   ptyPid?: number | null;
@@ -69,7 +69,7 @@ export interface AIToolSession {
 }
 
 /**
- * CustomAITool - カスタムAI Tool設定
+ * CodingAgent - カスタム Coding Agent 設定
  */
 export interface EnvironmentVariable {
   key: string;
@@ -85,7 +85,7 @@ export interface EnvironmentHistoryEntry {
   source: "ui" | "os" | "cli";
 }
 
-export interface CustomAITool {
+export interface ApiCodingAgent {
   id: string; // UUID v4 or slug
   displayName: string;
   icon?: string | null;
@@ -144,14 +144,14 @@ export type BranchResponse = SuccessResponse<Branch>;
 export type BranchSyncResponse = SuccessResponse<BranchSyncResult>;
 export type WorktreeListResponse = SuccessResponse<Worktree[]>;
 export type WorktreeResponse = SuccessResponse<Worktree>;
-export type SessionListResponse = SuccessResponse<AIToolSession[]>;
-export type SessionResponse = SuccessResponse<AIToolSession>;
+export type SessionListResponse = SuccessResponse<CodingAgentSession[]>;
+export type SessionResponse = SuccessResponse<CodingAgentSession>;
 export interface ConfigPayload {
   version: string;
   updatedAt?: string | null;
   env?: EnvironmentVariable[] | null;
   history?: EnvironmentHistoryEntry[] | null;
-  tools: CustomAITool[];
+  codingAgents: ApiCodingAgent[];
 }
 
 export type ConfigResponse = SuccessResponse<ConfigPayload>;
@@ -169,14 +169,14 @@ export interface BranchSyncRequest {
 }
 
 export interface StartSessionRequest {
-  toolType: "claude-code" | "codex-cli" | "custom";
-  toolName?: string | null;
+  agentType: "claude-code" | "codex-cli" | "custom";
+  agentName?: string | null;
   mode: "normal" | "continue" | "resume";
   worktreePath: string;
   skipPermissions?: boolean;
   bypassApprovals?: boolean;
   extraArgs?: string[];
-  customToolId?: string | null;
+  customAgentId?: string | null;
 }
 
 export type UpdateConfigRequest = ConfigPayload;

package/src/types/tools.ts

@@ -1,5 +1,5 @@
 /**
- * カスタムAIツール対応機能の型定義
+ * コーディングエージェント対応機能の型定義
  *
  * この型定義ファイルは、設定ファイル（tools.json）のスキーマと
  * 内部で使用するデータ構造を定義します。
@@ -42,30 +42,30 @@ export interface ModeArgs {
 }
 
 /**
- * カスタムAIツール定義
+ * コーディングエージェント定義
  *
- * tools.jsonファイルで定義される個別のツール設定。
+ * tools.jsonファイルで定義される個別のエージェント設定。
  */
-export interface CustomAITool {
+export interface CodingAgent {
   /**
-   * ツールの一意識別子
+   * エージェントの一意識別子
    *
    * 小文字英数字とハイフンのみ使用可能（パターン: ^[a-z0-9-]+$）
-   * ビルトインツール（claude-code, codex-cli）との重複は不可。
+   * ビルトインエージェント（claude-code, codex-cli）との重複は不可。
    */
   id: string;
 
   /**
    * UI表示名
    *
-   * ツール選択画面で表示される名前。日本語も使用可能。
+   * エージェント選択画面で表示される名前。日本語も使用可能。
    */
   displayName: string;
 
   /**
    * アイコン文字（オプション）
    *
-   * ツール選択画面で表示されるUnicode文字。
+   * エージェント選択画面で表示されるUnicode文字。
    */
   icon?: string;
 
@@ -96,7 +96,7 @@ export interface CustomAITool {
   /**
    * デフォルト引数（オプション）
    *
-   * ツール実行時に常に付与される引数。
+   * エージェント実行時に常に付与される引数。
    * 最終的な引数は: defaultArgs + modeArgs[mode] + permissionSkipArgs + extraArgs
    */
   defaultArgs?: string[];
@@ -119,7 +119,7 @@ export interface CustomAITool {
   /**
    * 環境変数（オプション）
    *
-   * ツール起動時に設定される環境変数。
+   * エージェント起動時に設定される環境変数。
    * APIキーや設定ファイルパスなどを指定。
    */
   env?: Record<string, string>;
@@ -136,11 +136,11 @@ export interface CustomAITool {
 }
 
 /**
- * ツール設定ファイル全体
+ * コーディングエージェント設定ファイル全体
  *
  * ~/.gwt/tools.json のスキーマ。
  */
-export interface ToolsConfig {
+export interface CodingAgentsConfig {
   /**
    * 設定フォーマットのバージョン
    *
@@ -154,16 +154,16 @@ export interface ToolsConfig {
   updatedAt?: string;
 
   /**
-   * すべてのツールで共有する環境変数
+   * すべてのエージェントで共有する環境変数
    */
   env?: Record<string, string>;
 
   /**
-   * カスタムツール定義の配列
+   * カスタムコーディングエージェント定義の配列
    *
-   * 空配列も許可（ビルトインツールのみ使用）。
+   * 空配列も許可（ビルトインエージェントのみ使用）。
    */
-  customTools: CustomAITool[];
+  customCodingAgents: CodingAgent[];
 }
 
 // ============================================================================
@@ -171,17 +171,17 @@ export interface ToolsConfig {
 // ============================================================================
 
 /**
- * 統合ツール設定
+ * 統合コーディングエージェント設定
  *
- * ビルトインツールとカスタムツールを統合して扱うための内部型。
- * getAllTools() 関数がこの型の配列を返します。
+ * ビルトインエージェントとカスタムエージェントを統合して扱うための内部型。
+ * getAllCodingAgents() 関数がこの型の配列を返します。
  */
-export interface AIToolConfig {
+export interface CodingAgentConfig {
   /**
-   * ツールID
+   * エージェントID
    *
    * ビルトイン: "claude-code" | "codex-cli"
-   * カスタム: CustomAITool.id
+   * カスタム: CodingAgent.id
    */
   id: string;
 
@@ -196,27 +196,27 @@ export interface AIToolConfig {
   icon?: string;
 
   /**
-   * ビルトインツールかどうか
+   * ビルトインエージェントかどうか
    *
    * true: Claude Code または Codex CLI
-   * false: カスタムツール
+   * false: カスタムエージェント
    */
   isBuiltin: boolean;
 
   /**
-   * カスタムツールの場合、元の設定
+   * カスタムエージェントの場合、元の設定
    *
    * isBuiltin=false の場合のみ存在。
    */
-  customConfig?: CustomAITool;
+  customConfig?: CodingAgent;
 }
 
 /**
- * ツール起動オプション
+ * コーディングエージェント起動オプション
  *
- * launchCustomAITool() 関数の引数として使用。
+ * launchCodingAgent() 関数の引数として使用。
  */
-export interface LaunchOptions {
+export interface CodingAgentLaunchOptions {
   /**
    * 実行モード
    */
@@ -239,7 +239,7 @@ export interface LaunchOptions {
   /**
    * 作業ディレクトリ（ワークツリーパス）
    *
-   * ツール起動時のcwdとして使用されます。
+   * エージェント起動時のcwdとして使用されます。
    */
   cwd?: string;
 

package/src/utils/command.ts

@@ -59,6 +59,7 @@ export interface CommandLookupResult {
   available: boolean;
   path: string | null;
   source: "installed" | "bunx";
+  version?: string | null;
 }
 
 /**
@@ -69,6 +70,7 @@ export interface ToolStatus {
   name: string;
   status: "installed" | "bunx";
   path: string | null;
+  version?: string | null;
 }
 
 /**
@@ -85,6 +87,33 @@ export function clearCommandLookupCache(): void {
   commandLookupCache.clear();
 }
 
+/**
+ * Gets the version of a command by running it with --version.
+ * FR-022: Returns version in "v{version}" format, null on failure.
+ * FR-023: Times out after 3 seconds to minimize startup delay.
+ *
+ * @param commandPath - Full path to the command
+ * @returns Version string (e.g., "v1.0.3") or null on failure
+ */
+export async function getCommandVersion(
+  commandPath: string,
+): Promise<string | null> {
+  try {
+    const result = await execa(commandPath, ["--version"], {
+      timeout: 3000,
+      stdin: "ignore",
+      stdout: "pipe",
+      stderr: "ignore",
+    });
+    // Extract version number from output
+    // Examples: "claude 1.0.3", "codex 0.77.0", "gemini 0.1.0"
+    const match = result.stdout.match(/(\d+\.\d+(?:\.\d+)?(?:-[\w.]+)?)/);
+    return match ? `v${match[1]}` : null;
+  } catch {
+    return null;
+  }
+}
+
 /**
  * Finds a command by checking PATH first, then fallback paths.
  * Results are cached for the lifetime of the process (FR-020).
@@ -141,6 +170,13 @@ export async function findCommand(
     lookupResult = { available: true, path: null, source: "bunx" };
   }
 
+  // Step 4: Get version for installed commands (FR-022)
+  if (lookupResult.source === "installed" && lookupResult.path) {
+    lookupResult.version = await getCommandVersion(lookupResult.path);
+  } else {
+    lookupResult.version = null;
+  }
+
   // Cache the result (FR-020)
   commandLookupCache.set(commandName, lookupResult);
 
@@ -181,6 +217,7 @@ export async function detectAllToolStatuses(): Promise<ToolStatus[]> {
         name: tool.displayName,
         status: result.source,
         path: result.path,
+        version: result.version ?? null,
       };
     }),
   );