Agent 버전 기록

v0.5.0(2026/07/22)¶

이번 릴리스는 Beak 네이티브 Agent 협업, obscli 자동화 및 구조화된 컨텍스트 선택, obs-agent 엔터프라이즈 프록시 및 컨테이너 배포 기능, 그리고 Agent 메시지 전달, 장시간 실행 작업, 서브에이전트 및 도구 루프에 대한 안정성과 관측 가능성 강화에 초점을 맞추고 있습니다.

새로운 기능¶

• Beak 네이티브 Agent 간(A2A) 작업 위임 기능을 추가했습니다. 대상 Agent는 주소 지정 가능한 이름과 기능 설명을 게시하고 신뢰할 수 있는 소스를 인가할 수 있습니다. 호출 Agent는 list_reachable_agents로 인가된 대상을 검색하고 send_message로 작업을 위임합니다. 대상은 자체 데이터 범위, Skills, 도구 권한, 승인 및 가드 경계 내에서 작동한 후 구조화된 최종 결과를 반환합니다. 오프라인 대상이 재연결되면 대기 중인 작업이 재개되며, obscli는 A2A 작업 세션을 읽기 전용 모드로 표시할 수 있습니다 (cf004e11)
• 비대화형 obscli run 명령을 추가했습니다. 인수, 파일 또는 stdin에서 일회성 프롬프트를 받아 온라인 Agent를 나열하고, 원시 Markdown 또는 JSON으로 응답, 사용량 및 첨부 파일 메타데이터를 반환합니다. 안정적인 종료 코드, 타임아웃, 진단, YOLO 및 서브에이전트 옵션으로 셸 스크립트 및 자동화에 적합합니다. obscli 매뉴얼 참조 (1a572ac1)
• obscli 대화형 입력에 관측 리소스 및 Skill 선택 기능을 추가했습니다. @를 입력하면 Service, Dashboard, Application, Host 또는 Container 유형별로 리소스를 선택할 수 있고, $를 입력하면 현재 Agent에서 사용 가능한 Skills를 선택할 수 있습니다. 선택 항목은 구조화된 메타데이터로 전송되며 입력 히스토리와 함께 복원됩니다. obscli 매뉴얼 참조 (9e8eab12)
• obs-agent에 엔터프라이즈 HTTP 포워드 프록시 지원을 추가했습니다. Basic Auth, HTTP_PROXY / HTTPS_PROXY / NO_PROXY, 엔터프라이즈 CA, Linux 설치 및 자체 업데이트, Docker, Kubernetes, Helm을 포함합니다. 프록시 자격 증명은 로그에서 마스킹됩니다. obs-agent 포워드 프록시 매뉴얼 참조 (0ad5dd7c)

버그 수정¶

• 대상 Agent가 오프라인이거나, WebSocket이 연결 해제되었거나, 메시지 버스가 실패했거나, ACK가 유실된 경우 지정된 사용자 메시지가 대상 Agent를 깨우지 못할 수 있는 문제를 수정했습니다. 서버는 이제 각 대상에 대해 영속적인 아웃박스를 생성하고, 최소 1회 전달(at-least-once delivery)을 사용하여 최대 24시간 동안 백오프로 재시도하며, 대상 Agent로부터 타입이 지정된 ACK를 수신한 후에만 중단합니다 (b76cd6a0)
• Kubernetes YAML 및 Helm 템플릿이 기본적으로 임시 볼륨을 사용하여 Pod 재빌드 또는 업그레이드 후 활성 세션/작업 히스토리가 손실될 수 있는 문제를 수정했습니다. 새 템플릿은 작업 디렉터리, 프로필 캐시 및 Owl 데이터에 영구 볼륨을 요구하며, Docker 예제는 명시적으로 명명된 볼륨 재사용을 요구합니다 (0c1f0a62)
• obs-agent 설치 디렉터리 및 민감한 파일 권한이 호스트 umask 또는 기존 파일 모드의 영향을 받는 문제를 수정했습니다. 구성, 데이터 및 로그 디렉터리는 이제 고정 권한을 사용하며, 메시지 암호화 키와 메인 로그는 소유자 읽기/쓰기로 제한되고, 민감한 경로 심볼릭 링크는 따라가지 않습니다 (3b78a24e)
• 세션 로컬 서브에이전트 크레딧이 상위 작업 사용량 합계에 포함되지 않는 문제를 수정했습니다. obscli 및 관측 가능성 데이터가 이제 완전한 토큰 및 크레딧 사용량을 표시합니다 (6eb6b2af)
• 시스템 사용자에게 업로더 권한이 없는 경우 자동화된 세션에서 Agent가 첨부 파일을 읽지 못하는 문제를 수정했습니다. Webhook 및 예약 작업과 같은 시스템 트리거 세션에서 이제 메시지와 함께 업로드된 첨부 파일에 접근할 수 있습니다 (b0c9ea93)
• Agent 런타임이 구조화된 실패 결과로 중단된 후에도 Webhook, 예약 작업 및 외부 대화 실행이 실행 중 상태로 남아 있는 문제를 수정했습니다. 서버는 이제 안정적인 stop_reason으로부터 일치하는 실행을 실패로 표시하고 요약을 기록합니다 (e4453728)

최적화¶

• 실패한 도구 호출 후 진행 상황 피드백을 개선했습니다. 정확한 업데이트를 제공할 수 있는 경우, Agent는 구조화된 필드를 사용하여 실패한 호출을 연결하고 직접적인 원인, 확인된 영향 및 조정된 다음 단계를 다음 사용자 가시 도구 호출 전에 설명하여 설명 없는 재시도를 줄입니다 (0cebc36c)
• 진행 상황 인식 리스 갱신, 정체된 작업을 일시 중지하기 전 재계획, LLM 호출, 토큰, 경과 시간, 일반 일시적 재시도 및 HTTP 429 응답에 대한 별도 경계를 통해 장시간 실행 도구 루프 예산을 최적화했습니다. 구조화된 체크포인트가 비효과적인 루프와 업스트림 메시지 제한 오류를 줄입니다 (7e56c92f)
• 웨이브 슈퍼바이저, 작업 인식 리스, 패닉 복구, 안전한 재시도, 구조화된 내부 진행 상황, 취소 가능한 wait_for 및 명시적 decline_subagents를 통해 세션 로컬 서브에이전트 스케줄링을 최적화했습니다. 독립적인 작업은 병렬로 유지되며, 엄격하게 순서가 지정된 작업은 더 이상 동일한 웨이브에 잘못 배치되지 않습니다 (d8a2ba04)
• Agent 실행, LLM, 도구 및 서브에이전트 트레이스 전반에 걸쳐 Agent OpenTelemetry 스팬 시맨틱 및 속성을 최적화하여 작업, 메시지, 사용량, 런타임 결과 및 동적 예산 데이터를 추가함으로써 교차 버전 쿼리와 문제 해결을 용이하게 합니다 (50067540)

