@steercards/agent-tools 0.1.3 → 0.1.4

package/README.md

@@ -11,7 +11,7 @@ Steercards의 전체 MCP 도구를 CLI와 에이전트에서 사용할 수 있
 
 ## 일회용 프롬프트로 연결
 
-Steercards의 Agent 연결 화면에서 클라이언트·OS·Key 설정을 선택하고 설치 프롬프트를 복사해 사용할 프로젝트의 에이전트에게 전달하세요. 프롬프트에는 10분 동안 한 번 사용할 설치 코드가 들어갑니다. 설치기는 코드를 실제 Agent Key로 교환하여 현재 프로젝트의 `.env`에만 저장하고, `.gitignore` 보호·MCP 설정·Skill 설치와 읽기 전용 연결 검사를 수행합니다. 장기 키를 프롬프트에 붙여넣을 필요가 없습니다.
+Steercards의 Agent 연결 화면에서 Key 설정을 선택하고 설치 프롬프트를 복사해 사용할 프로젝트의 에이전트에게 전달하세요. 프롬프트에는 10분 동안 한 번 사용할 설치 코드가 들어갑니다. 에이전트는 실제 클라이언트·OS·프로젝트를 확인해 설치합니다. 설치기는 코드를 선택한 기존 Agent Key 또는 새로 발급한 Key로 교환하여 현재 프로젝트의 `.env`에만 저장하고, `.gitignore` 보호·MCP 설정·Skill 설치와 읽기 전용 연결 검사를 수행합니다. 기존 Key를 선택하면 같은 Key를 재사용하며 새 Key를 만들거나 기존 Key를 자동 폐기하지 않습니다. 장기 키를 프롬프트에 붙여넣을 필요가 없습니다.
 
 직접 실행하는 경우 아래 코드 자리를 앱에서 발급한 설치 코드로 바꿉니다. POSIX 셸 예시:
 
@@ -35,7 +35,7 @@ Windows PowerShell에서는 같은 코드를 here-string으로 전달합니다.
 
 `.env`가 Git에 추적되거나 파일·설정·Skill 충돌, symlink, 잠금·쓰기 문제가 있으면 교환 전에 중단합니다. `.gitignore`의 기존 negation 뒤에 보호 규칙을 보완합니다. `--dry-run`은 코드를 소비하거나 파일을 쓰지 않습니다.
 
-키 저장 뒤 MCP·Skill 설치나 연결 검사에 실패해도 `.env`를 보존합니다. 충돌을 정리하고 코드 옵션 없이 일반 setup과 `doctor --connect`를 다시 실행하세요. 교환 응답 유실이나 키 저장 실패는 코드가 소비되었을 수 있으므로 앱에서 새 코드를 발급하고 사용하지 않는 발급 키를 폐기합니다. 실패 복구를 위해 키 원문을 채팅·로그에 붙여넣지 마세요. Desktop의 Skill ZIP 업로드와 클라이언트 재연결은 아래 안내를 따릅니다.
+키 저장 뒤 MCP·Skill 설치나 연결 검사에 실패해도 `.env`를 보존합니다. 충돌을 정리하고 코드 옵션 없이 일반 setup과 `doctor --connect`를 다시 실행하세요. 교환 응답 유실이나 키 저장 실패에서는 코드를 다시 소비하지 말고 먼저 프로젝트 `.env`에 Key가 저장됐는지 확인합니다. 저장됐다면 그 Key를 보존하고 같은 복구 절차를 따릅니다. 저장되지 않았다면 웹에서 코드 상태와 선택한 Key를 확인하세요. 재사용한 기존 Key는 보존하고, 사용 가능한 같은 Key로 새 코드를 발급합니다. 선택한 Key가 만료·폐기됐거나 접근 권한이 바뀌었다면 상태·권한을 확인한 후 사용 가능한 Key를 선택합니다. 새로 발급한 Key만 실제로 사용하지 않는지 확인한 뒤 사용자가 명시적으로 폐기할 수 있으며, 설치 실패만으로 Key를 자동 폐기하거나 교체하지 않습니다. 실패 복구를 위해 키 원문을 채팅·로그에 붙여넣지 마세요. Desktop의 Skill ZIP 업로드와 클라이언트 재연결은 아래 안내를 따릅니다.
 
 ## 소스에서 설치
 

package/dist/setup-with-code.js

