v2.3.0

주요 내용

• 기본값으로 백그라운드 서브에이전트: 서브에이전트가 이제 즉시 반환되어 백그라운드에서 계속 실행되며, 유휴 상태가 될 때마다 결과를 보고합니다. 여러 서브에이전트가 동시에 실행되는 동안에도 상위 세션에서 계속 작업할 수 있습니다. (#63382)
• 기본값으로 더 간결한 트랜스크립트: TUI가 각 도구 호출 및 생각(thought) 묶음을 접을 수 있는 하나의 활동 행으로 요약하여 답변을 더 쉽게 따라갈 수 있습니다. 모든 단계를 다시 보려면 설정에서 Verbosity를 medium 또는 high로 지정하거나 TUI 구성에서 session.verbosity를 설정하세요. 기존 설정은 그대로 유지됩니다. (#63207)
• 이전 프롬프트로 이동: 데스크톱 앱에서 명령 팔레트의 Jump to message를 열거나 Cmd+Alt+G(Windows 및 Linux에서는 Ctrl+Alt+G)를 누르면, 현재 세션의 프롬프트를 검색하고 원하는 프롬프트로 바로 이동할 수 있습니다. (#63585)

Core

개선 사항

• 서브에이전트가 이제 항상 백그라운드에서 실행되며, 세션 ID를 즉시 반환하고, 유휴 상태가 될 때마다 결과를 상위 세션에 보고합니다. (#63382)
• mcp_events 플래그 뒤에 MCP 이벤트에 대한 실험적 지원을 추가했습니다. (#63254, #63261, #63269)
• 셸 명령이 서버 핸드오프 후에도 유지되며, 중단되더라도 출력을 보존합니다.
• shell_timeout_background 플래그 뒤에 타임아웃이 만료되면 셸 명령을 백그라운드로 옮기는 기능에 대한 실험적 지원을 추가했습니다. 이 플래그가 켜진 상태에서 백그라운드 명령에 명시적 타임아웃이 설정되면 해당 명령이 중지됩니다. (#63024, #63703)
• 로컬 Windows 셸 명령이 이제 프로세스 데몬을 통해 실행됩니다.
• 호환되는 모델에서 자유 형식(freeform) 도구 입력을 지원하도록 추가했습니다.
• LM Studio 결정 모델(decision-model) 지원을 추가했습니다.
• 에이전트가 이제 자신의 세션이 포크(fork)된 세션인지 알 수 있습니다. @hasta84님께 감사드립니다. (#63235)
• 도구 출력 잘라내기(truncation) 시 출력의 앞부분을 유지하며, 전체 출력을 저장할 수 없는 경우에도 사용 가능한 미리보기를 보존합니다.
• 꼬리 읽기(tail read)가 더 이상 전체 파일을 메모리에 로드하지 않습니다.
• 상호 TLS(mutual TLS)를 요구하는 게이트웨이를 위해 프로바이더가 클라이언트 인증서를 제시할 수 있습니다. 프로바이더에 settings.tls를 설정하고 cert, key, 선택적으로 passphrase를 지정하세요. 값은 apiKey와 마찬가지로 {file:} 및 {env:}를 지원합니다. (#61832)
• 서브에이전트가 자체 백그라운드 작업이 아직 실행 중인 상태에서 유휴 상태가 되면, 상위 세션에 대한 보고에 아직 실행 중이라고 표시됩니다. 따라서 상위 세션은 부분 답변을 완료된 것으로 간주하지 않고 최종 보고를 기다립니다. (#63675)
• Code Mode에서 파일 및 스킬 도구가 더 단순한 구조화된 결과를 반환합니다. write와 edit는 확인 메시지를 문자열로 반환하고, patch는 빈 결과를 반환하며, skill은 스킬의 디렉터리와 내용을 반환합니다. (#63616, #63635, #63618, #63623)

버그 수정

• 대소문자를 구분하지 않는 파일 시스템에서 패치 내 대소문자만 다른 파일 이름 변경 문제를 수정했습니다.
• Claude Agent 프롬프트나 도구가 변경된 후 오래된 사고(thinking) 내용이 유지되던 문제를 수정했습니다.
• 직접 구동되는 하위 세션이 재시작 후 再개되지 않던 문제를 수정했습니다.
• 이전 플러그인의 정리(cleanup)가 실패하면 플러그인 교체가 중단되던 문제를 수정했습니다.
• 서버가 127.0.0.1을 다시 쓸 때 MCP OAuth 갱신 및 localhost 리디렉션 문제를 수정했습니다.
• 저장된 API 키가 로컬 모델 탐색에서 누락되던 문제를 수정했습니다.
• 로컬 모델 탐색(Ollama, LM Studio, vLLM)이 요청당 1초 대신 최대 15초까지 기다리도록 변경되어, 원격 또는 터널링된 엔드포인트도 모델 목록을 표시할 수 있습니다. 느린 엔드포인트가 다른 엔드포인트나 설정 다시 로드를 더 이상 지연시키지 않습니다. (#63700)
• Code Mode에서 네임스페이스를 도구처럼 호출하면, 그 아래에 있는 실제 도구를 최대 3개까지 제안합니다. (#63697)
• 재시도 가능한 프로바이더 스트림이 중단되었을 때 완료된 작업을 잃어버리던 문제를 수정했습니다.
• 모델 로딩이 끝나기 전에 GitHub Copilot 요청이 잘못된 엔드포인트를 사용하던 문제를 수정했습니다.
• 요청 속도 제한이 소진된 경우 이를 종료 상태로 처리하던 문제를 수정했습니다. @Kyle-j-bush님께 감사드립니다. (#59816)
• 컨텍스트 길이가 null인 LM Studio 모델 및 허용된 결정 유형 모델 문제를 수정했습니다. @tomzhu1024님께 감사드립니다. (#56214)

TUI

개선 사항

• 트랜스크립트 verbosity 기본값이 이제 low이며, 도구 및 생각 묶음을 하나의 활동 행으로 요약합니다. 이미 설정한 session.verbosity는 유지됩니다. (#63207)
• 메시지에서 찾은 세션 ID를 이제 바로 열 수 있습니다.
• 활동 탭을 클릭할 수 있으며, 올바른 화면이 열립니다.
• 셸 모드가 새 디자인에서 고유한 프롬프트 색상을 갖게 되었습니다.

버그 수정

• 실행 취소로 플레이스홀더가 되돌아올 때 붙여넣은 텍스트를 복원했습니다.
• 프롬프트 기록을 탐색한 후 실시간 초안을 복원했습니다.
• 프롬프트 선택 영역 안에서 붙여넣기를 복사하던 문제를 수정했습니다.
• 명령 팔레트를 닫을 때 Mini 컴포저의 캐럿 위치를 보존합니다.
• 이미지 미리보기가 비활성화된 경우 이미지 바이트가 트랜스크립트 저장소에 보관되지 않도록 했습니다.
• 밝은 테마와 어두운 테마 모두에서 붙여넣기 칩의 대비 문제를 수정했습니다.
• 플러그인이 제공하는 테마가 실시간으로 업데이트되지 않던 문제를 수정했습니다.
• 세션 목록이 현재 세션이 아닌 맨 위에서 열리도록 변경했습니다.
• Mini 스크롤백에 더 이상 사용되지 않는 실행 안내 대신 서브에이전트 카드가 표시됩니다.

Desktop

개선 사항

• 명령 팔레트에 Jump to message를 추가했습니다. Cmd+Alt+G / Ctrl+Alt+G로 실행하며, 타임라인에 아직 로드되지 않은 프롬프트도 포함됩니다. @usrnk1님께 감사드립니다. (#63585)
• 실험적 Recent 세션 사이드바를 추가했습니다. 서버 간 최근성, 로컬 고정, 순서 변경, 표준 세션 행 작업을 지원합니다.
• 최근 세션은 최근 7일 및 30개 행으로 제한되며, 숨기거나 음소거할 수 있습니다.
• 실험적인 사용자 지정 가능 세션 사이드바를 추가했습니다.
• Mermaid 다이어그램을 최대화하여 확대/축소 및 이동할 수 있습니다. (#59250)
• Alt+Enter로 후속 프롬프트를 큐의 맨 앞에 배치하고, Mod+Enter로 다음 대기 중인 프롬프트를 조정할 수 있습니다.
• 모디파이어 키를 누르고 있으면 탭 단축키 번호가 표시됩니다.
• 각 서버의 터미널 셸을 메뉴에서 선택할 수 있습니다.
• 해당되는 경우 컴포저 대신 무료 사용량 한도 패널이 표시됩니다.
• 세션 ID를 더 쉽게 찾고 복사할 수 있습니다.

버그 수정

• 목록 다시 로드, 이름 변경, 실행 완료 후에도 최근 세션이 안정적인 최근성 순서를 유지합니다.
• 서버 플러그인 로드가 끝난 후 브라우저 패널이 재시도하지 않던 문제를 수정했습니다.
• 입력 중 멘션 제안이 다시 생성되던 문제를 수정했습니다.
• SSH 프롬프트가 연결 후 진행되거나 닫히지 않던 문제를 수정했습니다.
• 붙여넣은 프로바이더 인증 리디렉션 URL이 거부되던 문제를 수정했습니다.
• New 타임라인에서 메시지 푸터를 복원했습니다.
• 레이블에 인라인 코드가 포함된 링크 문제를 수정했습니다.
• 로그인 셸 환경을 탐색하는 동안 데스크톱 메인 프로세스가 멈추던 문제를 수정했습니다.
• 레이아웃 방향을 변경한 후 드래그 영역 문제를 수정했습니다.
• 세로 탭 미리보기가 잘못된 탭에 붙던 문제를 수정했습니다.
• 파일 트리 사이드바 열기 애니메이션 문제를 수정했습니다.
• 밝은 테마에서 페어링 QR 코드 대비 문제를 수정했습니다. @ssskay님께 감사드립니다. (#63220)
• 활동 탭 탐색 및 클릭 처리 문제를 수정했습니다. @OpeOginni님께 감사드립니다. (#60168)

SDK

개선 사항

• 이벤트 구독이 이제 MCP 이벤트 구독의 experimental.mcp.event 이벤트를 받을 수 있습니다.
• 모델 기능 스키마가 지원되는 자유 형식 도구 입력 형식을 명시하도록 변경되었습니다.
• 세션 처리량(throughput)이 이제 첫 스트리밍 토큰부터 측정됩니다.
• 세션 생성 문서에서 parentID 필드를 명확히 설명합니다.

Extensions

개선 사항

• Promise 기반 도구가 ToolContext.signal을 통해 협력적으로 중지될 수 있습니다.
• 실험적 session.fork 훅을 추가했습니다.
• Promise 플러그인 정리 실패가 이후 플러그인 교체를 더 이상 막지 않습니다.
• @opencode/plugin/effect가 이제 Tool을 내보내므로, execute.before 훅이 @opencode/schema/tool을 임포트하지 않고도 Tool.Error로 호출을 거부할 수 있습니다. (#63698)