v0.4.0(2026/07/08)¶

이번 릴리스는 세션 로컬 서브에이전트, 컨테이너화된 obs-agent 배포 및 릴리스 파이프라인 분리에 초점을 맞추고 있습니다. 또한 Agent 관측 가능성 필드를 추가하고 여러 런타임 문제를 수정합니다.

새로운 기능¶

• 세션 로컬 서브에이전트를 추가했습니다. Agent는 동일 세션 내에서 서브에이전트를 생성하고 스케줄링할 수 있으며, obscli는 서브에이전트 이벤트, 상태 및 출력을 표시할 수 있습니다. 이를 통해 복잡한 작업을 더 작은 병렬 작업 단위로 분할할 수 있습니다 (b624dc63)
• 컨테이너화된 obs-agent 릴리스 지원을 추가했습니다. CI는 이제 Docker 이미지, Kubernetes 매니페스트, Docker Compose 템플릿, Helm values 및 Helm 차트를 게시합니다. Docker, Kubernetes YAML 또는 Helm으로 obs-agent를 배포할 수 있습니다. obs-agent 컨테이너 설치 매뉴얼 참조 (2aff32e1)

버그 수정¶

• 읽을 수 없는 스킬이 Agent 스킬 인덱스에 포함될 수 있어 런타임에서 권한이나 접근 없이 스킬 파일을 읽으려고 시도하는 문제를 수정했습니다 (ca3029f8)
• Owl 설치 구성이 여전히 이전 경로를 쓸 수 있는 문제를 수정했습니다. 설치 및 종속성 초기화가 이제 일관되게 obs-agent 작업 디렉터리를 사용합니다 (255e7b0c)

최적화¶

• Agent OpenTelemetry 트레이스 필드에 세션, 작업, 모델 및 도구 호출 속성을 추가하여 트레이스에서 Agent 실행 문제 해결을 용이하게 최적화했습니다 (f859adfe)
• 공통 검사, agent 릴리스, obscli 릴리스, Docker 이미지 및 배포 구성을 별도의 CI 파일로 분리하여 agent/obscli CI 릴리스 구성을 최적화하고 릴리스 구성 유지보수 비용을 절감했습니다 (2aff32e1)

v0.3.1(2026/07/02)¶

이번 릴리스는 v0.3.0 agent/obscli 핫픽스입니다. 주로 셀프 호스팅 Agent 설치 및 MCP 읽기 전용 도구 승인 문제를 수정합니다.

버그 수정¶

• obs-agent 사용자가 생성되기 전에 Owl/Skill 종속성이 설치될 수 있는 신규 호스트에서의 셀프 호스팅 설치 문제를 수정하여, /var/lib/obs-agent/work/.owl에 대한 chown obs-agent:obs-agent이 실패하는 문제를 해결했습니다 (105e5620)
• readOnlyHint를 선언한 MCP 도구가 여전히 쓰기 작업 승인 경로에 진입할 수 있는 문제를 수정했습니다. 읽기 전용 MCP 도구는 이제 읽기 전용 힌트를 기반으로 더 낮은 위험도의 승인 경로를 따르며, 불필요한 사용자 확인을 줄입니다 (671f1733)

v0.3.0(2026/07/01)¶

이번 릴리스는 obs-agent/obscli 이름 변경, Beak과 셀프 호스팅 Agent 간 메시지 링크 암호화, 모델 선택 및 Windows 터미널 환경에 초점을 맞추고 있습니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• Beak과 셀프 호스팅 obs-agent WebSocket 채팅 링크에서 chat:user / chat:agent 콘텐츠 및 비즈니스 메타데이터에 대한 HPKE 애플리케이션 계층 메시지 암호화를 지원합니다. Beak 키 링, 에이전트 로컬 키 파일 및 키 로테이션을 지원합니다. 신규 설치 시 기본값은 /var/lib/obs-agent/message-hpke-key.json이며, 배포 및 문제 해결에 대해서는 obs-agent 메시지 링크 암호화 운영 문서를 참조하십시오 (16cd141)
• obs-agent / obscli 릴리스 아티팩트, 설치 스크립트, 제거 스크립트, 빌드 명령 및 사용자 문서 항목을 추가했습니다. 릴리스 패키지, 기본 경로 및 로컬 구성이 이제 obs 네이밍을 사용합니다 (4205ac0)
• 이전 고정 beak-agent / obsycli 레이아웃에서 obs-agent / obscli로 마이그레이션하기 위한 uninstall-legacy.sh를 추가했습니다. 업그레이드 전에 obs-agent 일상 운영 매뉴얼 및 obscli 매뉴얼에서 정리 안내를 참조하십시오 (44dd995)

curl -fsSL https://static.guance.com/obs-agent/uninstall-legacy.sh | sudo bash -s -- --yes

• 세션 모델 선택 기능을 추가했습니다. 사용자는 세션 수준에서 모델 모드를 선택할 수 있으며, obscli는 라우팅 및 실제 응답 모델을 표시합니다 (eb7ebe6)
• obs-agent YOLO 모드 구성을 추가하여 셀프 호스팅 배포에서 보다 허용적인 모드를 명시적으로 활성화할 수 있으며, 권한 상태는 obscli에 표시됩니다 (8f424e7)
• Forethought Connector / Testing Studio 소켓 통합을 추가하여 커넥터 RPC, 배포 격리 및 WebSocket 채널을 통해 Agent 생성, 인증 및 세션 링크를 전달합니다 (382d6cc)

버그 수정¶

• AI Hub 오류 코드 매핑과 Agent 런타임 stop_reason 네이밍의 불일치를 수정하여 obscli가 보다 안정적인 원인 및 처리 제안을 표시합니다 (8c0e946)
• AI Hub Chat API 또는 도구 API 실패 시 누락된 trace id 전파를 수정했습니다. Agent는 이제 X-Trace-ID를 추출하여 403 및 업스트림 타임아웃 문제 진단을 위해 가시적인 오류 콘텐츠에 포함합니다 (45c3820)
• obs 이름 변경 후 불완전한 제거 정리를 수정했습니다. uninstall.sh --yes는 이제 고정 레이아웃 바이너리, systemd 유닛, sudoers, config, data, logs 및 obs-agent 사용자/그룹을 정리합니다 (44dd995)
• Windows PowerShell 시작 렌더링에서 obscli가 원시 ANSI 제어 문자 또는 깨진 배너 테두리를 표시할 수 있는 문제를 수정했습니다 (492aaef)

최적화¶

• 설치, 업그레이드, 자체 업데이트 및 릴리스 스크립트 네이밍을 최적화했습니다. make build-obscli, make release-obscli, install-obscli.sh, install-obscli.ps1, release-obscli.sh 등의 명령이 이제 일관되게 obscli를 사용합니다 (4205ac0)
• obscli 사용자 매뉴얼에 Linux/macOS, Windows PowerShell, Windows Git Bash 및 WSL 설치/제거 경로 차이와 레거시 obsycli 마이그레이션 안내를 추가하여 최적화했습니다 (4205ac0)
• Windows 및 좁은 터미널에서 정렬 불일치 및 잘못된 ANSI 출력을 줄이기 위해 obscli 테이블, null 값, 세션 목록 및 자체 업데이트 프롬프트 렌더링을 최적화했습니다 (492aaef, f3f8e45)
• Python 하네스를 추가하고 셸 케이스를 보다 안정적인 로컬 및 CI 검증 진입점으로 마이그레이션하여 통합 테스트 실행을 최적화했습니다 (fa4e1be)

v0.2.1(2026/06/29)¶

이번 릴리스는 새로운 계획 라운드, 승인 상호작용, obscli 터미널 경험에 대한 Plan Mode 안정성에 중점을 두었습니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• obscli에 /statusline 명령이 추가되었습니다. 사용자는 다중 선택 팝업을 통해 하단 상태 표시줄 필드를 구성하고 ~/.obscli/config.toml에 설정을 영구 저장할 수 있습니다 (0a95241)
• obscli가 IM/채널 세션 시뮬레이션을 지원합니다. 컨텍스트에 채널 메타데이터를 기록하여 CLI에서 마크다운 전용 채널 시나리오를 더 쉽게 검증할 수 있습니다 (38cd453)

버그 수정¶

• Plan Mode에서 /plan을 다시 실행할 때 이전 plan id, revision 또는 런타임 메모리를 재사용할 수 있는 문제를 수정했습니다. 새로운 계획 라운드는 이제 이전 상태를 초기화하고 revision 1부터 다시 시작합니다 (2122100)
• Agent가 기본적으로 최근 채팅 컨텍스트를 포함하지 않아 다중 턴 대화에서 컨텍스트 손실이 발생할 수 있는 문제를 수정했습니다. AGENT_RECENT_CHAT_HISTORY_MESSAGES의 기본값이 이제 20입니다 (81cf418)
• 세션 이름 업데이트 후 WebSocket 클라이언트 알림이 누락되는 문제를 수정했습니다. 이제 세션 업데이트 이벤트가 게시되어 클라이언트가 제목과 목록을 즉시 새로고침할 수 있습니다 (00e943a)
• stderr 잘림, 실패 상태 색상 표시, ANSI 리셋 후 색상 유지, 승인 팝업 취소, 거부 후 턴 완료 등 여러 obscli 도구 출력 및 승인 표시 문제를 수정했습니다 (0a95241, 38cd453)

최적화¶

• 멀티라인 편집, 히스토리 검색, 슬래시 명령 선택, 팝업 선택, 터미널 키 파싱을 리팩토링하여 obscli 대화형 입력 경험을 최적화했습니다. 이제 SS3 화살표, CSI-u/Kitty 키보드 프로토콜, Home/End/Delete 등 일반적인 터미널 시퀀스를 지원합니다 (0a95241, 91f4d6f)
• 마크다운 전용 채널 세션에 대한 구조화된 기능 경계를 최적화했습니다. 해당 세션에서는 Plan Mode 및 고위험 작업 승인 동작이 차단되며, 명확한 마크다운 텍스트 안내가 제공됩니다 (38cd453)
• Plan Mode 런타임 메모리 및 컨텍스트 주입을 최적화하여 최근 사용자 입력, 최신 계획 업데이트/최종 계획, 승인된 계획 정보를 유지함으로써 계획 수정 또는 승인 후 컨텍스트 단절을 줄였습니다 (2122100)
• obscli 도구 호출 표시를 최적화하여 stdout/stderr의 긴 출력을 별도로 잘라내고, 일반 ERROR: 텍스트를 실패 결과로 렌더링하지 않으며, 색상 출력 리셋 후에도 색상을 유지합니다 (0a95241)

v0.2.0(2026/06/17)¶

이번 릴리스는 obs-agent 런타임 진단 가능성, AI Hub 오류 전파, Skill 호출 체인, obscli 상호작용 표시에 중점을 두었습니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• obscli에 로컬 설정 파일 ~/.obscli/config.toml이 추가되어 footer_fields를 통해 하단 상태 표시줄 필드를 사용자 정의할 수 있습니다. agent/task, model, token, context, permission, plan 상태 표시 옵션이 포함됩니다 (b0ebe75)
• obscli 입력 편집기에 로컬 히스토리 영구 저장 기능이 추가되었습니다. 사용자는 전송 성공 또는 실패 후 후속 상호작용에서 이전 입력의 원본 질문을 불러올 수 있습니다 (b0ebe75)

