relayax-cli 0.4.16 → 0.4.18

package/dist/commands/install.js

@@ -132,13 +132,13 @@ function registerInstall(program) {
                             }
                             process.exit(1);
                         }
-                        const claimRes = await fetch(`${config_js_1.API_URL}/api/agents/${slug}/claim-access`, {
+                        const claimRes = await fetch(`${config_js_1.API_URL}/api/agents/${parsed.name}/claim-access`, {
                             method: 'POST',
                             headers: {
                                 'Content-Type': 'application/json',
                                 Authorization: `Bearer ${token}`,
                             },
-                            body: JSON.stringify({ code: _opts.code }),
+                            body: JSON.stringify({ code: _opts.code, owner: parsed.owner }),
                             signal: AbortSignal.timeout(10000),
                         });
                         if (!claimRes.ok) {
@@ -240,38 +240,33 @@ function registerInstall(program) {
                     process.exit(1);
                 }
             }
-            // 3. Download package: prefer git clone, fallback to tar.gz
+            // 3. Download package via git clone
             const requestedVersion = versionMatch ? versionMatch[2] : undefined;
-            if (resolvedAgent.git_url) {
-                // Git clone path
-                (0, git_operations_js_1.checkGitInstalled)();
-                const gitUrl = (0, git_operations_js_1.buildGitUrl)(resolvedAgent.git_url, { code: _opts.code });
-                await (0, storage_js_1.clonePackage)(gitUrl, agentDir, requestedVersion);
-            }
-            else {
-                // Legacy tar.gz path (retry once if signed URL expired)
-                let tarPath;
-                try {
-                    tarPath = await (0, storage_js_1.downloadPackage)(resolvedAgent.package_url, tempDir);
+            if (!resolvedAgent.git_url) {
+                const errMsg = '이 에이전트는 재publish가 필요합니다. 빌더에게 문의하세요.';
+                if (json) {
+                    console.log(JSON.stringify({ error: 'NO_GIT_URL', message: errMsg }));
                 }
-                catch (dlErr) {
-                    const dlMsg = dlErr instanceof Error ? dlErr.message : String(dlErr);
-                    if (dlMsg.includes('403') || dlMsg.includes('expired')) {
-                        if (!json) {
-                            console.error('\x1b[33m⚙ 다운로드 URL 만료, 재시도 중...\x1b[0m');
-                        }
-                        resolvedAgent = await (0, api_js_1.fetchAgentInfo)(slug);
-                        tarPath = await (0, storage_js_1.downloadPackage)(resolvedAgent.package_url, tempDir);
-                    }
-                    else {
-                        throw dlErr;
-                    }
+                else {
+                    console.error(`\x1b[31m✖ ${errMsg}\x1b[0m`);
                 }
-                if (fs_1.default.existsSync(agentDir)) {
-                    fs_1.default.rmSync(agentDir, { recursive: true, force: true });
+                process.exit(1);
+            }
+            (0, git_operations_js_1.checkGitInstalled)();
+            const gitUrl = (0, git_operations_js_1.buildGitUrl)(resolvedAgent.git_url, { code: _opts.code });
+            await (0, storage_js_1.clonePackage)(gitUrl, agentDir, requestedVersion);
+            // Verify clone has actual files (not just .git)
+            const clonedEntries = fs_1.default.readdirSync(agentDir).filter((f) => f !== '.git');
+            if (clonedEntries.length === 0) {
+                fs_1.default.rmSync(agentDir, { recursive: true, force: true });
+                const errMsg = '에이전트 패키지가 비어있습니다. 빌더에게 재publish를 요청하세요.';
+                if (json) {
+                    console.log(JSON.stringify({ error: 'EMPTY_PACKAGE', message: errMsg }));
+                }
+                else {
+                    console.error(`\x1b[31m✖ ${errMsg}\x1b[0m`);
                 }
-                fs_1.default.mkdirSync(agentDir, { recursive: true });
-                await (0, storage_js_1.extractPackage)(tarPath, agentDir);
+                process.exit(1);
             }
             // 4.5. Inject preamble (update check) into SKILL.md and commands
             (0, preamble_js_1.injectPreambleToAgent)(agentDir, slug);

package/dist/commands/publish.d.ts

@@ -80,6 +80,7 @@ interface PublishResult {
     slug: string;
     version: string;
     url: string;
+    access_code?: string | null;
     profile?: {
         username?: string;
         display_name?: string;

package/dist/commands/publish.js

@@ -746,13 +746,13 @@ function registerPublish(program) {
                 console.error(`업로드 중...`);
             }
             const result = await publishToApi(token, tarPath, metadata);
-            // Git push: commit and push to git server (non-fatal if git server unavailable)
-            try {
-                const gitUrl = result.git_url;
-                if (gitUrl) {
-                    if (!json) {
-                        console.error('git 저장소에 푸시 중...');
-                    }
+            // Git push: commit and push to git server (required)
+            const gitUrl = result.git_url;
+            if (gitUrl) {
+                if (!json) {
+                    console.error('git 저장소에 푸시 중...');
+                }
+                try {
                     const isFirstPublish = !result.is_update;
                     if (isFirstPublish) {
                         await (0, git_operations_js_1.gitPublishInit)(relayDir, gitUrl, config.version);
@@ -761,12 +761,16 @@ function registerPublish(program) {
                         await (0, git_operations_js_1.gitPublishUpdate)(relayDir, gitUrl, config.version);
                     }
                 }
-            }
-            catch (gitPushErr) {
-                // Git push failure is non-fatal — tar.gz upload already succeeded
-                if (!json) {
+                catch (gitPushErr) {
                     const gpMsg = gitPushErr instanceof Error ? gitPushErr.message : String(gitPushErr);
-                    console.error(`\x1b[33m⚠ git push 실패 (배포는 완료됨): ${gpMsg}\x1b[0m`);
+                    if (json) {
+                        console.log(JSON.stringify({ error: 'GIT_PUSH_FAILED', message: `git push 실패: ${gpMsg}` }));
+                    }
+                    else {
+                        console.error(`\x1b[31m✖ git push 실패: ${gpMsg}\x1b[0m`);
+                        console.error('\x1b[33m  재시도하려면 relay publish를 다시 실행하세요.\x1b[0m');
+                    }
+                    process.exit(1);
                 }
             }
             // Update entry command preamble with scoped slug from server (non-fatal)
@@ -784,15 +788,7 @@ function registerPublish(program) {
                 // preamble update is best-effort — publish already succeeded
             }
             if (json) {
-                // Enrich JSON output with plugin_url if git_url available
                 const jsonResult = { ...result };
-                const resultGitUrl = jsonResult.git_url;
-                if (resultGitUrl) {
-                    const pSlug = jsonResult.slug.startsWith('@') ? jsonResult.slug.slice(1) : jsonResult.slug;
-                    const pName = pSlug.includes('/') ? pSlug.split('/')[1] : pSlug;
-                    jsonResult.plugin_url = `${config_js_1.API_URL}/api/registry/${pSlug}/plugin`;
-                    jsonResult.plugin_install_cmd = `/plugin install ${pName}`;
-                }
                 jsonResult.platforms = generatedPlatforms;
                 console.log(JSON.stringify(jsonResult));
             }
@@ -803,50 +799,35 @@ function registerPublish(program) {
                 // Build share block
                 {
                     const detailSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;
-                    const accessCode = result.access_code;
-                    const gitUrl = result.git_url;
-                    // CLI install command
+                    const accessCode = result.access_code ?? null;
+                    // const gitUrl = (result as unknown as Record<string, unknown>).git_url as string | undefined // plugin disabled
+                    // npx turnkey install command (works everywhere, no pre-install needed)
                     const visibility = config.visibility ?? 'public';
-                    let installCmd;
+                    let npxInstallCmd;
                     if (visibility === 'internal' && accessCode) {
-                        installCmd = `npx relayax-cli install ${result.slug} --join-code ${accessCode}`;
+                        npxInstallCmd = `npx relayax-cli install ${result.slug} --join-code ${accessCode}`;
                     }
                     else if (visibility === 'private' && accessCode) {
-                        installCmd = `npx relayax-cli install ${result.slug} --code ${accessCode}`;
+                        npxInstallCmd = `npx relayax-cli install ${result.slug} --code ${accessCode}`;
                     }
                     else {
-                        installCmd = `npx relayax-cli install ${result.slug}`;
+                        npxInstallCmd = `npx relayax-cli install ${result.slug}`;
                     }
-                    // Plugin install commands (marketplace add + plugin install)
-                    const pluginSlug = detailSlug.includes('/') ? detailSlug.split('/')[1] : detailSlug;
-                    const pluginUrl = gitUrl ? `${config_js_1.API_URL}/api/registry/${detailSlug}/plugin` : null;
-                    // ── CLI 설치 (복사용) ──
-                    console.log(`\n  \x1b[1m▸ CLI 설치\x1b[0m`);
+                    // ── 설치 방법 (터미널 출력) ──
+                    console.log(`\n  \x1b[1m설치 방법\x1b[0m  \x1b[90m(Claude Code, Cursor, Codex 등 모든 에이전트)\x1b[0m`);
                     console.log(`  ┌─`);
-                    console.log(`  │ ${installCmd}`);
+                    console.log(`  │ ${npxInstallCmd}`);
                     console.log(`  └─`);
-                    // ── Claude Code Plugin 설치 (복사용) ──
-                    if (pluginUrl) {
-                        console.log(`\n  \x1b[1m▸ Claude Code Plugin 설치\x1b[0m`);
-                        console.log(`  ┌─`);
-                        console.log(`  │ /plugin marketplace add ${pluginUrl}`);
-                        console.log(`  │ /plugin install ${pluginSlug}`);
-                        console.log(`  └─`);
-                    }
-                    // ── 소개 페이지 ──
-                    console.log(`\n  \x1b[90m소개 페이지:\x1b[0m https://relayax.com/@${detailSlug}`);
+                    console.log(`\n  \x1b[90m소개:\x1b[0m https://relayax.com/@${detailSlug}`);
                     // ── 공유 텍스트 (코드블록, 그대로 복붙) ──
                     if (isTTY) {
                         const shareBlock = [
                             `[${config.name}] 설치하기`,
                             ``,
-                            `# CLI`,
-                            installCmd,
+                            npxInstallCmd,
+                            ``,
+                            `소개: https://relayax.com/@${detailSlug}`,
                         ];
-                        if (pluginUrl) {
-                            shareBlock.push(``, `# Claude Code Plugin`, `/plugin marketplace add ${pluginUrl}`, `/plugin install ${pluginSlug}`);
-                        }
-                        shareBlock.push(``, `소개: https://relayax.com/@${detailSlug}`);
                         const maxLen = Math.max(...shareBlock.map((l) => l.length));
                         const border = '─'.repeat(maxLen + 2);
                         console.log(`\n  \x1b[90m┌${border}┐\x1b[0m`);

package/dist/lib/git-operations.js

@@ -45,7 +45,11 @@ function gitClone(url, destDir, opts) {
         args.push('--depth', String(opts.depth));
     }
     args.push(url, destDir);
-    (0, child_process_1.execFileSync)('git', args, { stdio: 'pipe' });
+    (0, child_process_1.execFileSync)('git', args, {
+        stdio: 'pipe',
+        env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+        timeout: 30000,
+    });
 }
 function gitAdd(dir, files = '.') {
     (0, child_process_1.execFileSync)('git', ['add', files], { cwd: dir, stdio: 'pipe' });

package/dist/lib/preamble.js

@@ -37,12 +37,21 @@ else
   DEVICE_HASH="unknown"
 fi
 
-# Usage ping
+# Read relay token (for user identification in usage ping)
+_RELAY_TOKEN=""
+if [ -f "$HOME/.relay/token.json" ]; then
+  _RELAY_TOKEN=$(grep -o '"access_token":"[^"]*"' "$HOME/.relay/token.json" 2>/dev/null | head -1 | cut -d'"' -f4)
+fi
+
+# Usage ping (with user identity if logged in)
 if command -v relay &>/dev/null; then
   relay ping "${slug}" --quiet 2>/dev/null &
 elif command -v curl &>/dev/null; then
-  curl -sf --max-time 5 -X POST "${apiUrl}/api/agents/${agentSlug}/ping" \\
+  _AUTH_HEADER=""
+  [ -n "$_RELAY_TOKEN" ] && _AUTH_HEADER="-H \\"Authorization: Bearer $_RELAY_TOKEN\\""
+  eval curl -sf --max-time 5 -X POST "${apiUrl}/api/agents/${agentSlug}/ping" \\
     -H "Content-Type: application/json" \\
+    $_AUTH_HEADER \\
     -d "{\\"device_hash\\":\\"$DEVICE_HASH\\",\\"slug\\":\\"${slug}\\"}" \\
     2>/dev/null &
 fi

package/dist/mcp/server.js

@@ -126,18 +126,16 @@ function createMcpServer() {
             const tempDir = (0, storage_js_1.makeTempDir)();
             try {
                 const agentDir = path_1.default.join(projectPath, '.relay', 'agents', parsed.owner, parsed.name);
-                if (agent.git_url) {
-                    // Git clone path
-                    (0, git_operations_js_1.checkGitInstalled)();
-                    await (0, storage_js_1.clonePackage)(agent.git_url, agentDir);
+                if (!agent.git_url) {
+                    return { content: [jsonText({ error: 'NO_GIT_URL', message: '이 에이전트는 재publish가 필요합니다. 빌더에게 문의하세요.' })], isError: true };
                 }
-                else {
-                    // Legacy tar.gz path
-                    const tarPath = await (0, storage_js_1.downloadPackage)(agent.package_url, tempDir);
-                    if (fs_1.default.existsSync(agentDir))
-                        fs_1.default.rmSync(agentDir, { recursive: true, force: true });
-                    fs_1.default.mkdirSync(agentDir, { recursive: true });
-                    await (0, storage_js_1.extractPackage)(tarPath, agentDir);
+                (0, git_operations_js_1.checkGitInstalled)();
+                await (0, storage_js_1.clonePackage)(agent.git_url, agentDir);
+                // Verify clone has actual files
+                const clonedEntries = fs_1.default.readdirSync(agentDir).filter((f) => f !== '.git');
+                if (clonedEntries.length === 0) {
+                    fs_1.default.rmSync(agentDir, { recursive: true, force: true });
+                    return { content: [jsonText({ error: 'EMPTY_PACKAGE', message: '에이전트 패키지가 비어있습니다. 빌더에게 재publish를 요청하세요.' })], isError: true };
                 }
                 (0, preamble_js_1.injectPreambleToAgent)(agentDir, fullSlug);
                 const installed = (0, config_js_1.loadInstalled)();
@@ -734,6 +732,89 @@ function createMcpServer() {
             return { content: [jsonText({ error: String(err) })], isError: true };
         }
     });
+    // ═══ Detail Images — 상세페이지 이미지 관리 ═══
+    server.tool('relay_detail_upload', '에이전트 상세페이지 이미지를 업로드합니다. 폴더 내 이미지를 파일명 순으로 정렬하여 업로드합니다 (기존 이미지 전체 교체).', {
+        slug: zod_1.z.string().describe('에이전트 slug'),
+        path: zod_1.z.string().describe('이미지가 있는 폴더 경로 (PNG/GIF/JPEG/WebP)'),
+    }, async ({ slug, path: dirPath }) => {
+        try {
+            const token = (0, config_js_1.getValidToken)();
+            if (!token)
+                return { content: [jsonText({ error: '로그인이 필요합니다. relay login을 먼저 실행하세요.' })], isError: true };
+            const absPath = path_1.default.resolve(dirPath);
+            if (!fs_1.default.existsSync(absPath) || !fs_1.default.statSync(absPath).isDirectory()) {
+                return { content: [jsonText({ error: `폴더를 찾을 수 없습니다: ${absPath}` })], isError: true };
+            }
+            const imageExts = ['.png', '.jpg', '.jpeg', '.gif', '.webp'];
+            const files = fs_1.default.readdirSync(absPath)
+                .filter((f) => imageExts.includes(path_1.default.extname(f).toLowerCase()))
+                .sort();
+            if (files.length === 0) {
+                return { content: [jsonText({ error: '폴더에 이미지 파일이 없습니다 (PNG/GIF/JPEG/WebP)' })], isError: true };
+            }
+            const formData = new FormData();
+            for (const file of files) {
+                const filePath = path_1.default.join(absPath, file);
+                const buffer = fs_1.default.readFileSync(filePath);
+                const ext = path_1.default.extname(file).toLowerCase();
+                const mimeMap = { '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.gif': 'image/gif', '.webp': 'image/webp' };
+                const blob = new Blob([buffer], { type: mimeMap[ext] || 'image/png' });
+                formData.append('files', blob, file);
+            }
+            const res = await fetch(`${config_js_1.API_URL}/api/agents/${slug}/detail-images`, {
+                method: 'POST',
+                headers: { Authorization: `Bearer ${token}` },
+                body: formData,
+            });
+            if (!res.ok) {
+                const body = await res.json().catch(() => ({}));
+                return { content: [jsonText({ error: body.message || `업로드 실패 (${res.status})` })], isError: true };
+            }
+            const result = await res.json();
+            const update = await getCliUpdateWarning();
+            return { content: [jsonTextWithUpdate({ status: 'uploaded', count: result.count, images: result.detail_images }, update)] };
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
+    server.tool('relay_detail_list', '에이전트 상세페이지 이미지 목록을 조회합니다', {
+        slug: zod_1.z.string().describe('에이전트 slug'),
+    }, async ({ slug }) => {
+        try {
+            const res = await fetch(`${config_js_1.API_URL}/api/agents/${slug}/detail-images`);
+            if (!res.ok) {
+                return { content: [jsonText({ error: `조회 실패 (${res.status})` })], isError: true };
+            }
+            const data = await res.json();
+            return { content: [jsonText({ detail_images: data.detail_images, count: data.detail_images.length })] };
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
+    server.tool('relay_detail_clear', '에이전트 상세페이지 이미지를 모두 삭제합니다', {
+        slug: zod_1.z.string().describe('에이전트 slug'),
+    }, async ({ slug }) => {
+        try {
+            const token = (0, config_js_1.getValidToken)();
+            if (!token)
+                return { content: [jsonText({ error: '로그인이 필요합니다.' })], isError: true };
+            const res = await fetch(`${config_js_1.API_URL}/api/agents/${slug}/detail-images`, {
+                method: 'DELETE',
+                headers: { Authorization: `Bearer ${token}` },
+            });
+            if (!res.ok) {
+                const body = await res.json().catch(() => ({}));
+                return { content: [jsonText({ error: body.message || `삭제 실패 (${res.status})` })], isError: true };
+            }
+            const result = await res.json();
+            return { content: [jsonText({ status: 'cleared', deleted: result.deleted })] };
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
     return server;
 }
 // ─── Start ───

package/dist/prompts/create.md

@@ -143,10 +143,10 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 1. **배포 결과 요약** — slug, 버전, 공개 범위, URL
 2. **설치 방법** — CLI 출력에 코드블록 형태로 이미 포함되어 있으므로, 그 내용을 사용자에게 안내합니다:
    - CLI: `npx relayax-cli install {slug}`
-   - 출력에 `plugin_url`이 있으면 Claude Code Plugin:
+   - 출력에 `plugin_url`이 있으면 Claude Code Plugin (**두 명령을 순서대로 각각 실행**):
      ```
-     /plugin marketplace add {pluginUrl}
-     /plugin install {slug}
+     ① /plugin marketplace add {pluginUrl}
+     ② /plugin install {slug}
      ```
    - 에이전트 소개 페이지 URL
 3. **공유 텍스트** — CLI 출력의 공유 블록(┌─ ... ─┘)을 그대로 안내합니다. 팀에 바로 복붙할 수 있는 코드블록 형태입니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relayax-cli",
-  "version": "0.4.16",
+  "version": "0.4.18",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {