@jcjeon/integration-cli 0.2.0 → 0.2.1

package/apps/server/src/modules/agents/claude/claude.controller.ts

@@ -1,85 +0,0 @@
-import {
-  Body,
-  Controller,
-  Delete,
-  Get,
-  HttpCode,
-  HttpStatus,
-  Param,
-  Post,
-  UsePipes,
-  ValidationPipe,
-} from '@nestjs/common';
-import { ApiNoContentResponse, ApiOkResponse, ApiOperation, ApiTags } from '@nestjs/swagger';
-
-import { ClaudeAuthManager } from './claude-auth.manager';
-import type { AuthStatus } from './claude-auth.manager';
-import { ClaudeService } from './claude.service';
-import type { ClaudeStatus } from './claude.service';
-import { ClaudeCreateSessionDto as CreateSessionDto } from './dto/create-session.dto';
-import { SendInputDto } from './dto/send-input.dto';
-import type { SessionInfo } from './interfaces/claude-session.interface';
-
-@ApiTags('agents/claude')
-@UsePipes(new ValidationPipe({ transform: true, whitelist: true }))
-@Controller('agents/claude')
-export class ClaudeController {
-  constructor(
-    private readonly claudeService: ClaudeService,
-    private readonly authManager: ClaudeAuthManager,
-  ) {}
-
-  @ApiOperation({ summary: 'Claude Code 인증 상태 조회' })
-  @ApiOkResponse({ description: '인증 상태 반환' })
-  @Get('auth/status')
-  getAuthStatus(): Promise<AuthStatus> {
-    return this.authManager.getAuthStatus();
-  }
-
-  @ApiOperation({ summary: 'Claude Code 통합 상태 조회 (버전·인증·세션 수)' })
-  @ApiOkResponse({ description: '버전, 플랫폼, 인증, 활성 세션 수' })
-  @Get('status')
-  getStatus(): Promise<ClaudeStatus> {
-    return this.claudeService.getStatus();
-  }
-
-  @ApiOperation({ summary: '새 Claude 세션 생성' })
-  @ApiOkResponse({ description: '생성된 세션 정보' })
-  @Post('sessions')
-  createSession(@Body() dto: CreateSessionDto): SessionInfo {
-    return this.claudeService.createSession(dto);
-  }
-
-  @ApiOperation({ summary: '활성 Claude 세션 목록 조회' })
-  @ApiOkResponse({ description: '세션 목록' })
-  @Get('sessions')
-  listSessions(): SessionInfo[] {
-    return this.claudeService.listSessions();
-  }
-
-  @ApiOperation({ summary: '특정 Claude 세션 조회' })
-  @ApiOkResponse({ description: '세션 정보' })
-  @Get('sessions/:id')
-  getSession(@Param('id') id: string): SessionInfo {
-    return this.claudeService.getSession(id);
-  }
-
-  @ApiOperation({
-    summary: '세션에 메시지 전송',
-    description: '응답은 WebSocket `/agents/claude` 네임스페이스의 `session:text` / `session:result` 이벤트로 수신',
-  })
-  @ApiNoContentResponse({ description: '전송 완료 (응답 본문 없음)' })
-  @Post('sessions/:id/message')
-  @HttpCode(HttpStatus.NO_CONTENT)
-  sendMessage(@Param('id') id: string, @Body() dto: SendInputDto): void {
-    this.claudeService.sendMessage(id, dto.input);
-  }
-
-  @ApiOperation({ summary: '세션 종료' })
-  @ApiNoContentResponse({ description: '종료 완료 (응답 본문 없음)' })
-  @Delete('sessions/:id')
-  @HttpCode(HttpStatus.NO_CONTENT)
-  terminateSession(@Param('id') id: string): void {
-    this.claudeService.terminateSession(id);
-  }
-}

package/apps/server/src/modules/agents/claude/claude.gateway.ts

@@ -1,158 +0,0 @@
-import { Logger, UsePipes, ValidationPipe } from '@nestjs/common';
-import {
-  ConnectedSocket,
-  MessageBody,
-  OnGatewayConnection,
-  OnGatewayDisconnect,
-  OnGatewayInit,
-  SubscribeMessage,
-  WebSocketGateway,
-  WebSocketServer,
-  WsException,
-} from '@nestjs/websockets';
-import { Server, Socket } from 'socket.io';
-
-import { ClaudeAuthManager } from './claude-auth.manager';
-import { ClaudePtyManager } from './claude-pty.manager';
-import type { ClaudeCreateSessionDto as CreateSessionDto } from './dto/create-session.dto';
-import type { SendInputDto } from './dto/send-input.dto';
-import type {
-  ResultEvent,
-  SessionExitEvent,
-  TextDeltaEvent,
-  ToolUseEvent,
-} from './interfaces/stream-event.interface';
-
-/**
- * WebSocket 이벤트 프로토콜
- *
- * Client → Server
- *   session:create    { workingDirectory? }           세션 생성
- *   session:message   { sessionId, input }            메시지 전송 → claude 실행
- *   session:terminate { sessionId }                   세션 종료
- *
- * Server → Client
- *   session:created   { id, status, ... }             세션 생성 완료
- *   session:text      { sessionId, text }             텍스트 스트리밍 (delta)
- *   session:tool      { sessionId, tool, input }      도구 사용 알림
- *   session:result    { sessionId, result, ... }      응답 완료 + 메타데이터
- *   session:exit      { sessionId, exitCode }         프로세스 종료
- *   error             { message }                     오류
- */
-@UsePipes(new ValidationPipe({ transform: true, whitelist: true }))
-@WebSocketGateway({ namespace: '/agents/claude', cors: { origin: '*' } })
-export class ClaudeGateway implements OnGatewayInit, OnGatewayConnection, OnGatewayDisconnect {
-  @WebSocketServer()
-  private readonly server!: Server;
-
-  private readonly logger = new Logger(ClaudeGateway.name);
-  private readonly subscriptions = new Map<string, Set<string>>();
-
-  constructor(
-    private readonly ptyManager: ClaudePtyManager,
-    private readonly authManager: ClaudeAuthManager,
-  ) {}
-
-  // ─── Gateway hooks ───────────────────────────────────────────────────
-
-  afterInit(): void {
-    this.ptyManager.on('text-delta', (event: TextDeltaEvent) => {
-      this.server.to(event.sessionId).emit('session:text', event);
-    });
-
-    this.ptyManager.on('tool-use', (event: ToolUseEvent) => {
-      this.server.to(event.sessionId).emit('session:tool', event);
-    });
-
-    this.ptyManager.on('result', (event: ResultEvent) => {
-      this.server.to(event.sessionId).emit('session:result', event);
-    });
-
-    this.ptyManager.on('exit', (event: SessionExitEvent) => {
-      this.server.to(event.sessionId).emit('session:exit', event);
-    });
-
-    this.ptyManager.on('error', (event: { sessionId: string; message: string }) => {
-      this.server.to(event.sessionId).emit('error', { message: event.message });
-    });
-
-    this.logger.log('ClaudeGateway initialised — namespace: /agents/claude');
-  }
-
-  handleConnection(client: Socket): void {
-    this.subscriptions.set(client.id, new Set());
-  }
-
-  handleDisconnect(client: Socket): void {
-    this.authManager.cancelLogin(client.id);
-    this.subscriptions.delete(client.id);
-  }
-
-  // ─── Message handlers ────────────────────────────────────────────────
-
-  @SubscribeMessage('session:create')
-  handleCreate(
-    @ConnectedSocket() client: Socket,
-    @MessageBody() dto: CreateSessionDto,
-  ): void {
-    try {
-      const session = this.ptyManager.createSession(dto.workingDirectory, dto.model, dto.reasoning);
-      void client.join(session.id);
-      this.subscriptions.get(client.id)?.add(session.id);
-      client.emit('session:created', session);
-    } catch (err) {
-      this.emitError(client, err);
-    }
-  }
-
-  @SubscribeMessage('session:message')
-  handleMessage(
-    @ConnectedSocket() client: Socket,
-    @MessageBody() body: { sessionId: string; model?: string; reasoning?: string } & SendInputDto,
-  ): void {
-    try {
-      void client.join(body.sessionId);
-      this.subscriptions.get(client.id)?.add(body.sessionId);
-      this.ptyManager.sendMessageWithSettings(body.sessionId, body.input, body.model, body.reasoning);
-    } catch (err) {
-      this.emitError(client, err);
-    }
-  }
-
-  @SubscribeMessage('session:terminate')
-  handleTerminate(
-    @ConnectedSocket() client: Socket,
-    @MessageBody('sessionId') sessionId: string,
-  ): void {
-    try {
-      this.ptyManager.terminateSession(sessionId);
-    } catch (err) {
-      this.emitError(client, err);
-    }
-  }
-
-  // ─── Auth ────────────────────────────────────────────────────────────
-
-  @SubscribeMessage('auth:login:start')
-  handleAuthLoginStart(@ConnectedSocket() client: Socket): void {
-    this.authManager.startLogin(
-      client.id,
-      (text) => client.emit('auth:output', { text }),
-      (success) => client.emit('auth:done', { success }),
-    );
-  }
-
-  @SubscribeMessage('auth:login:cancel')
-  handleAuthLoginCancel(@ConnectedSocket() client: Socket): void {
-    this.authManager.cancelLogin(client.id);
-  }
-
-  // ─── Private ─────────────────────────────────────────────────────────
-
-  private emitError(client: Socket, err: unknown): void {
-    const message = err instanceof Error ? err.message : 'Unknown error';
-    this.logger.error(`[${client.id}] ${message}`);
-    client.emit('error', { message });
-    throw new WsException(message);
-  }
-}

package/apps/server/src/modules/agents/claude/claude.module.ts

@@ -1,18 +0,0 @@
-import { Module } from '@nestjs/common';
-import { TypeOrmModule } from '@nestjs/typeorm';
-
-import { AgentSessionEntity } from '../../../database/entities/agent-session.entity';
-import { SessionEntity } from '../../../database/entities/session.entity';
-import { ClaudeAuthManager } from './claude-auth.manager';
-import { ClaudePtyManager } from './claude-pty.manager';
-import { ClaudeController } from './claude.controller';
-import { ClaudeGateway } from './claude.gateway';
-import { ClaudeService } from './claude.service';
-
-@Module({
-  imports: [TypeOrmModule.forFeature([AgentSessionEntity, SessionEntity])],
-  controllers: [ClaudeController],
-  providers: [ClaudeService, ClaudePtyManager, ClaudeAuthManager, ClaudeGateway],
-  exports: [ClaudeService, ClaudePtyManager],
-})
-export class ClaudeModule {}

package/apps/server/src/modules/agents/claude/claude.service.ts

@@ -1,67 +0,0 @@
-import { execSync } from 'child_process';
-import * as os from 'os';
-
-import { Injectable } from '@nestjs/common';
-
-import { ClaudeAuthManager } from './claude-auth.manager';
-import { ClaudePtyManager } from './claude-pty.manager';
-import type { ClaudeCreateSessionDto as CreateSessionDto } from './dto/create-session.dto';
-import type { SessionInfo } from './interfaces/claude-session.interface';
-
-export interface ClaudeStatus {
-  version: string;
-  auth: {
-    loggedIn: boolean;
-    authMethod: string;
-    apiProvider: string;
-    email?: string;
-    orgName?: string;
-    subscriptionType?: string;
-  };
-  activeSessions: number;
-  platform: string;
-}
-
-@Injectable()
-export class ClaudeService {
-  constructor(
-    private readonly ptyManager: ClaudePtyManager,
-    private readonly authManager: ClaudeAuthManager,
-  ) {}
-
-  createSession(dto: CreateSessionDto): SessionInfo {
-    return this.ptyManager.createSession(dto.workingDirectory, dto.model, dto.reasoning);
-  }
-
-  terminateSession(sessionId: string): void {
-    this.ptyManager.terminateSession(sessionId);
-  }
-
-  sendMessage(sessionId: string, message: string): void {
-    this.ptyManager.sendMessage(sessionId, message);
-  }
-
-  getSession(sessionId: string): SessionInfo {
-    return this.ptyManager.getSessionInfo(sessionId);
-  }
-
-  listSessions(): SessionInfo[] {
-    return this.ptyManager.listSessions();
-  }
-
-  async getStatus(): Promise<ClaudeStatus> {
-    let version = 'unknown';
-    try {
-      version = execSync('claude --version', { encoding: 'utf8', timeout: 3000 }).trim();
-    } catch {}
-
-    const auth = await this.authManager.getAuthStatus();
-
-    return {
-      version,
-      auth,
-      activeSessions: this.ptyManager.listSessions().length,
-      platform: `${os.platform()} ${os.arch()}`,
-    };
-  }
-}

package/apps/server/src/modules/agents/claude/dto/create-session.dto.ts

@@ -1,24 +0,0 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsObject, IsOptional, IsString } from 'class-validator';
-
-export class ClaudeCreateSessionDto {
-  @ApiPropertyOptional({ example: '/Users/me/my-project', description: '세션 작업 디렉토리' })
-  @IsOptional()
-  @IsString()
-  workingDirectory?: string;
-
-  @ApiPropertyOptional({ example: 'sonnet', description: 'Claude CLI 모델명 또는 별칭' })
-  @IsOptional()
-  @IsString()
-  model?: string;
-
-  @ApiPropertyOptional({ example: 'high', description: 'Claude reasoning effort' })
-  @IsOptional()
-  @IsString()
-  reasoning?: string;
-
-  @ApiPropertyOptional({ example: { NODE_ENV: 'development' }, description: '추가 환경 변수' })
-  @IsOptional()
-  @IsObject()
-  env?: Record<string, string>;
-}

package/apps/server/src/modules/agents/claude/dto/resize-session.dto.ts

@@ -1,13 +0,0 @@
-import { IsInt, Max, Min } from 'class-validator';
-
-export class ResizeSessionDto {
-  @IsInt()
-  @Min(10)
-  @Max(500)
-  cols!: number;
-
-  @IsInt()
-  @Min(5)
-  @Max(200)
-  rows!: number;
-}

package/apps/server/src/modules/agents/claude/dto/send-input.dto.ts

@@ -1,9 +0,0 @@
-import { ApiProperty } from '@nestjs/swagger';
-import { IsString, MinLength } from 'class-validator';
-
-export class SendInputDto {
-  @ApiProperty({ example: '현재 코드를 분석해줘', description: '에이전트에게 전달할 메시지' })
-  @IsString()
-  @MinLength(1)
-  input!: string;
-}

package/apps/server/src/modules/agents/claude/interfaces/claude-session.interface.ts

@@ -1,26 +0,0 @@
-export type SessionStatus = 'idle' | 'processing' | 'terminated';
-
-export interface ClaudeSession {
-  id: string;
-  /** Claude CLI가 발급한 session_id — --resume에 사용 */
-  claudeSessionId: string | null;
-  status: SessionStatus;
-  workingDirectory: string;
-  model: string | null;
-  reasoning: string | null;
-  createdAt: Date;
-  lastActivity: Date;
-  /** 첫 메시지 전송 전까지 false — DB에 아직 적재되지 않은 상태 */
-  persisted: boolean;
-}
-
-export interface SessionInfo {
-  id: string;
-  claudeSessionId: string | null;
-  status: SessionStatus;
-  workingDirectory: string;
-  model: string | null;
-  reasoning: string | null;
-  createdAt: Date;
-  lastActivity: Date;
-}

package/apps/server/src/modules/agents/claude/interfaces/pty-event.interface.ts

@@ -1,10 +0,0 @@
-export interface PtyOutputEvent {
-  sessionId: string;
-  data: string;
-  timestamp: Date;
-}
-
-export interface PtyExitEvent {
-  sessionId: string;
-  exitCode: number;
-}

package/apps/server/src/modules/agents/claude/interfaces/stream-event.interface.ts

@@ -1,61 +0,0 @@
-/** Claude CLI --output-format stream-json 이벤트 타입 */
-
-export interface TextDeltaEvent {
-  sessionId: string;
-  text: string;
-}
-
-export interface ToolUseEvent {
-  sessionId: string;
-  tool: string;
-  input: Record<string, unknown>;
-}
-
-export interface ResultEvent {
-  sessionId: string;
-  result: string;
-  isError: boolean;
-  durationMs: number;
-  costUsd: number;
-}
-
-export interface SessionExitEvent {
-  sessionId: string;
-  exitCode: number;
-}
-
-// ─── Claude CLI NDJSON raw 타입 ──────────────────────────────────────────────
-
-export interface ClaudeInitEvent {
-  type: 'system';
-  subtype: 'init';
-  session_id: string;
-  model: string;
-}
-
-export interface ClaudeAssistantEvent {
-  type: 'assistant';
-  session_id: string;
-  message: {
-    content: Array<
-      | { type: 'text'; text: string }
-      | { type: 'tool_use'; id: string; name: string; input: Record<string, unknown> }
-    >;
-  };
-}
-
-export interface ClaudeResultEvent {
-  type: 'result';
-  subtype: 'success' | 'error';
-  session_id: string;
-  result: string;
-  is_error: boolean;
-  duration_ms: number;
-  total_cost_usd: number;
-}
-
-export type ClaudeStreamEvent =
-  | ClaudeInitEvent
-  | ClaudeAssistantEvent
-  | ClaudeResultEvent
-  | { type: string };