@@ -11,12 +11,18 @@ const errors = {
     AGENT_INSTALL_CODE_NOT_FOUND: 'Installation code was not found. Create a new code in Steercards.',
     AGENT_INSTALL_CODE_EXPIRED: 'Installation code expired. Create a new code in Steercards.',
     AGENT_INSTALL_CODE_REVOKED: 'Installation code was revoked. Create a new code in Steercards.',
-    AGENT_INSTALL_CODE_CONSUMED: 'Installation code was already used. Check the issued Agent Key in Steercards before creating a new code.',
+    AGENT_INSTALL_CODE_CONSUMED: 'Installation code was already used. Check the project .env and the selected Agent Key in Steercards. Do not redeem this code again.',
     AGENT_INSTALL_CODE_PROFILE_INVALID: 'The selected profiles are no longer available. Create a new installation code.',
     AGENT_INSTALL_CODE_OWNER_INVALID: 'The installation owner is no longer available. Sign in to Steercards and create a new code.',
+    AGENT_INSTALL_KEY_NOT_FOUND: 'The selected Agent Key is no longer available. Check the code and key selection in Steercards before creating a new code.',
+    AGENT_INSTALL_KEY_REVOKED: 'The selected Agent Key was revoked. Check its status in Steercards and select a usable key for a new code.',
+    AGENT_INSTALL_KEY_EXPIRED: 'The selected Agent Key expired. Check its status in Steercards and select a usable key for a new code.',
+    AGENT_INSTALL_KEY_ACCESS_CHANGED: 'The selected Agent Key access changed. Review its workspace and profiles in Steercards before creating a new code.',
+    AGENT_INSTALL_KEY_TOKEN_MISMATCH: 'The selected Agent Key could not be verified. Preserve existing keys and check the code and selected key in Steercards before creating a new code.',
+    AGENT_INSTALL_KEY_CAPSULE_INVALID: 'The installation code could not restore the selected Agent Key. Preserve existing keys and create a fresh code for the same usable key in Steercards.',
     RATE_LIMITED: 'Too many installation attempts. Wait before creating another request.',
 };
-const recovery = 'The code may have been consumed. Create a new code and remove any unused issued Agent Key in Steercards. Never paste the Agent Key into chat.';
+const recovery = 'The code may have been consumed. Do not replay it. First check whether the project .env contains the Agent Key; preserve any saved key and rerun setup without a code, then doctor --connect. Otherwise, check the code status and selected key in Steercards. Preserve reused keys and create a new code for the same usable key. Only revoke a newly issued key if you explicitly confirm it is unused. Never paste the Agent Key into chat.';
 async function boundedJson(response) {
     if (!response.headers.get('content-type')?.toLowerCase().includes('application/json')) {
         await response.body?.cancel();
@@ -150,7 +156,7 @@ export async function setupWithCode(options, dependencies = {}) {
                     await credentials.save(token);
                 }
                 catch {
-                    throw new Error(`The issued Agent Key could not be saved safely. ${recovery}`);
+                    throw new Error(`The Agent Key could not be saved safely. ${recovery}`);
                 }
                 report.credentials.status = 'saved';
             },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steercards/agent-tools",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Progressive MCP discovery, CLI and agent skills for Steercards",
   "type": "module",
   "license": "MIT",

package/skills/steercards/SKILL.md

@@ -11,7 +11,9 @@ Use the connected Steercards toolkit MCP or its `steercards` CLI. Authentication
 
 When the user provides a Steercards installation prompt, run its `setup --setup-code-stdin` command in the intended project with `--cwd . --env-file .env` and the prompt's explicit MCP `--url`. Pass the short-lived code through stdin. The installer exchanges it once, saves the Agent Key only in the project `.env`, protects Git ignore rules, installs MCP and this skill, and checks the connection. Report the safe installation summary; never print the resulting key or inspect the exchange body for chat output.
 
-An existing project key is kept without consuming the code. Replace it only when requested, using `--replace-agent-key`. Automatic credential writes support only the project root `.env`. Local configuration/skill conflicts or a tracked `.env` must be resolved before redeeming. If credentials were saved but installation or doctor failed, preserve `.env` and rerun normal setup/doctor without a code. After an uncertain exchange or failed key save, ask for a fresh app-generated prompt and direct the user to remove unused issued keys in Steercards; do not replay the code or request the long-lived key in chat. Client restart/reconnect and Desktop Skill ZIP upload may still be needed.
+An existing project key is kept without consuming the code. Replace it only when requested, using `--replace-agent-key`. A code may reuse the key selected in Steercards; this returns the same key without issuing or revoking one. Automatic credential writes support only the project root `.env`. Local configuration/skill conflicts or a tracked `.env` must be resolved before redeeming.
+
+If credentials were saved but installation or doctor failed, preserve `.env` and rerun normal setup/doctor without a code. After an uncertain exchange or failed key save, do not replay the code. First check whether the project `.env` contains the key without displaying its value; if saved, preserve it and recover with normal setup/doctor. Otherwise, check the code status and selected key in Steercards. Preserve reused keys and request a fresh app-generated prompt for the same usable key. If it is revoked, expired or its access changed, review its status and permissions before selecting a usable key. Only a newly issued key explicitly confirmed unused may be revoked by the user. Never automatically revoke or rotate a key because installation failed, or request the long-lived key in chat. Client restart/reconnect and Desktop Skill ZIP upload may still be needed.
 
 ## Discover only what the task needs