aipctl 2026.10.3 → 2026.10.5

package/README.md

@@ -23,6 +23,51 @@ aipctl org select
 ```
 
 설정과 credentials 경로는 기존 `~/.config/aip`를 유지합니다.
+로그아웃하거나 App URL을 변경하면 대기 중인 로그인·갱신·조직 선택 결과는 저장되지 않습니다.
+환경 변경 뒤에는 다시 로그인합니다. `CLI_AUTH_SESSION_CHANGED`가 나오면 `auth status`와
+`config status`를 확인한 뒤 명령을 다시 실행합니다.
+
+## 목록과 삭제
+
+```bash
+aipctl skill list --count 50 --json-page
+aipctl skill list --cursor <nextCursor> --count 50 --json-page
+aipctl skill library --count 50 --json-page
+aipctl skill built-in --limit 50 --json-page
+aipctl admin skill list --page 1 --page-size 20 --json-page
+aipctl chat list --cursor <nextCursor> --json-page
+aipctl drive list --parent-id <folder-id> --count 200 --json-page
+aipctl skill delete <skill-id> --force
+```
+
+목록은 한 페이지씩 조회합니다. Skill list/library·Drive는 `--count 1..200`과 `--cursor`,
+Skill built-in과 admin skill built-in은 `--limit 1..100`과 `--cursor`, Chat은 `--cursor`를
+지원합니다. `--json-page`는 항목과 `nextCursor`를 함께 반환합니다. Admin skill list는
+`--page`/`--page-size`와 `pagination`을 사용합니다. 기존 Skill·Chat·admin Skill `--json` 배열
+형식은 유지하며 다음 페이지가 있으면 stderr에 안내합니다.
+다음 페이지에도 같은 조직·검색·폴더 조건을 사용합니다. 자동 전체 수집은 하지 않습니다.
+
+삭제·멤버 제거·조직 탈퇴는 `--force` 또는 `-f`로 확인해야 실행됩니다. 확인이 없으면
+`CLI_CONFIRMATION_REQUIRED`와 exit 1로 종료하며 요청을 전송하지 않습니다.
+
+## 본인 CLI 한도 확인
+
+```bash
+aipctl quota status
+aipctl quota status --org <slug> --json
+```
+
+선택한 조직에서 본인에게 적용되는 요청 한도, 조직 공유 한도, 정책 버전과 UTC 일일 text
+admission 사용량·활성/미확정 실행 수를 조회합니다. 업무 한도를 소진해도 별도로 제한된 진단
+요청은 가능합니다. 조회는 실행 용량을 예약하지 않으며 미확정 실행의 슬롯을 반환하지 않습니다.
+사용량 조회에 실패하면 `usage.status`는 `UNAVAILABLE`이고 사용량과 reset 필드는 `null`입니다.
+정책 버전이 `null`이면 해당 override 없이 기본값을 상속합니다.
+
+API 실패 시 `--json`은 stderr에 `{ "error": { "code", "message", ... } }` 한 건을 출력하고
+exit 1로 종료합니다. 일반 요청은 로컬 대기부터 응답 본문 처리까지 120초·8 MiB로 제한합니다.
+변경 요청이 전송된 뒤 timeout이나 응답 유실이 생기면 `outcome: "unknown"`이므로 대상 상태를
+조회한 뒤 다음 행동을 결정합니다. CLI는 변경·유료 실행을 자동 재실행하지 않습니다. Ctrl+C는
+exit 130으로 종료하며 서버의 작업 취소나 rollback을 보장하지 않습니다.
 
 ## MCP native commands
 
@@ -34,29 +79,29 @@ aipctl tunnel link <token>
 
 `install`, `run`, `tunnel`, `logs`는 Go native binary로 lazy dispatch됩니다. `prod` build에서는 `logs` command가 help와 command tree에서 제외됩니다.
 
-## Experimental model execution
+## 모델 조회와 개발 환경 기능
 
-`aipctl model-exec`은 CLI 전용 one-shot 모델 실행 namespace입니다. Conversation을 만들지 않고, 사용자가 선택한 모델을 한 번 호출해 stdout 또는 파일로 결과를 받습니다.
+production에서는 모델 목록·상세·입력 예시를 조회할 수 있습니다. 지원 범위는 release manifest와
+해당 artifact의 `--help`를 기준으로 확인합니다. 구현 여부와 고객 공개 여부는 별개입니다.
 
 ```bash
 aipctl model-exec models [--type chat|image-generation] [--json]
 aipctl model-exec get <model-id> [--json]
 aipctl model-exec sample <model-id> [--save input.json]
-aipctl model-exec chat --model <chat-model-id> -m "hello" [--json]
-aipctl model-exec image generate --model <image-model-id> --prompt "cat" --output ./cat.png [--json]
 ```
 
-대화형 터미널에서는 `model-exec chat`과 `model-exec image generate`가 완료될 때까지 spinner와 경과 시간을 stderr에 표시합니다. JSON을 포함한 최종 결과는 기존처럼 stdout에만 출력됩니다.
-
-`model-exec image generate`의 이미지 생성 요청 timeout은 최대 5분입니다. 5분 안에 provider 응답이 완료되지 않으면 명령은 실패하며, 이 제한은 one-shot image-generation 요청에만 적용됩니다. `aipctl model-exec image generate --help`와 실행 중 spinner에서도 제한을 확인할 수 있습니다.
-
-Conversation을 유지하는 일반 채팅은 `chat send`를 사용합니다.
+`model-exec chat`, `agent chat`, `chat send`, transfer/export, 외부 실행·credential 회전 후보는
+production에서 비공개입니다. 개발 artifact(`npx aipctl@dev`)와 설정된 개발 App URL, 해당
+서버의 인증·release·quota gate가 모두 충족되어야 시험할 수 있습니다. 개발 artifact만 설치해도
+서버 차단을 통과하는 것은 아닙니다. 아래 예시는 text 실행 gate를 연 개발 환경에만 적용됩니다.
 
 ```bash
-aipctl chat send -m "hello" --json
-aipctl chat send --conversation <conversation-id> -m "continue" --json
+npx aipctl@dev model-exec chat --model <chat-model-id> -m "hello" --json
+npx aipctl@dev chat send -m "hello" --json
 ```
 
+이미지 생성·비동기 job은 이번 스프린트에서 공개하거나 검증하지 않습니다.
+
 ## Development
 
 ```bash