Pi 1.5.0 공식 릴리스: 도구 검증·세션 안정성과 스트리밍 개선
2026년 11월 2일 공개된 Pi 1.5.0은 터미널 응답을 다듬는 동시에 도구 인자 검증 방식을 바꿨습니다. 확장을 사용하는 팀은 기존 도구가 같은 입력을 계속 허용하는지 먼저 확인할 필요가 있습니다.
11월 3일 기준 공식 릴리스를 확인했습니다. 이전 Pi 0.80.3 기사 이후의 후속 소식이며, 여기서는 1.5.0의 변경에 집중합니다. 중간 버전 전체의 마이그레이션 가이드는 아닙니다.
공식 출처: Pi 1.5.0 공식 릴리스 노트
이번 릴리스의 중심 메시지
터미널의 반복 비용을 줄이되, 확장이 받아들이는 입력의 계약부터 다시 확인합니다.
이는 변경을 도입 순서로 묶은 이 글의 해석입니다. TypeBox의 추가 검증에 의존한 도구는 import가 유지돼도 런타임 동작이 같다고 볼 수 없습니다.
1. 사용자 기능 단위별 가치
| 기능 단위 | 주요 사용자 | 사용자가 느끼는 문제 | 업데이트 가치 | 사용자에게 와닿는 메시지 |
|---|---|---|---|---|
| 도구 인자 검증 · Breaking change | 확장·MCP 통합 개발자 | 스키마 밖의 제약에 의존한 도구가 있음 | JSON Schema 기준으로 검증 규칙 통일 | 업데이트 전에 입력 경계를 확인한다 |
| 세션 보존·명령 중단 | 긴 작업을 재개하는 사용자 | 저장 실패 뒤 기록 연결이 깨지거나 중단 뒤 다음 명령이 실행됨 | 세션 기록과 macOS 중단 경로 수정 | 실패 뒤의 동작까지 확인한다 |
| 스트리밍·렌더링 | 긴 코드와 큰 도구 호출을 읽는 사용자 | 출력 갱신 때 화면 작업이 반복됨 | 점진적 파싱과 렌더링 재사용 | 응답을 기다리며 읽는 흐름을 다듬는다 |
| 확장 변경 이력 | 여러 확장을 설치한 사용자 | 업데이트에서 무엇이 바뀌었는지 놓침 | 다음 새 실행에서 패키지 변경점 표시 | 확장 변화의 확인 지점을 얻는다 |
| 사용자 지정 업데이트 | wrapper·별도 패키지 관리자 사용자 | 설치 방식과 자체 업데이트가 맞지 않음 | 관리 명령을 업데이트에 연결 | 설치 경로에 맞게 갱신한다 |
| 모델 선택 변경 | OpenAI·Codex provider 사용자 | 기본값 변화로 이전 실행과 결과가 달라짐 | Sol 기본값과 Terra 지원 명시 | 모델을 기록해 실행을 비교한다 |
2. 가치 기준별 핵심 변화
A. 확장 호환성: import와 실행 검증을 구분
인자는 @earendil-works/pi-schema로 검증합니다.
표준 JSON Schema 형태의 TypeBox 스키마는 계속 사용할 수 있지만, Type.Refine()의 refinement와 Format.Set()의 사용자 형식은 적용되지 않습니다.
필요한 추가 제약은 도구의 execute()에서 검사해야 합니다.
일반 JSON Schema와 MCP 도구에도 숫자 문자열 변환, 단일 값의 배열 변환 같은 coercion이 적용됩니다. 유효·무효 입력을 대입하고, 검증 오류 문구에 의존한 클라이언트도 확인하세요. 오류 메시지 형식 역시 바뀌었습니다.
검증 범위: 공식 Extensions 문서
B. 읽기 흐름: 출력 갱신에 드는 작업 줄이기
큰 도구 호출은 점진적으로 파싱하고, 코드가 많은 답변과 도구 행은 highlighting과 렌더링된 Markdown을 재사용합니다. 발표에는 모든 환경에 적용되는 속도 배수가 없으므로 평소 길게 출력되는 작업에서 직접 비교하는 편이 좋습니다.
확장 자체의 렌더링도 중요합니다. 공식 TUI 문서는 너비·내용별로 비싼 작업을
캐시하고 invalidate()에서 갱신하도록 안내합니다.
좁은 터미널, 크기 변경, 넓은 문자와 테마 전환도 함께 살펴보세요.
렌더링 기준: 공식 TUI 문서
C. 업데이트 운영: 확장 이력과 갱신 명령 확인
확장 패키지는 pi.changelogPath 또는 루트 CHANGELOG.md로
변경 이력을 제공합니다. 업데이트 뒤 다음 새 실행에서 이전 확인 버전 이후의 내용을 보여주며, collapseChangelog로 표시를 접을 수 있습니다.
PI_SELF_UPDATE_COMMAND나 전역 selfUpdateCommand를
지정하면 pi update가 wrapper·패키지 관리자 명령을 사용합니다.
팀에서는 평소 설치에 쓰는 도구와 갱신 명령을 맞춰 두는 것이 평가할 지점입니다.
D. 모델과 신뢰 설정: 실행 조건을 함께 기록
기본 OpenAI 모델은 gpt-5.5에서 gpt-6.1-sol로 바뀝니다.
GPT-6.1 Terra도 OpenAI, Azure OpenAI Responses, OpenAI Codex에서 지원합니다.
모델 등록만으로 계정 접근 권한이나 일정한 비용이 보장되지는 않습니다.
저장한 Do not trust 결정이 특정 프로젝트에서 무시되던 문제도 수정됐습니다.
업데이트 후 모델 ID와 프로젝트 신뢰 상태를 확인하면, 결과 변화와 권한 상태를
같은 문제로 혼동할 가능성을 줄일 수 있습니다.
E. 실패 경로: 저장 기록과 중단한 명령의 후속 동작
세션 저장에 실패한 엔트리가 메모리에만 남으면 이후 기록이 존재하지 않는 부모를 참조하고, 재개 시 이전 기록과 도구가 누락될 수 있었습니다. 이번 수정은 저장 실패 때 메모리 추가도 되돌려 파일의 기록과 맞춥니다.
macOS에서 bash 명령을 중단했는데 같은 목록의 다음 명령이 실행되던 경우도 수정했습니다. 긴 작업을 맡기는 팀은 기록 저장·재개와 명령 중단을 기능 평가에 포함할 이유가 있습니다.
재현·수정 근거: 세션 기록 누락 · macOS 명령 중단
3. 사용자 세그먼트별 해석
확장 제작자
비표준 TypeBox 제약을 찾아 execute의 검증으로 옮길지 판단하세요. 정상 입력뿐 아니라 변환되는 입력과 거절해야 할 입력도 실행해 봅니다.
매일 TUI를 쓰는 개발자
평소 긴 출력의 읽기·스크롤 흐름을 비교하세요. 확장 업데이트 안내가 표시되는 새 실행도 확인합니다.
팀·통합 운영자
모델 ID, 설치 명령, 신뢰 설정과 중단·재개 결과를 기록하세요. 오래된 버전에서 올릴 때는 중간 릴리스의 변경도 별도로 검토해야 합니다.
4. 기능별 우선순위 평가
확장 호환성과 실행 재현성을 먼저 보는 이 글의 평가입니다. 확장을 직접 만들지 않는 사용자에게는 스트리밍 개선이 먼저 체감될 수 있습니다.
| 우선순위 | 기능 | 이유 |
|---|---|---|
| 1 | 도구 검증 호환성 | 입력 허용 범위가 달라질 수 있어 확장 실행 전에 확인 |
| 2 | 세션 보존·중단·신뢰 상태 | 실패 뒤의 기록과 후속 실행, 권한 판단에 영향 |
| 3 | 모델·업데이트 경로 | 실행 조건과 갱신 방법을 함께 확인 |
| 4 | 스트리밍·확장 이력 | 일상적인 읽기 흐름과 변경점 확인 개선 |
5. 한 줄 포지셔닝
Pi 1.5.0은 도구 검증과 실패 뒤의 세션·명령 동작을 다듬고, 터미널 읽기와 업데이트 관리를 개선하는 릴리스입니다.
검증 계약
TypeBox 추가 제약과 JSON Schema 검증의 차이 확인
작업 보존
저장 실패·명령 중단·재개 경로를 함께 점검
운영 기준
출력 재사용과 업데이트 명령·모델 설정 확인