relayax-cli 0.3.41 → 0.3.43

package/dist/lib/config.d.ts

@@ -9,7 +9,7 @@ export declare const API_URL = "https://www.relayax.com";
 export declare function getInstallPath(override?: string): string;
 /** ~/.relay/ — 글로벌 (token, CLI cache) */
 export declare function ensureGlobalRelayDir(): void;
-/** cwd/.relay/ — 프로젝트 로컬 (installed.json, teams/) */
+/** cwd/.relay/ — 프로젝트 로컬 (installed.json, agents/) */
 export declare function ensureProjectRelayDir(): void;
 export interface TokenData {
     access_token: string;

package/dist/lib/config.js

@@ -49,7 +49,7 @@ function ensureGlobalRelayDir() {
         fs_1.default.mkdirSync(GLOBAL_RELAY_DIR, { recursive: true });
     }
 }
-/** cwd/.relay/ — 프로젝트 로컬 (installed.json, teams/) */
+/** cwd/.relay/ — 프로젝트 로컬 (installed.json, agents/) */
 function ensureProjectRelayDir() {
     const dir = path_1.default.join(process.cwd(), '.relay');
     if (!fs_1.default.existsSync(dir)) {
@@ -196,7 +196,7 @@ async function getValidToken() {
 }
 /**
  * 레거시 키 정규화:
- * - `@spaces/{slug}/{team}` → `@{slug}/{team}` (Space 레거시)
+ * - `@spaces/{slug}/{agent}` → `@{slug}/{agent}` (Space 레거시)
  * - `space_slug` → `org_slug` (필드명 마이그레이션)
  */
 function normalizeInstalledRegistry(raw) {

package/dist/lib/guide.js

@@ -1,108 +1,63 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateGuide = generateGuide;
+const index_js_1 = require("../prompts/index.js");
 function buildSetupSection(needsLogin) {
-    const installStep = `## Step 1. Relay CLI 설치
-
-relay CLI가 설치되어 있지 않다면:
-
-\`\`\`bash
-npm install -g relayax-cli
-\`\`\`
-
-Node.js가 없는 경우:
-- macOS: \`brew install node\`
-- Windows: \`winget install OpenJS.NodeJS.LTS\`
-- Linux: \`curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash && source ~/.bashrc && nvm install --lts\`
-
-npm 권한 오류 시:
-\`\`\`bash
-mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global'
-echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
-npm install -g relayax-cli
-\`\`\``;
     if (!needsLogin)
-        return installStep;
-    return `${installStep}
-
-## Step 2. 로그인
-
-\`\`\`bash
-relay login
-\`\`\`
-
-브라우저가 열리면 GitHub 또는 카카오 계정으로 로그인하세요.`;
+        return index_js_1.SETUP_CLI;
+    return `${index_js_1.SETUP_CLI}\n\n${index_js_1.SETUP_LOGIN}`;
 }
-function buildRequiresSection(requires) {
-    const sections = [];
+function buildRequiresSummary(requires) {
+    const lines = [];
     if (requires.cli && requires.cli.length > 0) {
-        sections.push('### CLI 도구 설치\n');
         for (const cli of requires.cli) {
-            const label = cli.required === false ? '(선택)' : '(필수)';
-            if (cli.install) {
-                sections.push(`- **${cli.name}** ${label}: \`${cli.install}\``);
-            }
-            else {
-                sections.push(`- **${cli.name}** ${label}: 설치 후 \`which ${cli.name}\`으로 확인`);
-            }
+            const label = cli.required === false ? '선택' : '필수';
+            lines.push(`- cli: **${cli.name}** (${label})${cli.install ? ` — \`${cli.install}\`` : ''}`);
         }
-        sections.push('');
     }
     if (requires.npm && requires.npm.length > 0) {
-        sections.push('### npm 패키지 설치\n');
-        sections.push('```bash');
         const pkgNames = requires.npm.map((p) => typeof p === 'string' ? p : p.name);
-        sections.push(`npm install ${pkgNames.join(' ')}`);
-        sections.push('```\n');
+        lines.push(`- npm: ${pkgNames.map((n) => `**${n}**`).join(', ')}`);
     }
     if (requires.env && requires.env.length > 0) {
-        sections.push('### 환경변수 설정\n');
-        sections.push('```bash');
         for (const env of requires.env) {
-            const label = env.required === false ? '# (선택)' : '# (필수)';
+            const label = env.required === false ? '선택' : '필수';
             const desc = env.description ? ` — ${env.description}` : '';
-            sections.push(`${env.name}=your_value_here  ${label}${desc}`);
+            lines.push(`- env: **${env.name}** (${label})${desc}`);
         }
-        sections.push('```\n');
     }
     if (requires.mcp && requires.mcp.length > 0) {
-        sections.push('### MCP 서버 설정\n');
         for (const mcp of requires.mcp) {
-            sections.push(`**${mcp.name}:**`);
-            if (mcp.package)
-                sections.push(`- 패키지: \`${mcp.package}\``);
-            if (mcp.config) {
-                sections.push(`- 실행: \`${mcp.config.command}${mcp.config.args ? ' ' + mcp.config.args.join(' ') : ''}\``);
-            }
-            if (mcp.env && mcp.env.length > 0) {
-                sections.push(`- 필요한 환경변수: ${mcp.env.map((e) => `\`${e}\``).join(', ')}`);
-            }
-            sections.push('');
+            const pkg = mcp.package ? ` — \`${mcp.package}\`` : '';
+            lines.push(`- mcp: **${mcp.name}**${pkg}`);
         }
     }
-    if (requires.teams && requires.teams.length > 0) {
-        sections.push('### 의존 팀 설치\n');
-        sections.push('```bash');
-        for (const team of requires.teams) {
-            sections.push(`relay install ${team}`);
+    if (requires.agents && requires.agents.length > 0) {
+        for (const agent of requires.agents) {
+            lines.push(`- agents: **${agent}**`);
         }
-        sections.push('```\n');
     }
     if (requires.permissions && requires.permissions.length > 0) {
-        sections.push('### 권한 설정\n');
-        sections.push('아래 도구 사용을 허용해야 합니다:\n');
-        for (const perm of requires.permissions) {
-            sections.push(`- \`${perm}\``);
-        }
-        sections.push('');
+        lines.push(`- permissions: ${requires.permissions.map((p) => `\`${p}\``).join(', ')}`);
     }
-    if (sections.length === 0)
+    return lines.join('\n');
+}
+function buildRequiresSection(requires) {
+    const summary = buildRequiresSummary(requires);
+    if (!summary)
         return '';
-    return '## Step 4. 환경 구성\n\n' + sections.join('\n');
+    return `## Step 4. 의존성 확인 및 설치
+
+이 에이전트는 아래 의존성이 필요합니다:
+
+${summary}
+
+${index_js_1.REQUIREMENTS_CHECK}
+`;
 }
 function generateGuide(config, commands, requires) {
     const scopedSlug = config.slug.startsWith('@') ? config.slug : `@${config.slug}`;
-    const needsLogin = config.visibility === 'private' || config.visibility === 'gated';
+    const needsLogin = config.visibility === 'internal' || config.visibility === 'private';
     const setupSection = buildSetupSection(needsLogin);
     const installStepNum = needsLogin ? 3 : 2;
     const requiresSection = requires ? buildRequiresSection(requires) : '';
@@ -125,20 +80,20 @@ ${commands.map((cmd) => `- \`/${cmd.name}\`: ${cmd.description}`).join('\n')}
 > ${config.description}
 
 이 가이드는 [RelayAX](https://relayax.com)에서 자동 생성되었습니다.
-아래 단계를 순서대로 실행하면 Agent 팀이 설치됩니다.
+아래 단계를 순서대로 실행하면 에이전트가 설치됩니다.
 
 ${setupSection}
 
-## Step ${installStepNum}. 팀 설치
+## Step ${installStepNum}. 에이전트 설치
 
 \`\`\`bash
 relay install ${scopedSlug}
 \`\`\`
 
-설치 후 Agent가 자동으로 의존성을 확인하고 환경을 구성합니다.
+설치 후 아래 의존성을 확인하고 환경을 구성합니다.
 
 ${requiresSectionFinal}${usageHint}---
-*출처: https://relayax.com — Agent Team Marketplace*
+*출처: https://relayax.com — Agent Marketplace*
 *설치: \`relay install ${scopedSlug}\`*
 `;
 }

package/dist/lib/installer.d.ts

@@ -1,5 +1,5 @@
-export declare function installTeam(extractedDir: string, installPath: string): string[];
-export declare function uninstallTeam(files: string[]): string[];
+export declare function installAgent(extractedDir: string, installPath: string): string[];
+export declare function uninstallAgent(files: string[]): string[];
 /**
  * 빈 상위 디렉토리를 boundary까지 정리한다.
  * 예: /home/.claude/skills/cardnews/ 가 비었으면 삭제, /home/.claude/skills/는 유지

package/dist/lib/installer.js

@@ -3,8 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.installTeam = installTeam;
-exports.uninstallTeam = uninstallTeam;
+exports.installAgent = installAgent;
+exports.uninstallAgent = uninstallAgent;
 exports.cleanEmptyParents = cleanEmptyParents;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -27,7 +27,7 @@ function copyDirRecursive(src, dest) {
     }
     return copiedFiles;
 }
-function installTeam(extractedDir, installPath) {
+function installAgent(extractedDir, installPath) {
     const installedFiles = [];
     for (const dir of COPY_DIRS) {
         const srcDir = path_1.default.join(extractedDir, dir);
@@ -36,7 +36,7 @@ function installTeam(extractedDir, installPath) {
     }
     return installedFiles;
 }
-function uninstallTeam(files) {
+function uninstallAgent(files) {
     const removed = [];
     for (const file of files) {
         try {

package/dist/lib/preamble.d.ts

@@ -9,14 +9,14 @@ export declare function generatePreambleScript(slug: string, apiUrl: string): st
  */
 export declare function generatePreamble(slug: string): string;
 /**
- * teamDir에 bin/relay-preamble.sh를 생성한다.
+ * agentDir에 bin/relay-preamble.sh를 생성한다.
  */
-export declare function generatePreambleBin(teamDir: string, slug: string, apiUrl: string): void;
+export declare function generatePreambleBin(agentDir: string, slug: string, apiUrl: string): void;
 /**
  * frontmatter(---...---) 뒤에 preamble을 삽입한다.
  */
 export declare function injectPreamble(filePath: string, slug: string): void;
 /**
- * 팀의 사용자 진입점 파일에 preamble을 주입한다.
+ * 에이전트의 사용자 진입점 파일에 preamble을 주입한다.
  */
-export declare function injectPreambleToTeam(teamDir: string, slug: string): number;
+export declare function injectPreambleToAgent(agentDir: string, slug: string): number;

package/dist/lib/preamble.js

@@ -7,7 +7,7 @@ exports.generatePreambleScript = generatePreambleScript;
 exports.generatePreamble = generatePreamble;
 exports.generatePreambleBin = generatePreambleBin;
 exports.injectPreamble = injectPreamble;
-exports.injectPreambleToTeam = injectPreambleToTeam;
+exports.injectPreambleToAgent = injectPreambleToAgent;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const PREAMBLE_START = '<!-- RELAY_PREAMBLE_START - DO NOT EDIT -->';
@@ -17,10 +17,10 @@ const PREAMBLE_END = '<!-- RELAY_PREAMBLE_END -->';
  * relay CLI가 있으면 사용, 없으면 curl fallback.
  */
 function generatePreambleScript(slug, apiUrl) {
-    // slug format: @owner/team → extract team slug for ping
+    // slug format: @owner/agent → extract agent slug for ping
     const stripped = slug.startsWith('@') ? slug.slice(1) : slug;
     const slashIdx = stripped.indexOf('/');
-    const teamSlug = slashIdx !== -1 ? stripped.slice(slashIdx + 1) : stripped;
+    const agentSlug = slashIdx !== -1 ? stripped.slice(slashIdx + 1) : stripped;
     return `#!/usr/bin/env bash
 # relay-preamble.sh — auto-generated by relay publish
 set +e
@@ -31,7 +31,7 @@ DEVICE_HASH=$(echo "$HOSTNAME:$USER" | shasum -a 256 | cut -d' ' -f1)
 if command -v relay &>/dev/null; then
   relay ping "${slug}" --quiet 2>/dev/null &
 else
-  curl -sf -X POST "${apiUrl}/api/teams/${teamSlug}/ping" \\
+  curl -sf -X POST "${apiUrl}/api/agents/${agentSlug}/ping" \\
     -H "Content-Type: application/json" \\
     -d "{\\"device_hash\\":\\"$DEVICE_HASH\\"}" \\
     2>/dev/null &
@@ -51,23 +51,23 @@ echo "RELAY_READY: ${slug}"
  * 단순히 relay ping을 호출한다.
  */
 function generatePreamble(slug) {
-    const teamPath = slug.startsWith('@') ? slug.slice(1) : slug;
+    const agentPath = slug.startsWith('@') ? slug.slice(1) : slug;
     return `${PREAMBLE_START}
 ## Preamble (run first)
 
 \`\`\`bash
-bash "$HOME/.relay/teams/${teamPath}/bin/relay-preamble.sh" 2>/dev/null || true
+bash "$HOME/.relay/agents/${agentPath}/bin/relay-preamble.sh" 2>/dev/null || true
 \`\`\`
 
 If output shows \`CLI_UPGRADE_AVAILABLE <old> <new>\`: tell user "relay v{new} available. Run: npm update -g relayax-cli"
-If output shows \`TEAM_UPGRADE_AVAILABLE\`: tell user "${slug} v{new} available (by @{author}). Run: relay update ${slug}"
+If output shows \`AGENT_UPGRADE_AVAILABLE\`: tell user "${slug} v{new} available (by @{author}). Run: relay update ${slug}"
 ${PREAMBLE_END}`;
 }
 /**
- * teamDir에 bin/relay-preamble.sh를 생성한다.
+ * agentDir에 bin/relay-preamble.sh를 생성한다.
  */
-function generatePreambleBin(teamDir, slug, apiUrl) {
-    const binDir = path_1.default.join(teamDir, 'bin');
+function generatePreambleBin(agentDir, slug, apiUrl) {
+    const binDir = path_1.default.join(agentDir, 'bin');
     if (!fs_1.default.existsSync(binDir)) {
         fs_1.default.mkdirSync(binDir, { recursive: true });
     }
@@ -106,12 +106,12 @@ function injectPreamble(filePath, slug) {
     fs_1.default.writeFileSync(filePath, cleaned);
 }
 /**
- * 팀의 사용자 진입점 파일에 preamble을 주입한다.
+ * 에이전트의 사용자 진입점 파일에 preamble을 주입한다.
  */
-function injectPreambleToTeam(teamDir, slug) {
+function injectPreambleToAgent(agentDir, slug) {
     let count = 0;
     // 1. user-invocable 서브 스킬 SKILL.md
-    const skillsDir = path_1.default.join(teamDir, 'skills');
+    const skillsDir = path_1.default.join(agentDir, 'skills');
     if (fs_1.default.existsSync(skillsDir)) {
         function walkSkills(dir) {
             for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
@@ -131,7 +131,7 @@ function injectPreambleToTeam(teamDir, slug) {
         walkSkills(skillsDir);
     }
     // 2. commands/*.md
-    const commandsDir = path_1.default.join(teamDir, 'commands');
+    const commandsDir = path_1.default.join(agentDir, 'commands');
     if (fs_1.default.existsSync(commandsDir)) {
         for (const entry of fs_1.default.readdirSync(commandsDir, { withFileTypes: true })) {
             if (!entry.isFile() || !entry.name.endsWith('.md'))

package/dist/lib/slug.d.ts

@@ -3,6 +3,11 @@ export interface ParsedSlug {
     name: string;
     full: string;
 }
+/**
+ * 임의의 문자열을 slug로 변환한다.
+ * 한글은 로마자로 변환된다 (예: "콘텐츠 에이전트" → "kontencheu-eijenteu").
+ */
+export declare function slugify(input: string): string;
 /**
  * Scoped slug(`@owner/name`)를 동기적으로 파싱한다.
  * 단순 slug는 파싱할 수 없으므로 null을 반환한다.

package/dist/lib/slug.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugify = slugify;
 exports.parseSlug = parseSlug;
 exports.isScopedSlug = isScopedSlug;
 exports.isSimpleSlug = isSimpleSlug;
@@ -7,6 +8,52 @@ exports.resolveSlug = resolveSlug;
 const api_js_1 = require("./api.js");
 const SCOPED_SLUG_RE = /^@([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)\/([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)$/;
 const SIMPLE_SLUG_RE = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+// ── 한글 로마자 변환 (Revised Romanization) ──
+const INITIALS = [
+    'g', 'kk', 'n', 'd', 'tt', 'r', 'm', 'b', 'pp',
+    's', 'ss', '', 'j', 'jj', 'ch', 'k', 't', 'p', 'h',
+];
+const MEDIALS = [
+    'a', 'ae', 'ya', 'yae', 'eo', 'e', 'yeo', 'ye', 'o',
+    'wa', 'wae', 'oe', 'yo', 'u', 'wo', 'we', 'wi', 'yu',
+    'eu', 'ui', 'i',
+];
+const FINALS = [
+    '', 'k', 'k', 'k', 'n', 'n', 'n', 't', 'l',
+    'l', 'l', 'l', 'l', 'l', 'l', 'l', 'm', 'p',
+    'p', 't', 't', 'ng', 't', 't', 'k', 't', 'p', 't',
+];
+const HANGUL_BASE = 0xAC00;
+function romanize(input) {
+    let result = '';
+    for (const ch of input) {
+        const code = ch.codePointAt(0);
+        if (code >= HANGUL_BASE && code < HANGUL_BASE + 11172) {
+            const offset = code - HANGUL_BASE;
+            const initial = Math.floor(offset / (21 * 28));
+            const medial = Math.floor((offset % (21 * 28)) / 28);
+            const final = offset % 28;
+            result += INITIALS[initial] + MEDIALS[medial] + FINALS[final];
+        }
+        else {
+            result += ch;
+        }
+    }
+    return result;
+}
+/**
+ * 임의의 문자열을 slug로 변환한다.
+ * 한글은 로마자로 변환된다 (예: "콘텐츠 에이전트" → "kontencheu-eijenteu").
+ */
+function slugify(input) {
+    return romanize(input)
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .slice(0, 50);
+}
 /**
  * Scoped slug(`@owner/name`)를 동기적으로 파싱한다.
  * 단순 slug는 파싱할 수 없으므로 null을 반환한다.
@@ -41,7 +88,7 @@ async function resolveSlug(input) {
     // 서버에 resolve 요청
     const results = await (0, api_js_1.resolveSlugFromServer)(input);
     if (results.length === 0) {
-        throw new Error(`'${input}' 팀을 찾을 수 없습니다.`);
+        throw new Error(`'${input}' 에이전트를 찾을 수 없습니다.`);
     }
     if (results.length === 1) {
         const r = results[0];
@@ -49,5 +96,5 @@ async function resolveSlug(input) {
     }
     // 여러 개 매칭
     const list = results.map((r) => `  ${r.full}`).join('\n');
-    throw new Error(`'${input}'에 해당하는 팀이 여러 개입니다. 전체 slug를 지정해주세요:\n${list}`);
+    throw new Error(`'${input}'에 해당하는 에이전트가 여러 개입니다. 전체 slug를 지정해주세요:\n${list}`);
 }

package/dist/lib/update-cache.js

@@ -31,7 +31,7 @@ function isCacheValid(key, force) {
     if (force)
         return false;
     const cache = loadCache();
-    const timestamp = key === 'cli' ? cache.cli : cache.teams?.[key];
+    const timestamp = key === 'cli' ? cache.cli : cache.agents?.[key];
     if (!timestamp)
         return false;
     return Date.now() - new Date(timestamp).getTime() < CACHE_TTL_MS;
@@ -43,9 +43,9 @@ function updateCacheTimestamp(key) {
         cache.cli = now;
     }
     else {
-        if (!cache.teams)
-            cache.teams = {};
-        cache.teams[key] = now;
+        if (!cache.agents)
+            cache.agents = {};
+        cache.agents[key] = now;
     }
     saveCache(cache);
 }

package/dist/lib/version-check.d.ts

@@ -1,10 +1,10 @@
 export interface UpdateResult {
-    type: 'cli' | 'team';
+    type: 'cli' | 'agent';
     slug?: string;
     current: string;
     latest: string;
     author?: string;
 }
 export declare function checkCliVersion(force?: boolean): Promise<UpdateResult | null>;
-export declare function checkTeamVersion(slug: string, force?: boolean): Promise<UpdateResult | null>;
-export declare function checkAllTeams(force?: boolean): Promise<UpdateResult[]>;
+export declare function checkAgentVersion(slug: string, force?: boolean): Promise<UpdateResult | null>;
+export declare function checkAllAgents(force?: boolean): Promise<UpdateResult[]>;

package/dist/lib/version-check.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkCliVersion = checkCliVersion;
-exports.checkTeamVersion = checkTeamVersion;
-exports.checkAllTeams = checkAllTeams;
+exports.checkAgentVersion = checkAgentVersion;
+exports.checkAllAgents = checkAllAgents;
 const config_js_1 = require("./config.js");
 const api_js_1 = require("./api.js");
 const update_cache_js_1 = require("./update-cache.js");
@@ -28,7 +28,7 @@ async function checkCliVersion(force) {
     }
     return null;
 }
-async function checkTeamVersion(slug, force) {
+async function checkAgentVersion(slug, force) {
     if ((0, update_cache_js_1.isCacheValid)(slug, force))
         return null;
     try {
@@ -40,20 +40,20 @@ async function checkTeamVersion(slug, force) {
         if (entry.type === 'system') {
             return null;
         }
-        const team = await (0, api_js_1.fetchTeamInfo)(slug);
+        const agent = await (0, api_js_1.fetchAgentInfo)(slug);
         (0, update_cache_js_1.updateCacheTimestamp)(slug);
         // Fire-and-forget usage ping (only when cache expired = actual API call happened)
-        const teamId = entry.team_id ?? team.id;
-        if (teamId) {
-            (0, api_js_1.sendUsagePing)(teamId, slug, entry.version);
+        const agentId = entry.agent_id ?? agent.id;
+        if (agentId) {
+            (0, api_js_1.sendUsagePing)(agentId, slug, entry.version);
         }
-        if (team.version !== entry.version) {
+        if (agent.version !== entry.version) {
             return {
-                type: 'team',
+                type: 'agent',
                 slug,
                 current: entry.version,
-                latest: team.version,
-                author: team.author?.username,
+                latest: agent.version,
+                author: agent.author?.username,
             };
         }
     }
@@ -62,12 +62,12 @@ async function checkTeamVersion(slug, force) {
     }
     return null;
 }
-async function checkAllTeams(force) {
+async function checkAllAgents(force) {
     const installed = (0, config_js_1.loadInstalled)();
     const slugs = Object.keys(installed);
     const results = [];
     for (const slug of slugs) {
-        const result = await checkTeamVersion(slug, force);
+        const result = await checkAgentVersion(slug, force);
         if (result)
             results.push(result);
     }

package/dist/prompts/_business-card.md

@@ -0,0 +1,41 @@
+### 빌더 명함 표시
+JSON 결과의 `author`, `welcome` 필드를 사용하여 명함을 표시합니다.
+불릿 리스트(- 또는 *)로 나열하지 마세요. 반드시 인용 블록(>) 안에 넣어야 합니다.
+
+**JSON 결과에서 사용할 필드:**
+- `author.display_name` 또는 `author.username` → 명함 제목
+- `welcome` → 환영 메시지 (💬)
+- `author.contact_links` → 연락처 배열 (`[{type, label, value}]`)
+- `author.username` → 프로필 링크 (👤)
+
+**예시 (이 형태를 그대로 따르세요):**
+
+JSON 결과 예시:
+```json
+{
+  "author": { "username": "alice", "display_name": "Alice Kim", "contact_links": [
+    {"type": "email", "label": "이메일", "value": "alice@example.com"},
+    {"type": "website", "label": "블로그", "value": "https://alice.dev"},
+    {"type": "kakao", "label": "카카오", "value": "https://open.kakao.com/o/abc123"}
+  ]},
+  "welcome": "안녕하세요!\n에이전트 빌더 Alice입니다.\n설치해주셔서 감사합니다."
+}
+```
+
+출력:
+
+> **🪪 Alice Kim의 명함**
+>
+> 💬 "안녕하세요!
+> 에이전트 빌더 Alice입니다.
+> 설치해주셔서 감사합니다."
+>
+> 📧 alice@example.com
+> 🔗 블로그: alice.dev
+> 💬 카카오: open.kakao.com/o/abc123
+> 👤 relayax.com/@alice
+
+- `welcome`이 없으면 💬 줄을 생략합니다.
+- 연락처의 type에 맞는 이모지: 📧 email, 💬 kakao, 🐦 x, 💼 linkedin, 💻 github, 🔗 website/custom
+- 연락처가 여러 개면 각각 한 줄씩 표시합니다.
+- `author`가 null이면 명함 블록 전체를 생략합니다.

package/dist/prompts/_error-handling.md

@@ -0,0 +1,38 @@
+### 에러 처리 가이드
+
+CLI 명령 실행 후 JSON 에러가 반환되면 아래 기준에 따라 처리합니다.
+**원칙: "되돌릴 수 없는 영향이 있는가?"로 판단합니다.**
+
+#### 1. 자동 해결 (사용자에게 물어보지 않음)
+되돌릴 수 있고, 부작용 없는 에러:
+
+| 에러 코드 | 행동 |
+|-----------|------|
+| `LOGIN_REQUIRED` / `NO_TOKEN` | `relay login` 실행 (timeout 300초, 브라우저 자동 열림) → 성공 후 원래 명령 재시도 |
+| `NOT_INITIALIZED` | `relay init --all --json` 실행 → 원래 명령 재시도 |
+| `FETCH_FAILED` | 3초 대기 후 원래 명령 재시도 (최대 2회). 2회 실패 시 사용자에게 안내 |
+
+#### 2. 사용자에게 선택지 제시 (사용자 질문 도구)
+`options` 필드가 있는 에러:
+
+| 에러 코드 | 행동 |
+|-----------|------|
+| `MISSING_VISIBILITY` | options의 label을 선택지로 사용자 질문 도구 호출 |
+| `MISSING_FIELD` | fix 안내 + 사용자에게 값 입력 요청 |
+| `MISSING_TOOLS` | options의 감지된 도구 목록을 선택지로 사용자 질문 도구 호출 |
+| `MISSING_SPACE` | options의 Space 목록을 선택지로 사용자 질문 도구 호출 |
+
+사용자가 선택하면, 선택된 값을 CLI 플래그에 반영하여 명령을 재호출합니다.
+
+#### 3. 사용자에게 안내 (되돌릴 수 없는 에러)
+구매, 접근 권한, 보안 관련:
+
+| 에러 코드 | 행동 |
+|-----------|------|
+| `GATED_ACCESS_REQUIRED` | purchase_info의 message/url 표시 → "접근 코드가 있으신가요?" 사용자 질문 도구 호출 |
+| `SPACE_ONLY` | Space 가입 필요 안내 → "초대 코드가 있으신가요?" 사용자 질문 도구 호출 |
+| `APPROVAL_REQUIRED` | 승인 대기 안내 |
+| `NO_ACCESS` | 접근 방법 안내 |
+
+#### 4. 그 외 에러
+`fix` 필드의 메시지를 사용자에게 전달하고, 필요하면 다음 행동을 제안합니다.