relayax-cli 0.3.49 → 0.3.51

package/dist/commands/publish.d.ts

@@ -1,4 +1,13 @@
 import { Command } from 'commander';
+interface CommandEntry {
+    name: string;
+    description: string;
+}
+interface Components {
+    agents: number;
+    rules: number;
+    skills: number;
+}
 export interface RequiresCli {
     name: string;
     install?: string;
@@ -35,4 +44,49 @@ export interface Requires {
     };
     permissions?: string[];
 }
+interface AgentDetail {
+    name: string;
+    description: string;
+    uses: string[];
+}
+interface SkillDetail {
+    name: string;
+    description: string;
+    uses: string[];
+}
+export interface PublishMetadata {
+    slug: string;
+    name: string;
+    description: string;
+    long_description?: string;
+    tags: string[];
+    commands: CommandEntry[];
+    components: Components;
+    version: string;
+    changelog?: string;
+    requires?: Requires;
+    visibility?: 'public' | 'private' | 'internal';
+    type?: 'command' | 'passive' | 'hybrid';
+    cli_version?: string;
+    agent_names?: string[];
+    skill_names?: string[];
+    agent_details?: AgentDetail[];
+    skill_details?: SkillDetail[];
+    org_slug?: string;
+}
+export declare function createTarball(agentDir: string): Promise<string>;
+interface PublishResult {
+    status: string;
+    slug: string;
+    version: string;
+    url: string;
+    profile?: {
+        username?: string;
+        display_name?: string;
+        contact_links?: Record<string, string>;
+        default_welcome?: string;
+    } | null;
+}
+export declare function publishToApi(token: string, tarPath: string, metadata: PublishMetadata): Promise<PublishResult>;
 export declare function registerPublish(program: Command): void;
+export {};

package/dist/commands/publish.js

@@ -3,6 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTarball = createTarball;
+exports.publishToApi = publishToApi;
 exports.registerPublish = registerPublish;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));

package/dist/lib/ai-tools.js

@@ -33,9 +33,11 @@ exports.AI_TOOLS = [
     { name: 'Factory Droid', value: 'factory', skillsDir: '.factory' },
     { name: 'Gemini CLI', value: 'gemini', skillsDir: '.gemini' },
     { name: 'GitHub Copilot', value: 'github-copilot', skillsDir: '.github' },
+    { name: 'Hermes Agent', value: 'hermes', skillsDir: '.hermes' },
     { name: 'iFlow', value: 'iflow', skillsDir: '.iflow' },
     { name: 'Kilo Code', value: 'kilocode', skillsDir: '.kilocode' },
     { name: 'Kiro', value: 'kiro', skillsDir: '.kiro' },
+    { name: 'OpenClaw', value: 'openclaw', skillsDir: '.openclaw' },
     { name: 'OpenCode', value: 'opencode', skillsDir: '.opencode' },
     { name: 'Pi', value: 'pi', skillsDir: '.pi' },
     { name: 'Qoder', value: 'qoder', skillsDir: '.qoder' },

package/dist/lib/command-adapter.js

@@ -13,6 +13,36 @@ exports.formatCommandFile = formatCommandFile;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const index_js_1 = require("../prompts/index.js");
+/**
+ * 환경 감지 프리앰블.
+ * slash command 실행 시 MCP tool 사용 가능 여부를 먼저 판별하여,
+ * 이후 모든 CLI 명령어를 적절한 방식으로 실행하도록 안내.
+ */
+const ENV_PREAMBLE = `## 환경 감지
+
+이 커맨드를 실행하기 전에 환경을 판별하세요:
+
+1. **relay MCP tool 사용 가능 여부 확인**: relay_status 같은 relay MCP tool을 호출할 수 있는지 확인하세요.
+   - 사용 가능 → **MCP 모드**로 실행 (아래 표 참고)
+   - 사용 불가 → **CLI 모드**로 실행 (bash 명령어 그대로 사용)
+
+2. MCP 모드에서의 명령어 변환:
+
+| CLI 명령어 | MCP tool |
+|---|---|
+| \`relay status\` | \`relay_status\` tool 호출 |
+| \`relay list --json\` | \`relay_list\` tool 호출 |
+| \`relay search <keyword>\` | \`relay_search\` tool 호출 |
+| \`relay install <slug>\` | \`relay_install\` tool 호출 |
+| \`relay uninstall <slug>\` | \`relay_uninstall\` tool 호출 |
+| \`relay package --init\` | \`relay_scan\` tool 호출 |
+| \`relay publish\` | \`relay_publish\` tool 호출 |
+
+**중요**: 이후 지시에서 \`relay <명령어>\`로 표기된 것은 판별된 환경에 따라 변환하여 실행하세요.
+
+---
+
+`;
 /**
  * 로컬 어댑터 — 프로젝트 디렉토리 기준.
  * {projectPath}/{skillsDir}/commands/relay/{id}.md
@@ -66,12 +96,12 @@ exports.USER_COMMANDS = [
     {
         id: 'relay-install',
         description: 'relay에서 에이전트를 설치합니다',
-        body: index_js_1.INSTALL_PROMPT,
+        body: ENV_PREAMBLE + index_js_1.INSTALL_PROMPT,
     },
     {
         id: 'relay-status',
         description: '설치된 에이전트와 Organization 현황을 확인합니다',
-        body: `현재 설치된 에이전트와 소속 Organization 현황을 한눈에 보여줍니다.
+        body: ENV_PREAMBLE + `현재 설치된 에이전트와 소속 Organization 현황을 한눈에 보여줍니다.
 
 ## 실행 방법
 
@@ -160,7 +190,7 @@ ${index_js_1.ERROR_HANDLING_GUIDE}
     {
         id: 'relay-uninstall',
         description: '설치된 에이전트를 삭제합니다',
-        body: `설치된 에이전트를 제거합니다. CLI가 패키지와 배치된 파일을 모두 정리합니다.
+        body: ENV_PREAMBLE + `설치된 에이전트를 제거합니다. CLI가 패키지와 배치된 파일을 모두 정리합니다.
 
 ## 실행 방법
 
@@ -181,7 +211,7 @@ ${index_js_1.ERROR_HANDLING_GUIDE}
     {
         id: 'relay-publish',
         description: '현재 에이전트 패키지를 relay에 배포합니다',
-        body: index_js_1.PUBLISH_PROMPT,
+        body: ENV_PREAMBLE + index_js_1.PUBLISH_PROMPT,
     },
 ];
 // ─── Builder Commands (로컬 설치) ───

package/dist/mcp/server.js

@@ -16,6 +16,7 @@ const ai_tools_js_1 = require("../lib/ai-tools.js");
 const preamble_js_1 = require("../lib/preamble.js");
 const installer_js_1 = require("../lib/installer.js");
 const paths_js_1 = require("../lib/paths.js");
+// prompts are used in MCP Prompt definitions below
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
@@ -161,7 +162,30 @@ function createMcpServer() {
             }
             catch { /* skip */ }
         }