버그 수정¶

• Agent가 AI Hub의 구조화된 오류 코드를 일반적인 LLM HTTP 오류로만 처리하는 문제를 수정했습니다. 이제 INVALID_BODY, VALIDATION_ERROR, AUTH_INVALID, AGENT_API_KEY_DISABLED, DAILY_CREDIT_LIMIT_REACHED, MONTHLY_CREDIT_LIMIT_REACHED, PROTECTED_SECRET_INVALID, NO_AUTO_MODEL 등 안정적인 stop_reason을 우선 전파하고 obscli에서 해당 처리 제안을 표시합니다 (a09dcaa)
• AI Hub 봉투로 래핑된 OpenAI 호환 LLM 응답을 올바르게 파싱할 수 없는 문제를 수정했습니다. Agent가 이제 data 필드에서 실제 chat completion 콘텐츠를 추출하고 응답 모델 정보를 유지합니다 (b0bc4e2)
• query_session_events에 커서 기반 페이지네이션이 없고 오류 분류가 불안정한 문제를 수정했습니다. cursor 매개변수를 추가하고 매개변수 누락, 히스토리 읽기 실패 등을 도구 오류로 구조화했습니다 (b0bc4e2)
• render_document가 동일한 이름의 기존 파일을 덮어쓸 수 있는 문제를 수정했습니다. 이제 문서 생성 시 배타적으로 파일을 생성하여 기존 파일에 실수로 쓰는 것을 방지합니다 (b0bc4e2)
• obscli 세션 목록이 닫힌 또는 닫히는 중인 세션을 계속 표시하고 빈 목록 표시가 불명확한 문제를 수정했습니다. 이제 기본적으로 닫힌 상태를 필터링하고 사용 가능한 세션이 없을 때 빈 테이블을 표시합니다 (b0ebe75)

최적화¶

• Agent 사용자 표시 텍스트 언어 규약을 최적화했습니다. 최종 답변, 도구 코멘터리, 진행 피드백, 승인 사유, 작업 인사이트, Agent UI 문구, 마무리 요약이 원래 사용자 질문 언어를 우선적으로 따르도록 하여 Skill 문서, 스키마 또는 복구 프롬프트 언어의 간섭을 방지합니다 (b0ebe75)
• Agent use_skill 로컬 도구 호출을 제거했습니다. Skill은 read_skill/read_skill_file 및 Prompt 명령 체인을 통해 계속 사용되며, 모델이 일반 Skill을 실행 가능한 도구로 잘못 호출하는 것을 방지합니다 (b0bc4e2)
• Python 도구 예외 처리를 최적화하여 코드 누락, 비정상 종료, 타임아웃, python3 누락, 과대 출력에 대한 구조화된 오류 반환을 추가했습니다. 과도하게 큰 출력은 output_too_large로 짧은 오류로 잘라내어 후속 컨텍스트 오염을 방지합니다 (b0bc4e2)
• Agent 런타임 중지 결과를 최적화했습니다. AI Hub 오류에 대한 제목, 요약, 실행 가능한 다음 단계를 추가했습니다. 최대 도구 호출 횟수에 도달한 시나리오에서 중복된 completed/blocker 표시를 줄여 obscli/Web UI 가독성을 향상했습니다 (a09dcaa)
• 토큰 사용량 및 관측 가능성 이벤트를 최적화했습니다. LLM 응답 모델이 토큰 메타데이터에 기록됩니다. obscli 하단 상태 표시줄에서 실제 응답 모델을 표시할 수 있어 자동 라우팅 및 모델 폴백 상황 문제 해결이 용이합니다 (b0ebe75)
• obs-agent --version 출력을 최적화하여 branch, commit, 릴리스 날짜, Go 버전을 추가함으로써 온라인 agent/obscli 릴리스의 출처를 확인할 수 있습니다 (b0ebe75)
• Agent 로컬 도구 등록 구현을 최적화했습니다. 도구 레지스트리 구성 로직을 분리하고 send_email, web_search, python, render_document, read_skill 등 도구에 대한 회귀 테스트 커버리지를 추가했습니다 (b0bc4e2)
• LLM 오류 복구, Plan Mode, Python 도구, 세션 이벤트 쿼리, 문서 렌더링, Skill 읽기, 이메일 전송, Web Search, 스트림 재연결, 작업 인사이트, 세션 마무리 요약 체인을 포괄하는 agent/obscli 통합 테스트 케이스를 추가했습니다 (b0bc4e2)

v0.1.9(2026/06/15)¶

이번 릴리스는 obs-agent 기본 모델 설정, 제거 프로세스 완성, 릴리스 아티팩트 무결성에 중점을 두었습니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• Agent가 LLM_MODEL 설정 생략을 지원합니다. 런타임은 기본적으로 default 모델 식별자를 사용합니다. 설치 스크립트 및 Beak install-config에서 더 이상 사용자에게 모델 설정을 요구하지 않습니다 (d096537)
• Agent 릴리스에 uninstall.sh 아티팩트가 추가되었습니다. 사용자는 릴리스 URL을 통해 온라인으로 제거 스크립트를 가져올 수 있습니다. 릴리스, 업로드, 로컬 검증 프로세스 모두 이 제거 스크립트의 존재를 확인합니다 (1e2c13f)

버그 수정¶

• 업그레이드 시 이전 agent.env의 활성 LLM_MODEL이 유지될 수 있는 문제를 수정했습니다. 설치 스크립트가 이 이전 설정을 제거하고 기본 주석만 유지하여 이전 로컬 모델 값이 런타임 기본값을 재정의하는 것을 방지합니다 (d096537)
• LLM Chat span의 response_model이 항상 요청 모델과 동일한 문제를 수정했습니다. 이제 업스트림 응답 본문의 model 필드를 우선 사용하고, 실패 또는 부재 시 요청 모델로 폴백합니다 (d096537)

최적화¶