package/apps/server/src/modules/agents/codex/codex-auth.manager.ts

@@ -1,107 +0,0 @@
-import { execFileSync } from 'child_process';
-import * as fs from 'fs';
-import * as os from 'os';
-import * as path from 'path';
-
-import { Injectable, Logger } from '@nestjs/common';
-import * as pty from 'node-pty';
-
-const IS_WIN = process.platform === 'win32';
-
-export interface CodexAuthStatus {
-  installed: boolean;
-  loggedIn: boolean;
-}
-
-const KEY_PATH = path.join(os.homedir(), '.ji', 'codex-key');
-const ANSI_STRIP = /\x1b\[[0-9;]*[a-zA-Z]/g;
-
-@Injectable()
-export class CodexAuthManager {
-  private readonly logger = new Logger(CodexAuthManager.name);
-  private readonly loginProcesses = new Map<string, pty.IPty>();
-
-  getAuthStatus(): CodexAuthStatus {
-    const installed = this.isInstalled();
-    if (!installed) return { installed: false, loggedIn: false };
-
-    const loggedIn = this.isLoggedInViaDevice() || !!(this.readStoredApiKey() || process.env.OPENAI_API_KEY);
-    return { installed, loggedIn };
-  }
-
-  saveApiKey(apiKey: string): void {
-    const dir = path.dirname(KEY_PATH);
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-    fs.writeFileSync(KEY_PATH, apiKey, { mode: 0o600 });
-    this.logger.log('Saved Codex API key');
-  }
-
-  startLogin(
-    clientId: string,
-    onOutput: (text: string) => void,
-    onDone: (success: boolean) => void,
-  ): void {
-    this.cancelLogin(clientId);
-
-    const proc = pty.spawn(IS_WIN ? 'codex.cmd' : 'codex', ['login', '--device-auth'], {
-      name: 'xterm-256color',
-      cols: 120,
-      rows: 30,
-      env: process.env as Record<string, string>,
-    });
-
-    this.loginProcesses.set(clientId, proc);
-    this.logger.log(`Started Codex device login for client ${clientId} (pid: ${proc.pid})`);
-
-    proc.onData((data) => onOutput(data.replace(ANSI_STRIP, '')));
-
-    proc.onExit(({ exitCode }) => {
-      this.loginProcesses.delete(clientId);
-      this.logger.log(`Codex login for ${clientId} exited with code ${exitCode}`);
-      onDone(exitCode === 0);
-    });
-  }
-
-  cancelLogin(clientId: string): void {
-    const proc = this.loginProcesses.get(clientId);
-    if (proc) {
-      try { proc.kill(); } catch { /* ignore */ }
-      this.loginProcesses.delete(clientId);
-    }
-  }
-
-  getEnvForCodex(): NodeJS.ProcessEnv {
-    const apiKey = this.readStoredApiKey() ?? process.env.OPENAI_API_KEY;
-    return apiKey ? { ...process.env, OPENAI_API_KEY: apiKey } : process.env;
-  }
-
-  private isInstalled(): boolean {
-    try {
-      execFileSync('codex', ['--version'], { stdio: 'ignore', shell: true });
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  private isLoggedInViaDevice(): boolean {
-    try {
-      execFileSync('codex', ['login', 'status'], {
-        timeout: 5000,
-        stdio: 'ignore',
-        shell: true,
-      });
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  private readStoredApiKey(): string | null {
-    try {
-      return fs.readFileSync(KEY_PATH, 'utf8').trim() || null;
-    } catch {
-      return null;
-    }
-  }
-}