-        return { content: [jsonText({ login: { authenticated: !!token, username }, agent_clis: detected.map((t) => t.name), mounted_paths: mounted.map((m) => m.basePath), project })] };
+        // 버전 확인
+        const { checkCliVersion } = await import('../lib/version-check.js');
+        const cliUpdate = await checkCliVersion(true);
+        return { content: [jsonText({
+                    cli: { version: pkg.version, update_available: cliUpdate ? cliUpdate.latest : null },
+                    login: { authenticated: !!token, username },
+                    agent_clis: detected.map((t) => t.name),
+                    mounted_paths: mounted.map((m) => m.basePath),
+                    project,
+                })] };
+    });
+    server.tool('relay_check_update', 'CLI 및 에이전트 업데이트를 확인합니다', {}, async () => {
+        const { checkCliVersion, checkAllAgents } = await import('../lib/version-check.js');
+        const cliUpdate = await checkCliVersion(true);
+        const agentUpdates = await checkAllAgents(true);
+        const updates = [];
+        if (cliUpdate)
+            updates.push({ type: 'cli', current: cliUpdate.current, latest: cliUpdate.latest });
+        for (const u of agentUpdates)
+            updates.push({ type: 'agent', slug: u.slug, current: u.current, latest: u.latest });
+        if (updates.length === 0) {
+            return { content: [jsonText({ status: 'up_to_date', message: '모두 최신 버전입니다.', cli_version: pkg.version })] };
+        }
+        return { content: [jsonText({ status: 'updates_available', updates, message: 'CLI를 업데이트하려면: npm update -g relayax-cli' })] };
     });
     server.tool('relay_scan', '배포 가능한 스킬/에이전트/커맨드를 스캔합니다', {
         project_path: zod_1.z.string().optional().describe('프로젝트 경로'),
@@ -190,73 +214,61 @@ function createMcpServer() {
         }
         return { content: [jsonText({ sources })] };
     });