• Agent 제거 범위를 완성했습니다. uninstall.sh --yes는 obs-agent-update-check 서비스/타이머를 중지 및 제거하고, updater/update-check 바이너리와 /etc/sudoers.d/obs-agent를 제거하며, 테스트 루트 디렉토리에서 잔여 프로세스 감지가 호스트 프로세스를 잘못 스캔하는 문제를 수정합니다 (1e2c13f)
• 제거 경계를 명확히 했습니다. uninstall.sh는 호스트 또는 다른 서비스가 공유하는 구성 요소를 실수로 삭제하지 않도록 skill-dep.sh가 설치하거나 확인한 시스템 명령, 언어 런타임, Python/Node 패키지, 폰트 등을 삭제하지 않습니다 (1e2c13f)
• agent 설치, AgentRunner 설정, 자체 호스팅 설치, 제거 문서를 동시에 업데이트하여 현재 설치/제거 프로세스와의 일관성을 보장합니다 (d096537, 1e2c13f)
• 이번 릴리스의 설정, LLM span, Agent 제거, 릴리스 패키징, OSS 업로드 체크리스트 관련 테스트를 추가했습니다. test-release-agent.sh가 더 이상 python3에 의존하지 않아 더 간소화된 CI 환경에 적응합니다 (d096537, 1e2c13f)

v0.1.8(2026/06/12)¶

이번 릴리스는 obs-agent 런타임 진단, 도구 루프 안정성, Skill 사용 체인, obscli 표시 수정에 중점을 두었습니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• Agent에 collect_bug_report 도구가 추가되어 런타임 정보, 최근 로그, 메트릭 상태, 정제된 env/config, 프로필 캐시 진단 정보를 수집한 후 현재 작업 세션에 패키징 및 업로드하여 Agent 문제를 해결합니다 (7e073a1)

버그 수정¶

• LLM 타임아웃, 속도 제한, 업스트림 오류, 네트워크 오류에 안정적인 중지 사유가 없는 문제를 수정했습니다. Agent 런타임이 이제 llm_timeout, llm_rate_limited, llm_upstream_error, llm_network_error 등 구조화된 사유와 실행 가능한 제안을 반환합니다 (7e073a1)
• 도구 호출 매개변수 JSON 예외에 대한 진단 정보 부족, 동일한 실패 작업의 반복 호출, 유사한 도구 오류의 반복 문제를 수정했습니다. 중지 결과에 이제 가장 최근 성공 항목, 차단 항목, safe_next_actions가 포함됩니다 (7e073a1)
• 스트리밍 토큰 사용량과 최종 토큰 사용량이 동시에 도착할 때 obscli가 증분 토큰 사용량을 이중 집계할 수 있는 문제를 수정했습니다. 증분 토큰 이벤트가 reply_to_message_uuid로 중복 제거됩니다 (7e073a1)
• 세션 연결 시 obscli가 임의 문자열을 잘못 해석할 수 있는 문제를 수정했습니다. 이제 시퀀스 번호 또는 session_/session- 접두사가 있는 명시적 세션 ID만 허용합니다 (7e073a1)

최적화¶

• Agent 도구 루프 구현을 최적화했습니다. 코멘터리, 결과 봉투, 오류 분류, LLM 호출, Plan Mode, 복구, 중지 체크포인트를 독립 모듈로 분리하여 런타임 유지보수 복잡성을 줄였습니다 (7e073a1)
• LLM에 전송되는 도구 결과의 구조화된 봉투를 최적화했습니다. ToolSuccess/ToolError, 스키마 유효성 검사 복구, 라우팅 복구, 캐시 적중 마커를 추가하여 무효한 재시도 및 잘못된 도구 선택을 줄였습니다 (7e073a1)
• Skill 사용 체인을 최적화했습니다. Skills 인덱스가 더 이상 추측 가능한 .beak-skills 파일 경로를 노출하지 않습니다. 도구 이벤트에 skill_name, skill_file_path, tool_display_name을 추가했습니다. read_skill/read_skill_file에 대한 obscli 표시가 더 명확해졌습니다 (7e073a1)
• 프로필 캐시 동기화를 최적화했습니다. 프로필 캐시 파일 잠금 및 오래된 잠금 정리를 추가했습니다. 설치된 버전 정보에서 skills 인덱스를 생성하여 동시 동기화로 인한 캐시 상태 불일치 확률을 줄였습니다 (7e073a1)
• Agent 아이덴티티 및 Prompt 규칙을 최적화했습니다. 자기소개가 런타임 agent_name을 우선 사용합니다. 기반 LLM 제공자, model id, 내부 프로젝트 이름, 코드 패키지 이름 노출을 방지합니다 (7e073a1)
• obscli 도구 호출 표시를 최적화했습니다. tool_display_name을 지원하고, 긴 도구 사유의 표시 줄 수를 제한하며, 작업 메시지가 있을 때만 최근 도구 출력을 재생합니다 (7e073a1)
• obscli 작업/세션 생성 메타데이터를 최적화했습니다. session_type=task 및 source_type=user를 명시적으로 기록하여 서버가 CLI 사용자 작업 소스를 구분할 수 있도록 합니다 (57fb449)
• 수동 테스트 스크립트를 최적화했습니다. 여러 수동 테스트 인스턴스를 병렬로 실행할 수 있도록 지원하여 로컬 다중 인스턴스 디버깅 시 서로의 실행 디렉토리와 상태를 덮어쓰는 것을 방지합니다 (bd73f2e)
• 버그 리포트, 도구 루프 중지 사유, 구조화된 도구 봉투, 스키마/라우팅 복구, Skill 읽기, 프로필 캐시, LLM 오류 분류, obscli 토큰 통계, 수동 테스트 스크립트에 대한 테스트를 추가했습니다 (7e073a1, 57fb449, bd73f2e)

v0.1.7(2026/06/10)¶

이번 릴리스는 obscli 상호작용 경험, obs-agent GTrace 관찰성, Skill 사용 체인 및 Plan Mode 안정성에 중점을 둡니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• obscli에 /save 명령이 추가되어 Agent 응답에 포함된 내부 자산 첨부파일을 ~/.obsclis/attachments/에 다운로드하고 저장 가능한 첨부파일이 있을 때 안내 메시지를 제공합니다 (01d75d9)
• obscli가 대화 스트림에서 task_insight 및 session_summary를 직접 표시하도록 지원하여 Agent의 단계별 인사이트와 작업 종료 요약을 쉽게 확인할 수 있습니다 (316ecf2, 01d75d9)
• Agent에 read_skill 및 read_skill_file 도구가 추가되어 명시적으로 지정된 Skill의 SKILL.md 및 참조 파일을 먼저 읽은 다음 Skill 지침에 따라 작업을 수행합니다 (01d75d9)
• Agent가 사용자 @ 엔티티/명시적 Skill 요청 컨텍스트를 지원합니다. 메시지 메타데이터는 requested_skills를 전달하고 이를 Prompt에 주입하여 Skill 이름만으로 사용을 추측하지 않도록 합니다 (d460e73)
• Agent에 자동 작업 제목 생성 기능이 추가되었습니다. obscli가 이름 없는 작업을 생성할 때 Agent는 첫 번째 사용자 메시지를 기반으로 제목을 생성할 수 있습니다 (6b5618a)

버그 수정¶

• 일부 LLM 라운드에서 obscli의 작업 상태가 조기에 사라지는 문제를 수정했습니다. 메시지 UUID와 함께 성공적으로 전송된 일반 메시지는 실행 상태를 지속적으로 추적합니다 (01d75d9)
• obscli의 불안정한 오류 메시지 및 도구 출력 표시 문제를 수정했습니다. 사용자에게 표시되는 오류 형식을 통일하고 완전한 단일 라인 도구 출력을 유지하여 중요한 오류가 잘려서 숨겨지지 않도록 합니다 (01d75d9)
• 이전 obs-agent 구성 OTEL_EXPORTER_OTLP_PROTOCOL=grpc와의 비호환성 문제를 수정했습니다. 이제 http/protobuf로 정규화하여 이전 설치 구성에서 시작 실패를 방지합니다 (8d663c1)
• 여러 도구 루프에서 LLM Chat span의 input_preview가 동일한 원래 사용자 입력을 반복적으로 표시하는 문제를 수정했습니다. 이제 이 LLM 요청에서 가장 최근의 비런타임 프롬프트 메시지를 기록합니다 (01d75d9)
• Plan Mode 구조화된 상호작용 스키마가 여전히 불안정한 액션 레이블에 의존할 수 있는 문제를 수정했습니다. accept/reject/skip/revise는 이제 안정적인 액션 ID로만 처리됩니다 (c55f653, 01d75d9)

최적화¶

• obs-agent GTrace/OTEL 보고를 최적화했습니다. 기본값으로 OTLP HTTP/protobuf를 사용하고 OTEL_EXPORTER_OTLP_HEADERS를 지원하며 로그와 트레이스에 Agent 식별자, Plan Mode 상태 및 LLM 호출 컨텍스트를 추가합니다 (01d75d9, 8d663c1)
• Skill 종속성 설치 흐름을 최적화했습니다. 비동기 종속성 설치, 타임아웃 제어, 프로세스 그룹 정리를 통합하고 패키지 필터링을 cmd/agent 런타임으로 변경했습니다. Profile Client는 동기화 및 인덱싱만 처리합니다 (c4be7f0)
• Agent 도구 및 Prompt 규칙을 최적화했습니다. 첨부된 세션 파일, 업로드된 첨부파일, Skill 파일 읽기, 작업 디렉터리 쓰기 및 progress_feedback에 대한 사용 제약을 명확히 했습니다 (01d75d9, d460e73)
• Plan Mode 런타임 및 obscli 표시를 최적화했습니다. 직접 답변 복구, 구조화된 상호작용 이벤트, 기록 재생, 계획 상태 복구 및 도구 출력의 압축 렌더링을 개선했습니다 (c55f653)
• obscli 작업 생성 및 목록 경험을 최적화했습니다. /newtask가 사용자 정의 작업 이름을 지원합니다. 이름 없는 작업은 자동 제목 프로세스를 거칠 수 있습니다 (6b5618a)
• Agent Service 및 obscli 런타임 코드를 분리했습니다. 첨부파일 저장, Task Insight, Skill 종속성 설치, GTrace/OTEL, Plan Mode 및 세션 제목에 대한 테스트를 추가했습니다 (316ecf2, c4be7f0, 01d75d9, 6b5618a)

v0.1.6(2026/06/03)¶

이번 릴리스는 Plan Mode 안정성, 작업 종료 흐름 및 obscli 런타임 표시에 중점을 둡니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• obscli에 현재 또는 지정된 작업 종료를 지원하는 /close <number|task_id> 명령이 추가되었습니다. 종료 후 작업은 종료/완료 흐름에 들어가 새 메시지 전송을 방지합니다 (4efd12a)
• Agent에 session_summary 이벤트가 추가되었습니다. 작업이 종료되면 세션 요약이 생성되고 서버가 세션 상태 전환을 완료합니다 (4efd12a)
• Agent에 agent_runtime_result 이벤트가 추가되었습니다. obscli는 도구 루프 중지 이유, 차단 항목, 제안된 다음 단계 및 최근 완료된 작업을 표시할 수 있습니다 (845d571)

버그 수정¶

• 기록 재생 중 Plan Mode 구조화된 상호작용이 트리거 사용자 메시지에 다시 연결되지 못할 수 있는 문제를 수정했습니다. Plan 이벤트는 이제 reply_to_message_uuid를 통해 이전 메시지와 연결되도록 폴백됩니다 (845d571, 713593e)
• Plan Mode 최종 상태가 이전 스냅샷에 의해 되돌려질 수 있는 문제를 수정했습니다. 완료/중단 상태가 만료된 계획 상태에 의해 덮어쓰이지 않도록 방지합니다 (845d571)
• Plan Mode 상호작용 확인 흐름의 불안정한 판단을 수정했습니다. accept/reject/skip/revise 액션을 통일되게 사용하고 확인 후 다음 단계는 최종 계획을 제출해야 함을 명확히 했습니다 (713593e)
• 세션 상태 API가 closing을 지원하지 않는 문제를 수정했습니다. 작업 종료 시 session_close_requested 컨텍스트가 게시되어 Agent가 종료 요약을 생성할 수 있습니다 (4efd12a)

