anpm-io 1.0.0

package/README.md

@@ -0,0 +1,174 @@
+# relay
+
+**The package manager for AI agents.**
+
+Write once, run on any harness. One command install. Built-in usage analytics.
+
+```bash
+npx relayax-cli install @gstack/code-review
+```
+
+```
+ ╭──────────────────────────────────────────────╮
+ │                                              │
+ │   relay — AI agent distribution for humans   │
+ │   and machines.                              │
+ │                                              │
+ │   ✓ installed @gstack/code-review (v2.1.0)   │
+ │   3 skills, 1 agent ready                    │
+ │                                              │
+ ╰──────────────────────────────────────────────╯
+```
+
+---
+
+## Why
+
+AI agents are stuck in silos. You build an agent for Claude Code — it doesn't work on OpenClaw. You share it on GitHub — no one knows it exists. You have no idea if anyone actually uses it.
+
+**Relay fixes this.**
+
+| Problem | Relay |
+|---|---|
+| Agents locked to one harness | Cross-harness compatibility (Claude, OpenClaw, nanoclaw) |
+| No distribution channel | `relay install` — one command, done |
+| Zero feedback from users | Built-in analytics — see which skills get used |
+
+---
+
+## Quick Start
+
+```bash
+# Install an agent — no setup required
+npx relayax-cli install @author/agent-name
+
+# Or install globally
+npm i -g relayax-cli
+relay install @author/agent-name
+```
+
+That's it. The agent is ready in your `.relay/agents/` directory, compatible with your harness.
+
+---
+
+## For Agent Builders
+
+```bash
+# Publish your agent to the registry
+relay publish
+
+# See who's using it
+relay status --analytics
+```
+
+Relay tracks skill-level usage out of the box. No extra setup. You'll know exactly which skills land and which don't — so you can ship better agents, faster.
+
+### Package Format
+
+```yaml
+# team.yaml
+name: code-review
+version: 2.1.0
+harness:
+  - claude
+  - openclaw
+  - nanoclaw
+agents:
+  - name: reviewer
+    type: passive
+skills:
+  - name: review-pr
+  - name: security-check
+  - name: style-lint
+```
+
+One spec. Every harness.
+
+---
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `relay install <name>` | Install an agent |
+| `relay search <keyword>` | Find agents in the registry |
+| `relay publish` | Publish your agent |
+| `relay list` | List installed agents |
+| `relay status` | Check environment + analytics |
+| `relay update` | Update agents to latest |
+| `relay uninstall <name>` | Remove an agent |
+| `relay diff <name>` | See what changed between versions |
+
+All output is JSON by default (for AI agents). Add `--pretty` for human-readable format.
+
+---
+
+## How It Works
+
+```
+                    relay install @team/agent
+                            │
+                 ╭──────────┴──────────╮
+                 │   Relay Registry    │
+                 │  (relay.ax cloud)   │
+                 ╰──────────┬──────────╯
+                            │
+                 ╭──────────┴──────────╮
+                 │  relay agent spec   │
+                 │  (universal format) │
+                 ╰──┬───────┬───────┬──╯
+                    │       │       │
+              ┌─────┴─┐ ┌──┴───┐ ┌─┴──────┐
+              │Claude │ │Open  │ │nano    │
+              │ Code  │ │Claw  │ │claw    │
+              └───────┘ └──────┘ └────────┘
+```
+
+Relay resolves the right format for your harness automatically. Builders write one spec, users install with one command.
+
+---
+
+## AI-Native
+
+Relay is built for AI agents as first-class users. The CLI outputs structured JSON so agents can search, install, and manage other agents autonomously.
+
+```bash
+# An agent searching for tools
+relay search "database migration" | jq '.results[].slug'
+
+# An agent installing what it needs
+relay install @tools/db-migrate
+# → {"status":"ok","agent":"db-migrate","skills":["migrate","rollback","seed"]}
+```
+
+Relay also ships as an **MCP server**, so any MCP-compatible agent can use it directly:
+
+```bash
+relay mcp
+```
+
+---
+
+## Open Core
+
+The CLI and agent spec are open source (MIT). Build agents, publish them, self-host your own registry — no vendor lock-in.
+
+[relay.ax](https://relayax.com) provides the hosted registry with:
+- Private agent hosting
+- Organization management & access control
+- Usage analytics dashboard
+- Enterprise SSO & audit logs
+
+---
+
+## Community
+
+- [25+ production agents](https://relayax.com) ready to install
+- [Builder docs](https://relayax.com/docs) for creating your own
+- [Discord](#) for help and discussion
+
+---
+
+<p align="center">
+  <sub>Built by <a href="https://relayax.com">RelayAX</a></sub>
+</p>

package/dist/commands/access.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAccess(program: Command): void;

package/dist/commands/access.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAccess = registerAccess;
+const commander_1 = require("commander");
+const config_js_1 = require("../lib/config.js");
+async function claimAccess(slug, code) {
+    const token = await (0, config_js_1.getValidToken)();
+    if (!token) {
+        throw new Error('LOGIN_REQUIRED');
+    }
+    const res = await fetch(`${config_js_1.API_URL}/api/agents/${slug}/claim-access`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${token}`,
+        },
+        body: JSON.stringify({ code }),
+        signal: AbortSignal.timeout(10000),
+    });
+    const body = (await res.json().catch(() => ({})));
+    if (!res.ok) {
+        const errCode = body.error ?? String(res.status);
+        switch (errCode) {
+            case 'INVALID_LINK':
+                throw new Error('초대 링크가 유효하지 않거나 만료되었습니다.');
+            case 'NOT_FOUND':
+                throw new Error('에이전트를 찾을 수 없습니다.');
+            case 'UNAUTHORIZED':
+                throw new Error('LOGIN_REQUIRED');
+            default:
+                throw new Error(body.message ?? `접근 권한 요청 실패 (${res.status})`);
+        }
+    }
+    return body;
+}
+function registerAccess(program) {
+    program
+        .command('access <slug>')
+        .description('초대 코드로 에이전트에 접근 권한을 얻고 바로 설치합니다')
+        .requiredOption('--code <code>', '에이전트 초대 코드')
+        .action(async (slug, opts) => {
+        const json = program.opts().json ?? false;
+        try {
+            const result = await claimAccess(slug, opts.code);
+            if (!result.success || !result.agent) {
+                throw new Error('서버 응답이 올바르지 않습니다.');
+            }
+            const agentSlug = result.agent.slug;
+            if (json) {
+                console.log(JSON.stringify({ status: 'ok', agent: result.agent }));
+            }
+            else {
+                console.log(`\x1b[32m접근 권한이 부여되었습니다: ${result.agent.name}\x1b[0m`);
+                console.log(`\x1b[33m에이전트를 설치합니다: anpm install ${agentSlug}\x1b[0m\n`);
+            }
+            // Automatically install the agent
+            const { registerInstall } = await import('./install.js');
+            const subProgram = new commander_1.Command();
+            subProgram.option('--json', '구조화된 JSON 출력');
+            if (json)
+                subProgram.setOptionValue('json', true);
+            registerInstall(subProgram);
+            await subProgram.parseAsync(['node', 'relay', 'install', agentSlug]);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message === 'LOGIN_REQUIRED') {
+                if (json) {
+                    console.error(JSON.stringify({
+                        error: 'LOGIN_REQUIRED',
+                        message: '로그인이 필요합니다. anpm login을 먼저 실행하세요.',
+                        fix: 'anpm login 실행 후 재시도하세요.',
+                    }));
+                }
+                else {
+                    console.error('\x1b[31m오류: 로그인이 필요합니다.\x1b[0m');
+                    console.error('  anpm login을 먼저 실행하세요.');
+                }
+                process.exit(1);
+            }
+            if (json) {
+                console.error(JSON.stringify({ error: 'ACCESS_FAILED', message, fix: '접근 링크 코드를 확인하거나 에이전트 제작자에게 문의하세요.' }));
+            }
+            else {
+                console.error(`\x1b[31m오류: ${message}\x1b[0m`);
+            }
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/adopt.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAdopt(program: Command): void;

package/dist/commands/adopt.js

@@ -0,0 +1,177 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAdopt = registerAdopt;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const config_js_1 = require("../lib/config.js");
+const paths_js_1 = require("../lib/paths.js");
+const installer_js_1 = require("../lib/installer.js");
+const agent_status_js_1 = require("../lib/agent-status.js");
+function registerAdopt(program) {
+    program
+        .command('adopt [path]')
+        .description('Adopt unmanaged skills into anpm management')
+        .option('--all', 'Adopt all unmanaged skills')
+        .option('--global', 'Adopt to global scope')
+        .option('--project <dir>', 'Project root path')
+        .option('--yes', 'Skip confirmation prompts')
+        .action(async (inputPath, opts) => {
+        const json = program.opts().json ?? false;
+        const projectPath = (0, paths_js_1.resolveProjectPath)(opts.project);
+        const scope = opts.global ? 'global' : 'local';
+        try {
+            if (opts.all) {
+                // Adopt all unmanaged content
+                const unmanaged = (0, agent_status_js_1.findUnmanagedContent)(projectPath);
+                if (unmanaged.length === 0) {
+                    if (json)
+                        console.log(JSON.stringify({ status: 'ok', message: 'All content is already managed by anpm' }));
+                    else
+                        console.log('\x1b[32m✓\x1b[0m All content is already managed by anpm.');
+                    return;
+                }
+                if (!json) {
+                    console.log(`\nFound ${unmanaged.length} unmanaged item(s):\n`);
+                    for (const item of unmanaged) {
+                        console.log(`  ${item.type}/${item.name}  \x1b[90m(${item.harness})\x1b[0m`);
+                    }
+                }
+                if (!opts.yes && !json) {
+                    const { confirm } = await import('@inquirer/prompts');
+                    const ok = await confirm({ message: `Adopt all ${unmanaged.length} items?`, default: true });
+                    if (!ok) {
+                        process.exit(0);
+                    }
+                }
+                let adopted = 0;
+                for (const item of unmanaged) {
+                    try {
+                        await adoptSingle(item.path, item.name, scope, projectPath, json);
+                        adopted++;
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        if (!json)
+                            console.error(`  \x1b[33m⚠️ Skipping ${item.name}: ${msg}\x1b[0m`);
+                    }
+                }
+                if (json)
+                    console.log(JSON.stringify({ status: 'ok', adopted }));
+                else
+                    console.log(`\n\x1b[32m✓\x1b[0m Adopted ${adopted} item(s).`);
+                return;
+            }
+            // Single path adopt
+            if (!inputPath) {
+                console.error('Usage: anpm adopt <path> or anpm adopt --all');
+                process.exit(1);
+            }
+            const absPath = path_1.default.resolve(inputPath);
+            if (!fs_1.default.existsSync(absPath)) {
+                throw new Error(`Path not found: ${absPath}`);
+            }
+            // Check if already a relay symlink
+            try {
+                if (fs_1.default.lstatSync(absPath).isSymbolicLink()) {
+                    const target = fs_1.default.readlinkSync(absPath);
+                    if (target.includes('.relay/agents/')) {
+                        if (json)
+                            console.log(JSON.stringify({ status: 'ok', message: 'Already managed by anpm' }));
+                        else
+                            console.log(`\x1b[32m✓\x1b[0m Already managed by anpm.`);
+                        return;
+                    }
+                }
+            }
+            catch { /* not a symlink */ }
+            const name = path_1.default.basename(absPath);
+            await adoptSingle(absPath, name, scope, projectPath, json);
+            if (json) {
+                console.log(JSON.stringify({ status: 'ok', slug: `adopted/${name}` }));
+            }
+            else {
+                console.log(`\n\x1b[32m✓ Adopted ${name}\x1b[0m`);
+                console.log(`  Now managed by anpm and deployed to all detected harnesses.`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (json)
+                console.error(JSON.stringify({ error: 'ADOPT_FAILED', message }));
+            else
+                console.error(`\x1b[31m✖ ${message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+}
+async function adoptSingle(sourcePath, name, scope, projectPath, json) {
+    const baseDir = scope === 'global'
+        ? path_1.default.join(os_1.default.homedir(), '.relay', 'agents', 'local', name)
+        : path_1.default.join(projectPath, '.relay', 'agents', 'local', name);
+    // Detect what type of content this is (skill, command, rule)
+    // by looking at the parent directory name
+    const parentDir = path_1.default.basename(path_1.default.dirname(sourcePath));
+    const contentType = ['skills', 'commands', 'rules', 'agents'].includes(parentDir) ? parentDir : 'skills';
+    const destDir = path_1.default.join(baseDir, contentType, name);
+    // Safety: copy first, then symlink, then delete original
+    // 1. Copy to .relay/agents/
+    fs_1.default.mkdirSync(destDir, { recursive: true });
+    copyDirRecursive(sourcePath, destDir);
+    // 2. Verify copy exists
+    if (!fs_1.default.existsSync(destDir)) {
+        throw new Error(`Copy failed: ${destDir}`);
+    }
+    // 3. Remove original and replace with symlink
+    if (fs_1.default.lstatSync(sourcePath).isDirectory()) {
+        fs_1.default.rmSync(sourcePath, { recursive: true, force: true });
+    }
+    else {
+        fs_1.default.unlinkSync(sourcePath);
+    }
+    const relativeSrc = path_1.default.relative(path_1.default.dirname(sourcePath), destDir);
+    fs_1.default.symlinkSync(relativeSrc, sourcePath);
+    // 4. Deploy to other harnesses
+    const deploy = await (0, installer_js_1.deploySymlinks)(baseDir, scope, projectPath);
+    for (const w of deploy.warnings) {
+        if (!json)
+            console.error(`\x1b[33m${w}\x1b[0m`);
+    }
+    // 5. Record in installed.json
+    const slug = `adopted/${name}`;
+    const record = {
+        version: '0.0.0',
+        installed_at: new Date().toISOString(),
+        files: [baseDir],
+        deploy_scope: scope,
+        deployed_symlinks: [sourcePath, ...deploy.symlinks],
+        source: `adopted:${sourcePath}`,
+    };
+    if (scope === 'global') {
+        const installed = (0, config_js_1.loadGlobalInstalled)();
+        installed[slug] = record;
+        (0, config_js_1.saveGlobalInstalled)(installed);
+    }
+    else {
+        const installed = (0, config_js_1.loadInstalled)();
+        installed[slug] = record;
+        (0, config_js_1.saveInstalled)(installed);
+    }
+}
+function copyDirRecursive(src, dest) {
+    const stat = fs_1.default.statSync(src);
+    if (stat.isDirectory()) {
+        fs_1.default.mkdirSync(dest, { recursive: true });
+        for (const entry of fs_1.default.readdirSync(src, { withFileTypes: true })) {
+            if (entry.name.startsWith('.'))
+                continue;
+            copyDirRecursive(path_1.default.join(src, entry.name), path_1.default.join(dest, entry.name));
+        }
+    }
+    else {
+        fs_1.default.copyFileSync(src, dest);
+    }
+}

package/dist/commands/changelog.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerChangelog(program: Command): void;

package/dist/commands/changelog.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerChangelog = registerChangelog;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+function registerChangelog(program) {
+    const changelog = program
+        .command('changelog')
+        .description('에이전트 패키지의 changelog를 관리합니다');
+    changelog
+        .command('add')
+        .description('relay.yaml에 changelog 엔트리를 추가합니다')
+        .argument('[message]', 'changelog 메시지 (없으면 에디터에서 입력)')
+        .action(async (message) => {
+        const yamlPath = path_1.default.resolve('relay.yaml');
+        if (!fs_1.default.existsSync(yamlPath)) {
+            console.error('relay.yaml을 찾을 수 없습니다. 에이전트 패키지 디렉토리에서 실행하세요.');
+            process.exit(1);
+        }
+        const content = fs_1.default.readFileSync(yamlPath, 'utf-8');
+        const doc = js_yaml_1.default.load(content) ?? {};
+        if (!message) {
+            // Read from stdin if piped, otherwise prompt
+            const readline = await import('readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            message = await new Promise((resolve) => {
+                rl.question('Changelog 메시지: ', (answer) => {
+                    rl.close();
+                    resolve(answer);
+                });
+            });
+        }
+        if (!message || message.trim() === '') {
+            console.error('changelog 메시지가 비어있습니다.');
+            process.exit(1);
+        }
+        const version = String(doc.version ?? '1.0.0');
+        const date = new Date().toISOString().split('T')[0];
+        const entry = `## v${version} (${date})\n\n- ${message.trim()}`;
+        const existing = doc.changelog ? String(doc.changelog) : '';
+        doc.changelog = existing ? `${entry}\n\n${existing}` : entry;
+        fs_1.default.writeFileSync(yamlPath, js_yaml_1.default.dump(doc, { lineWidth: -1, noRefs: true }), 'utf-8');
+        console.log(`\x1b[32m✓\x1b[0m changelog 추가됨 (v${version})`);
+        console.log(`  ${message.trim()}`);
+    });
+    changelog
+        .command('show')
+        .description('현재 relay.yaml의 changelog를 표시합니다')
+        .action(() => {
+        const yamlPath = path_1.default.resolve('relay.yaml');
+        if (!fs_1.default.existsSync(yamlPath)) {
+            console.error('relay.yaml을 찾을 수 없습니다.');
+            process.exit(1);
+        }
+        const content = fs_1.default.readFileSync(yamlPath, 'utf-8');
+        const doc = js_yaml_1.default.load(content) ?? {};
+        if (!doc.changelog) {
+            console.log('changelog가 없습니다. `anpm changelog add "메시지"`로 추가하세요.');
+            return;
+        }
+        console.log(String(doc.changelog));
+    });
+}

package/dist/commands/check-update.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerCheckUpdate(program: Command): void;

package/dist/commands/check-update.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCheckUpdate = registerCheckUpdate;
+const version_check_js_1 = require("../lib/version-check.js");
+const slug_js_1 = require("../lib/slug.js");
+function registerCheckUpdate(program) {
+    program
+        .command('check-update [slug]')
+        .description('CLI 및 설치된 에이전트의 업데이트를 확인합니다')
+        .option('--quiet', '업데이트가 있을 때만 머신 리더블 출력')
+        .option('--force', '캐시를 무시하고 강제 체크')
+        .action(async (slug, opts) => {
+        const quiet = opts.quiet ?? false;
+        const force = opts.force ?? false;
+        // CLI version check
+        const cliResult = await (0, version_check_js_1.checkCliVersion)(force);
+        if (cliResult) {
+            if (quiet) {
+                console.log(`CLI_UPGRADE_AVAILABLE ${cliResult.current} ${cliResult.latest}`);
+            }
+            else {
+                console.log(`\n\x1b[33m⚠ anpm v${cliResult.latest} available\x1b[0m (현재 v${cliResult.current})`);
+                console.log(`  실행: npm update -g relayax-cli\n`);
+            }
+        }
+        // Agent version check
+        if (slug) {
+            // Resolve to scoped slug
+            let scopedSlug;
+            if ((0, slug_js_1.isScopedSlug)(slug)) {
+                scopedSlug = slug;
+            }
+            else {
+                try {
+                    const parsed = await (0, slug_js_1.resolveSlug)(slug);
+                    scopedSlug = parsed.full;
+                }
+                catch {
+                    scopedSlug = slug;
+                }
+            }
+            const agentResult = await (0, version_check_js_1.checkAgentVersion)(scopedSlug, force);
+            if (agentResult) {
+                if (quiet) {
+                    const byAuthor = agentResult.author ? ` ${agentResult.author}` : '';
+                    console.log(`AGENT_UPGRADE_AVAILABLE ${slug} ${agentResult.current} ${agentResult.latest}${byAuthor}`);
+                }
+                else {
+                    const byAuthor = agentResult.author ? ` \x1b[90m(by @${agentResult.author})\x1b[0m` : '';
+                    console.log(`\x1b[33m⚠ ${slug} v${agentResult.latest} available\x1b[0m${byAuthor} (현재 v${agentResult.current})`);
+                    console.log(`  실행: anpm update ${slug}`);
+                }
+            }
+            else if (!quiet && !cliResult) {
+                console.log('모든 것이 최신 상태입니다.');
+            }
+        }
+        else {
+            const agentResults = await (0, version_check_js_1.checkAllAgents)(force);
+            for (const result of agentResults) {
+                if (quiet) {
+                    const byAuthor = result.author ? ` ${result.author}` : '';
+                    console.log(`AGENT_UPGRADE_AVAILABLE ${result.slug} ${result.current} ${result.latest}${byAuthor}`);
+                }
+                else {
+                    const byAuthor = result.author ? ` \x1b[90m(by @${result.author})\x1b[0m` : '';
+                    console.log(`\x1b[33m⚠ ${result.slug} v${result.latest} available\x1b[0m${byAuthor} (현재 v${result.current})`);
+                    console.log(`  실행: anpm update ${result.slug}`);
+                }
+            }
+            if (!quiet && !cliResult && agentResults.length === 0) {
+                console.log('모든 것이 최신 상태입니다.');
+            }
+        }
+    });
+}

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerConfig(program: Command): void;