-    server.tool('relay_publish', '에이전트를 마켓플레이스에 배포합니다', {
-        project_path: zod_1.z.string().optional().describe('프로젝트 경로'),
+    server.tool('relay_publish', '에이전트를 마켓플레이스에 배포합니다 (.relay/ 디렉토리를 tar로 패키징하여 업로드)', {
+        project_path: zod_1.z.string().optional().describe('프로젝트 경로 (.relay/relay.yaml이 있는 디렉토리)'),
     }, async ({ project_path }) => {
-        const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
-        const relayYaml = path_1.default.join(projectPath, '.relay', 'relay.yaml');
-        if (!fs_1.default.existsSync(relayYaml)) {
-            return { content: [jsonText({ error: 'NOT_INITIALIZED', message: '.relay/relay.yaml이 없습니다. relay-publish 프롬프트를 사용하여 프로젝트를 먼저 설정하세요.' })], isError: true };
+        try {
+            const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
+            const relayDir = path_1.default.join(projectPath, '.relay');
+            const relayYaml = path_1.default.join(relayDir, 'relay.yaml');
+            if (!fs_1.default.existsSync(relayYaml)) {
+                return { content: [jsonText({ error: 'NOT_INITIALIZED', message: '.relay/relay.yaml이 없습니다.' })], isError: true };
+            }
+            const token = await (0, config_js_1.getValidToken)();
+            if (!token) {
+                return { content: [jsonText({ error: 'LOGIN_REQUIRED', message: '배포하려면 로그인이 필요합니다.' })], isError: true };
+            }
+            const cfg = js_yaml_1.default.load(fs_1.default.readFileSync(relayYaml, 'utf-8'));
+            const { createTarball, publishToApi } = await import('../commands/publish.js');
+            const tarPath = await createTarball(relayDir);
+            try {
+                const metadata = {
+                    slug: cfg.slug,
+                    name: cfg.name,
+                    description: cfg.description ?? '',
+                    tags: cfg.tags ?? [],
+                    commands: [],
+                    components: { skills: 0, agents: 0, rules: 0, commands: 0 },
+                    version: cfg.version,
+                    visibility: cfg.visibility ?? 'public',
+                    cli_version: pkg.version,
+                };
+                const result = await publishToApi(token, tarPath, metadata);
+                return { content: [jsonText(result)] };
+            }
+            finally {
+                fs_1.default.unlinkSync(tarPath);
+            }
         }
-        const token = await (0, config_js_1.getValidToken)();
-        if (!token) {
-            return { content: [jsonText({ error: 'LOGIN_REQUIRED', message: '배포하려면 로그인이 필요합니다.' })], isError: true };
+        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 {
+            const { installGlobalUserCommands, hasGlobalUserCommands } = await import('../commands/init.js');
+            if (hasGlobalUserCommands()) {
+                installGlobalUserCommands(); // 업데이트
+                return { content: [jsonText({ status: 'updated', message: 'relay slash command가 업데이트되었습니다.' })] };
+            }
+            installGlobalUserCommands();
+            return { content: [jsonText({ status: 'installed', message: 'relay slash command가 설치되었습니다. /relay-install, /relay-publish 등을 사용할 수 있습니다.' })] };
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
         }
-        const cfg = js_yaml_1.default.load(fs_1.default.readFileSync(relayYaml, 'utf-8'));
-        return { content: [jsonText({ status: 'ready', project_path: projectPath, name: cfg.name, slug: cfg.slug, version: cfg.version, message: '배포 준비 완료. relay-publish 프롬프트로 전체 워크플로우를 실행하세요.' })] };
     });
-    // ═══ Prompts ═══
-    server.prompt('relay-install', '에이전트 검색 → 설치 가이드 워크플로우', {}, () => ({
-        messages: [{
-                role: 'user',
-                content: { type: 'text', text: `다음 가이드를 따라 에이전트를 설치하세요. relay MCP tool을 사용하여 각 단계를 실행합니다.
-
-사용 가능한 tool: relay_status, relay_search, relay_install, relay_list, relay_status
-
-## 워크플로우
-
-1. relay_status로 로그인 상태 확인. 미인증이면 사용자에게 터미널에서 \`npx relayax-cli login --device\` 실행을 안내.
-2. 사용자에게 어떤 에이전트를 찾는지 물어보기.
-3. relay_search로 검색.
-4. 검색 결과를 보여주고 선택하게 하기.
-5. relay_install로 설치.
-6. 설치 결과와 사용법 안내.` },
-            }],
-    }));
-    server.prompt('relay-publish', '에이전트 배포 가이드 워크플로우', {}, () => ({
-        messages: [{
-                role: 'user',
-                content: { type: 'text', text: `다음 가이드를 따라 에이전트를 배포하세요. relay MCP tool을 사용합니다.
-
-사용 가능한 tool: relay_status, relay_scan, relay_status, relay_publish
-
-## 워크플로우
-
-1. relay_status로 로그인 상태 확인. 미인증이면 터미널에서 \`npx relayax-cli login --device\` 안내.
-2. relay_scan으로 배포 가능한 스킬/에이전트/커맨드 목록 스캔.
-3. 스캔 결과를 보여주고 사용자에게 어떤 항목을 배포할지 선택하게 하기.
-4. relay_status로 프로젝트 상태 확인. .relay/relay.yaml이 없으면 프로젝트 생성 안내.
-5. relay_publish로 배포.
-6. 배포 결과를 사용자에게 보여주기.` },
-            }],
-    }));
-    server.prompt('relay-status', '환경 상태 확인', {}, () => ({
-        messages: [{
-                role: 'user',
-                content: { type: 'text', text: 'relay_status, relay_status, relay_list, relay_scan tool을 사용하여 현재 relay 환경 상태를 확인하고 사용자에게 보여주세요. 로그인 상태, 감지된 AI 도구, 프로젝트 정보, 설치된 에이전트, 배포 가능한 스킬 목록을 포함합니다.' },
-            }],
-    }));
-    server.prompt('relay-uninstall', '에이전트 제거 가이드', {}, () => ({
-        messages: [{
-                role: 'user',
-                content: { type: 'text', text: `다음 워크플로우를 따라 에이전트를 제거하세요:
-
-1. relay_list로 설치된 에이전트 목록 표시.
-2. 사용자에게 제거할 에이전트 선택하게 하기.
-3. relay_uninstall로 제거.
-4. 결과 보여주기.` },
-            }],
-    }));
     return server;
 }
 // ─── Start ───

package/dist/prompts/_setup-environment.md

@@ -16,17 +16,49 @@ npm install -g relayax-cli 2>/dev/null && echo "install-ok" || echo "sandbox"
 ```
 
 - `install-ok` → **환경 A (터미널)** (`relay init` 실행 후 Step 1로)
-- `sandbox` → **환경 B (샌드박스)** — `npx relayax-cli`로 실행
+- `sandbox` → **환경 B (샌드박스)** — 아래 MCP 설정으로 진행
+
+### 환경 B: MCP Connector 자동 설정 (샌드박스)
+
+샌드박스 환경(Cowork 등)에서는 네트워크가 제한되어 CLI로 직접 API 호출이 불가합니다.
+대신 relay MCP 서버를 설정하면, 호스트 머신에서 API를 호출할 수 있습니다.
+
+**relay MCP tool(`relay_status` 등)을 사용할 수 있는지 확인하세요.**
+사용할 수 있다면 MCP가 이미 설정되어 있으므로 바로 Step 1로 진행합니다.
+
+사용할 수 없다면 아래 절차로 MCP를 설정합니다:
+
+1. Claude Desktop 설정 파일을 찾아 읽습니다:
+```bash
+cat ~/Library/Application\ Support/Claude/claude_desktop_config.json 2>/dev/null || echo "{}"
+```
+
+2. 설정 파일에 아래 relay MCP 서버를 추가합니다 (기존 mcpServers가 있으면 거기에 추가, 없으면 새로 생성):
+```json
+{
+  "mcpServers": {
+    "relay": {
+      "command": "npx",
+      "args": ["relayax-cli", "mcp"]
+    }
+  }
+}
+```
+
+3. 사용자에게 **Claude Desktop을 재시작**해달라고 안내합니다.
+
+4. 재시작 후 `relay_status` MCP tool이 사용 가능한지 확인합니다. 사용 가능하면 Step 1로 진행합니다.
 
 ### 환경별 실행 방법
 
 이후 가이드의 모든 `relay <명령어>`는 감지된 환경에 따라 실행합니다:
 
-| 가이드 지시 | A. 터미널 | B. 샌드박스 |
+| 가이드 지시 | A. 터미널 | B. 샌드박스 (MCP) |
 |---|---|---|
-| "relay status" | `relay status` | `npx relayax-cli status` |
-| "relay install X" | `relay install X` | `npx relayax-cli install X` |
-| "relay publish" | `relay publish` | `npx relayax-cli publish` |
-| "relay login" | `relay login` | `npx relayax-cli login --device` |
+| "relay status" | `relay status` | `relay_status` tool 호출 |
+| "relay install X" | `relay install X` | `relay_install` tool 호출 (`slug: "X"`) |
+| "relay publish" | `relay publish` | `relay_publish` tool 호출 |
+| "relay login" | `relay login` | 사용자에게 터미널에서 `npx relayax-cli login --device` 안내 |
+| "relay scan" | `relay package --init` | `relay_scan` tool 호출 |
 
 처음 판별한 환경을 이후 계속 사용합니다.

package/package.json

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