최적화¶

• Plan Mode 상호작용 스키마를 최적화했습니다. 전역 free_text를 제거하고 필드 수준 custom_input/comment_input 및 text_entry로 대체하여 CLI/Web UI 구조화된 입력 일관성을 개선했습니다 (713593e)
• obscli Plan Mode 표시를 최적화했습니다. 중간 plan_execution_progress 노이즈를 숨기고 구조화된 콘텐츠와 텍스트 콘텐츠의 중복 렌더링을 방지하며 plan 이벤트가 도착할 때 현재 작업 상태를 올바르게 종료합니다 (845d571, 713593e)
• Plan Mode에 대한 Agent Prompt 및 Prompt Builder 규칙을 최적화했습니다. 새로운 상호작용 액션, 텍스트 입력 필드 및 세션 컨텍스트 제약을 추가했습니다 (713593e)
• 문서 디렉터리 및 Plan Mode Web UI 계약을 정리했습니다. /close, session_summary, agent_runtime_result 및 plan 상호작용 스키마에 대한 설명을 추가했습니다 (845d571, 713593e, 4efd12a)
• Plan Mode, 세션 종료, 런타임 결과, 기록 재생, WSS 상태 업데이트 및 obscli /close 명령에 대한 테스트를 추가했습니다 (845d571, 713593e, 4efd12a)

v0.1.5(2026/06/01)¶

이번 릴리스는 Agent MCP Client, Plan Mode, obscli 상호작용 기능 및 권한/승인 흐름 개선에 중점을 둡니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• Agent에 MCP Client 기능이 추가되어 프로필 캐시에서 MCP 구성 및 툴킷 동기화를 지원하고 mcp_list_servers, mcp_list_tools, mcp_call_tool을 통한 MCP 도구의 통합 라우팅 호출을 지원합니다 (fcf17e3, 14aad95)
• Agent에 세션/작업 수준 Plan Mode가 추가되어 계획 초안, 구조화된 상호작용, 최종 계획 확인, 실행 진행, 차단, 중단, 완료 및 기타 계획 이벤트를 지원합니다 (c69d29c, d65661d)
• obscli에 /plan, /plan-approve, /plan-reject, /plan-revise, /plan-interrupt 명령이 추가되었으며 계획 상태 및 구조화된 상호작용 콘텐츠 표시를 지원합니다 (c69d29c, d65661d)
• obscli에 CLI에서 현재 작업의 권한 모드를 전환하기 위한 /permission-full 및 /permission-standard 명령이 추가되었습니다 (d65661d)

버그 수정¶

• obscli /tasks 및 /attach가 CLI로 생성된 작업으로 제한되지 않는 문제를 수정하여 CLI가 obscli로 생성되지 않은 세션에 실수로 연결되는 것을 방지합니다 (29faa63)
• obscli 시작 매개변수의 알 수 없는 하위 명령이 즉시 오류를 보고하지 않는 문제를 수정하여 잘못된 명령이 조용히 무시되는 것을 방지합니다 (5d9f923)
• 일부 응답 구조와 obscli 최근 기록 메시지 읽기의 비호환성 문제를 수정했습니다. content.messages 및 content.data에 대한 폴백 파싱을 추가했습니다 (5d9f923)
• bash의 원격 로그인 및 데이터베이스 클라이언트와 같은 고위험 명령이 런타임 승인 판단에 들어가지 않는 문제를 수정했습니다 (26edc7a)

최적화¶

• MCP 도구 노출 전략을 최적화했습니다: 기본적으로 안정적인 라우팅 도구만 노출됩니다. 소규모 툴셋 서버는 필요에 따라 직접 도구를 확장할 수 있으며, 대규모 툴셋 서버는 mcp_call_tool을 통해 계속 라우팅하여 도구 스키마 비대화를 줄입니다 (fcf17e3, 14aad95)
• Agent Prompt 및 프롬프트 캐시 구조를 최적화했습니다. MCP, Plan Mode, 권한 모드 및 세션 컨텍스트에 대한 규칙을 추가했습니다. 캐시 키 계산에 MCP 툴셋 버전을 포함했습니다 (41d0018, fcf17e3, c69d29c)
• query_session_events의 기본 기록 메시지 쿼리 수를 3에서 20으로 증가시켜 다중 턴 컨텍스트 복구 기능을 향상시켰습니다 (26edc7a)
• obscli 입력 경험을 최적화했습니다. 슬래시 명령 퍼지 매칭, 강조 표시, Ctrl+L 화면 지우기, 이중 Esc 취소, 통합된 명령 기록 및 더 깔끔한 시작 프롬프트를 지원합니다 (26edc7a, c69d29c)
• Agent 도구 실행 체인을 최적화했습니다. 복합 도구 실행자 및 실행 계획을 추상화하여 도구 정책, 스키마 검증, 승인, 복구 및 실제 실행 결정 처리를 통합했습니다 (fcf17e3, c69d29c)
• MCP Client, Plan Mode, obscli plan/permission, 프로필 동기화, 도구 실행 및 승인 흐름에 대한 테스트를 추가했습니다 (41d0018, fcf17e3, 14aad95, c69d29c, d65661d)

v0.1.4(2026/05/27)¶

이번 릴리스는 Agent Prompt 간소화 및 obscli 히스토리 메시지 표시 안정성에 중점을 두고 있습니다. 주요 업데이트는 다음과 같습니다:

버그 수정¶

• obscli가 시작 또는 재연결 후 이전 히스토리 응답을 동기화하여 현재 상호작용 영역이 이전 메시지로 덮어쓰여질 수 있는 문제를 수정했습니다 (6e05c87)
• obscli가 web_search_evidence와 같은 히스토리 이벤트의 원시 JSON을 상호작용 인터페이스에 출력할 수 있는 문제를 수정했습니다. 해당 이벤트는 문제 해결을 위해 obscli 로그에 여전히 보존됩니다 (6e05c87)

v0.1.3(2026/05/26)¶

이번 릴리스는 agent 런타임, obscli 표시, 설치/업그레이드 플로우 최적화에 중점을 두고 있습니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• Agent UI schema overlay가 이제 scripts/prepare.py 및 scripts/compile.py를 통해 구동됩니다. 런타임은 skill에 따라 overlay를 선택하고 agent-ui@1 draft 블록을 컴파일합니다 (5a1e699)
• submit_agent_ui_blocks가 overlay에서 제공하는 tool_input_schema 사용을 지원합니다. Agent는 draft 블록만 제출하며, 더 이상 overlay_id와 layout을 제출할 필요가 없습니다 (5a1e699)
• obs-agent에 런타임 기본 환경 변수 주석을 출력하는 --default-envs 매개변수가 추가되었습니다. 설치 스크립트에서 바이너리의 기본값을 직접 사용할 수 있습니다 (823c0bb)
• hidden/raw 추론 표시 모드를 지원하는 AGENT_REASONING_DISPLAY_MODE 설정이 추가되었으며, 기본값은 원시 추론 숨김입니다 (823c0bb)

버그 수정¶

• 도구 호출 실행 이벤트의 계층이 불명확한 문제를 수정했습니다: 사용자에게 표시되는 설명은 이제 metadata.commentary에 기록되며, 실행 이벤트의 content는 클라이언트 오독을 방지하기 위해 비어 있는 상태로 유지됩니다 (c2cb6e6, 823c0bb)
• Agent 업그레이드 시 agent.env에서 사용자가 커스터마이징한 활성 환경 변수가 유실될 수 있는 문제를 수정했습니다. 업그레이드 시 새 설정으로 덮어쓰이지 않는 이전 파일의 KEY=value 및 export KEY=value를 보존합니다 (823c0bb, 5a1e699)
• Task Insight 이벤트 귀속 문제를 수정하여, 인사이트가 응답 메시지 관계에 따라 영속화되고 게시되도록 했습니다 (5a1e699)

최적화¶

• obscli 사고 및 도구 호출 표시를 최적화했습니다. 긴 추론, 도구 설명, 출력 미리보기가 접힘/잘림 처리되어 터미널 노이즈가 감소합니다 (823c0bb)
• Prompt 규칙을 최적화했습니다. 최종 응답 언어는 사용자의 원래 작업을 기반으로 결정되며, 런타임 내부 정보(예: 부기, 복구 프롬프트, 도구 프로토콜)가 노출되지 않습니다 (823c0bb)
• Task Insight 제출 플로우를 최적화했습니다. 작업 중 단계별 사실, 행동, 가정, 결론을 여러 차례 제출할 수 있으며, 런타임 시간을 사용하여 타임스탬프를 생성합니다 (5a1e699)
• 수동 업그레이드 진입점을 조정했습니다. 문서에서는 이제 obs-agent-updater를 직접 사용하여 최신 또는 지정 버전 업그레이드를 트리거하도록 권장합니다 (5a1e699)
• Agent UI schema 스크립트, 설치/업그레이드, 도구 호출 이벤트, 추론 표시, Task Insight에 대한 테스트가 추가되었습니다 (c2cb6e6, 823c0bb, 5a1e699)

v0.1.2(2026/05/25)¶

이번 릴리스는 agent 및 obscli 최적화에 중점을 두고 있으며, Beak server에 대한 조정은 없습니다. 주요 업데이트는 다음과 같습니다:

새로운 기능¶

• Agent에 도구 호출 시각화 기능이 추가되어, CLI에서 도구 호출 이유, 배치 실행 상태, 출력 미리보기를 표시하며 Ctrl+T로 전체 도구 출력 토글을 지원합니다 (4bd18ed)
• Agent에 Prompt Cache 지원이 추가되었습니다. 시스템 프롬프트를 안정 접두사, 준안정 접두사, 동적 접미사로 분리합니다. OpenAI 호환 Provider에 대한 명시적 캐시 블록 전달 기능이 추가되었습니다 (c9274e7)
• query_session_events 도구에 최근 사용자 대화 및 도구 실행 이력에 대한 온디맨드 조회 기능이 추가되어, 기본 주입 컨텍스트 볼륨이 감소합니다 (c9274e7)
• obscli 세션 페이지에 작업, Agent, 입력/출력/캐시 Token, 잔여 컨텍스트 상태 표시가 추가되었습니다 (c9274e7)
• 캐시 계층화, 동적 컨텍스트, 도구 호출 규약을 설명하는 Agent Prompt 구조 및 예제 문서가 추가되었습니다 (c9274e7)

버그 수정¶

• Agent 설치 설정 API가 llm_max_tokens를 전달하지 않아 자체 호스팅 Agent 설치 시 최대 Token 설정이 올바르게 전달되지 않는 문제를 수정했습니다 (92e776d)
• 자체 호스팅 설치 스크립트에서 오류 인터페이스, HTML/JSON 응답, 빈 응답 등의 시나리오에 대한 프롬프트가 불명확한 문제를 수정했습니다. HTTP 상태, 응답 요약, env 파일 형식 유효성 검사가 추가되었습니다 (92e776d)

최적화¶

• /agents 및 /tasks 표시를 최적화했습니다. 원시 UUID를 숨기고 내부 숫자 선택 기능은 유지하여 CLI 가독성이 향상되었습니다 (c9274e7)
• Agent 최종 응답 언어 규칙을 최적화했습니다. 기본적으로 사용자의 최신 메시지 언어를 따르며, 원본 명령어, 코드 식별자, 고유명사는 보존합니다 (c9274e7)
• LLM 관측성 데이터를 최적화했습니다. Prompt Cached Tokens, 캐시 적중률, 컨텍스트 사용량이 로그 및 트레이스 속성에 추가되었습니다 (c9274e7)
• 도구 호출 이벤트 메타데이터를 최적화했습니다. 프론트엔드 및 CLI 통합 표시를 위한 배치 및 출력 요약 필드가 추가되었습니다 (4bd18ed)
• 자체 호스팅 설치 스크립트, Prompt 구성, 도구 호출 시각화, 설정 API에 대한 테스트가 추가되었습니다 (4bd18ed, 92e776d, c9274e7)