relayax-cli 0.3.64 → 0.3.66

package/dist/mcp/server.js

@@ -677,6 +677,29 @@ function createMcpServer() {
             return { content: [jsonText({ error: String(err) })], isError: true };
         }
     });
+    // ═══ relay_guide — 에이전트 설치 가이드 조회 ═══
+    server.tool('relay_guide', '에이전트 설치 가이드를 조회합니다. URL을 fetch할 수 없는 샌드박스 환경에서 사용하세요.', {
+        slug: zod_1.z.string().describe('에이전트 slug (예: @owner/name)'),
+        code: zod_1.z.string().optional().describe('접근 코드 (비공개 에이전트용)'),
+    }, async ({ slug: slugInput, code }) => {
+        try {
+            const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
+            let url = `${config_js_1.API_URL}/api/registry/${parsed.owner}/${parsed.name}/guide.md`;
+            if (code)
+                url += `?code=${encodeURIComponent(code)}`;
+            const res = await fetch(url);
+            if (!res.ok) {
+                if (res.status === 404)
+                    throw new Error('에이전트를 찾을 수 없습니다.');
+                throw new Error(`가이드를 가져올 수 없습니다 (${res.status})`);
+            }
+            const guide = await res.text();
+            return { content: [{ type: 'text', text: guide }] };
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
     // ═══ relay_init — slash command 설치 ═══
     server.tool('relay_init', 'relay slash command를 설치합니다 (/relay-install, /relay-publish 등)', {}, async () => {
         try {

package/dist/prompts/create.md

@@ -0,0 +1,62 @@
+에이전트 패키지를 새로 만듭니다.
+콘텐츠를 분석하고, 포지셔닝하고, relay.yaml을 작성한 뒤 배포합니다.
+
+> 빌더는 터미널 환경에서 작업합니다. CLI 명령어를 직접 실행하세요.
+
+## 1. 콘텐츠 파악
+
+`relay package --init --json`으로 소스를 스캔합니다.
+결과의 `sources[]`에서 사용자에게 어떤 콘텐츠를 포함할지 물어봅니다.
+
+선택된 콘텐츠의 파일을 직접 읽어 기능을 파악합니다:
+- SKILL.md, 에이전트 파일, 커맨드 파일의 내용
+- 참조하는 스킬/에이전트 의존성
+
+## 2. 포지셔닝
+
+콘텐츠 분석을 기반으로 에이전트를 하나의 "제품"으로 포지셔닝합니다.
+
+분석 관점:
+- 이 에이전트가 **무엇을 하는** 에이전트인지
+- 어떤 **기술 스택/도메인**에 특화되어 있는지
+- 설치자에게 **어떤 가치**를 제공하는지
+
+이름(name)은 한국어 가능. slug는 영문 소문자+하이픈.
+설명은 설치자 관점으로 ("~를 자동화합니다").
+
+## 3. requires 판단
+
+콘텐츠 파일을 읽고 requires를 판단합니다:
+
+- **env**: 환경변수 참조를 찾고 맥락에서 필수/선택 판단
+  - 핵심 로직에서 사용 → `required: true`
+  - 테스트/선택 기능에서 사용 → `required: false`
+- **cli**: 외부 CLI 도구 참조 (playwright, ffmpeg 등)
+- **npm**: import/require 패키지
+- **mcp**: MCP 서버 참조 (supabase, github 등)
+- **runtime**: Node.js/Python 최소 버전
+- **agents**: 의존하는 다른 relay 에이전트
+
+## 4. 보안 점검
+
+콘텐츠 파일에서 시크릿/개인정보를 확인합니다:
+- 하드코딩된 API 키, 토큰 (sk-*, ghp_*, AKIA* 등)
+- 이메일, 전화번호 등 개인정보
+- 발견 시 **반드시 경고**하고 환경변수 대체 안내
+- 파일 컨텍스트를 읽어 실제 시크릿 vs 예시 코드를 구분
+
+## 5. relay.yaml 작성 & 배포
+
+판단 결과를 relay.yaml에 반영합니다:
+- name, slug, description, version, tags
+- requires (판단 결과)
+- visibility, org (사용자에게 확인)
+
+`relay publish --json`으로 배포합니다.
+
+## 6. 공유 문구
+
+배포 완료 후 `relay publish` 출력에 포함된 공유 문구를 보여줍니다.
+CLI가 이미 설치된 사용자를 위한 짧은 버전도 함께 표시합니다.
+
+{{ERROR_HANDLING_GUIDE}}

package/dist/prompts/explore.md

@@ -0,0 +1,28 @@
+프로젝트에 맞는 에이전트를 찾아 추천하고 설치합니다.
+
+## 프로젝트 분석
+
+현재 프로젝트의 기술 스택, 구조, 패턴을 파악합니다:
+- 사용 중인 프레임워크/라이브러리 (package.json, import 패턴)
+- 프로젝트 구조 (디렉토리 레이아웃, 주요 파일)
+- 기존 설치된 에이전트 (`relay list --json`)
+
+## 에이전트 검색
+
+`relay search <keyword>` 명령어로 검색합니다.
+프로젝트 컨텍스트에 맞는 키워드를 선택합니다 (기술 스택, 작업 유형 등).
+여러 키워드로 반복 검색하여 폭넓게 탐색합니다.
+
+## 추천
+
+검색 결과 중 프로젝트에 가장 적합한 에이전트를 추천합니다:
+- 추천 이유를 프로젝트 컨텍스트와 연결하여 설명
+- 에이전트의 주요 커맨드/기능을 요약
+
+## 설치
+
+사용자가 선택하면 `relay install <slug>` 을 실행합니다.
+
+scope 결정 기준:
+- 범용 도구 (코드 리뷰, 문서 생성, 테스트) → `relay install <slug>` (글로벌 기본)
+- 프로젝트 특화 (특정 프레임워크, 팀 컨벤션) → `relay install <slug> --local`

package/dist/prompts/index.d.ts

@@ -1,8 +1,3 @@
-export declare const REQUIREMENTS_CHECK: string;
 export declare const ERROR_HANDLING_GUIDE: string;
-export declare const SETUP_ENVIRONMENT: string;
-export declare const SETUP_CLI: string;
-export declare const SETUP_LOGIN: string;
-export declare const GUIDE_INSTRUCTION: string;
-export declare const INSTALL_PROMPT: string;
-export declare const PUBLISH_PROMPT: string;
+export declare const EXPLORE_PROMPT: string;
+export declare const CREATE_PROMPT: string;

package/dist/prompts/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PUBLISH_PROMPT = exports.INSTALL_PROMPT = exports.GUIDE_INSTRUCTION = exports.SETUP_LOGIN = exports.SETUP_CLI = exports.SETUP_ENVIRONMENT = exports.ERROR_HANDLING_GUIDE = exports.REQUIREMENTS_CHECK = void 0;
+exports.CREATE_PROMPT = exports.EXPLORE_PROMPT = exports.ERROR_HANDLING_GUIDE = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 function readPrompt(filename) {
@@ -13,17 +13,10 @@ function interpolate(template, vars) {
     return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? `{{${key}}}`);
 }
 // ─── 공유 조각 ───
-exports.REQUIREMENTS_CHECK = readPrompt('_requirements-check.md');
 exports.ERROR_HANDLING_GUIDE = readPrompt('_error-handling.md');
-exports.SETUP_ENVIRONMENT = readPrompt('_setup-environment.md');
-exports.SETUP_CLI = readPrompt('_setup-cli.md');
-exports.SETUP_LOGIN = readPrompt('_setup-login.md');
-exports.GUIDE_INSTRUCTION = readPrompt('_guide-instruction.md');
 const fragments = {
-    REQUIREMENTS_CHECK: exports.REQUIREMENTS_CHECK,
     ERROR_HANDLING_GUIDE: exports.ERROR_HANDLING_GUIDE,
-    GUIDE_INSTRUCTION: exports.GUIDE_INSTRUCTION,
 };
-// ─── 전체 프롬프트 (조각 합성 완료) ───
-exports.INSTALL_PROMPT = interpolate(readPrompt('install.md'), fragments);
-exports.PUBLISH_PROMPT = interpolate(readPrompt('publish.md'), fragments);
+// ─── 프롬프트 ───
+exports.EXPLORE_PROMPT = interpolate(readPrompt('explore.md'), fragments);
+exports.CREATE_PROMPT = interpolate(readPrompt('create.md'), fragments);

package/dist/types.d.ts

@@ -14,8 +14,10 @@ export interface InstalledAgent {
     org_slug?: string;
     /** 배치 범위 — 에이전트가 relay deploy-record로 기록 */
     deploy_scope?: 'global' | 'local';
-    /** 배치된 파일 절대경로 목록 — 에이전트가 relay deploy-record로 기록 */
+    /** 배치된 파일 절대경로 목록 — 에이전트가 relay deploy-record로 기록 (legacy) */
     deployed_files?: string[];
+    /** symlink 절대경로 목록 — relay install이 직접 기록 */
+    deployed_symlinks?: string[];
 }
 /** 키는 scoped slug 포맷: "@owner/name" */
 export interface InstalledRegistry {

package/package.json

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