@metatell/bot-cli 0.0.5 → 0.0.7

package/README.md

@@ -1,63 +1,141 @@
-# @metatell/cli
+# @metatell/bot-cli
 
-CLI tool for Metatell bot development and testing.
+MetaTell Bot 開発とテスト用の CLI ツール。
 
-## Installation
+## 必要要件
+
+- Node.js 20 以上（推奨: 22+）
+
+## インストール
 
 ```bash
-npm install -g @metatell/cli
-```
+# グローバルインストール
+npm install -g @metatell/bot-cli
+
+# または npx で実行
+npx @metatell/bot-cli <command>
 
-## Usage
+# または開発依存として
+npm install --save-dev @metatell/bot-cli
+```
 
-### Interactive Mode (Default)
+## 使い方
 
 ```bash
-# 未ログインで入室
+# インタラクティブモード（デフォルト）
 metatell-cli https://metatell.app/ROOM_ID
 
-# ログイン済みユーザーとして入室
+# 認証トークン付き
 metatell-cli https://metatell.app/ROOM_ID -t "your-auth-token"
+
+# カスタムボット名
+metatell-cli https://metatell.app/ROOM_ID -n "MyBot"
+
+# デバッグログ有効
+metatell-cli https://metatell.app/ROOM_ID -d
+```
+
+## コマンド
+
+### インタラクティブモード
+
+```bash
+metatell-cli https://metatell.app/ROOM_ID [options]
+# または
+metatell-cli interactive https://metatell.app/ROOM_ID [options]
 ```
 
-Interactive mode provides:
-- Real-time event monitoring
-- Simple chat interface
-- Commands: `status`, `users`, `quit`
+**利用可能なコマンド:**
+- `/say <message>` — チャットメッセージ送信
+- `/move <x> <y> <z>` — アバター移動
+- `/look <x> <y> <z>` または `/look @<username>` — 指定座標/ユーザーを見る
+- `/nearby [radius]` — 近傍ユーザーを表示（既定 10m）
+- `/users` — ルーム内の全ユーザーを表示
+- `/status` — 接続状態を表示
+- `/info` — ボット情報を表示
+- `/avatar <id>` — アバターを変更
+- `/assets` — 利用可能なアバター一覧
+- `/anime <name>` または `/animation <name>` — アニメーション再生
+- `/animations` — 利用可能なアニメーション一覧
+- `/stop` — アニメーション停止（アイドルに戻す）
+- `quit` / `exit` — 終了
+
+### 接続テストコマンド
 
-### Connect Command
+```bash
+metatell-cli connect https://metatell.app/ROOM_ID [options]
+```
 
-Quick connection test:
+### ルーム検査コマンド
 
 ```bash
-# 未ログインで接続テスト
-metatell-cli connect https://metatell.app/ROOM_ID
+metatell-cli inspect https://metatell.app/ROOM_ID [options]
 ```
 
-### Inspect Command
+## オプション
+
+| オプション | エイリアス | 説明 | デフォルト |
+|--------|-------|-------------|---------|
+| `--token` | `-t` | 認証トークン（任意） | `METATELL_TOKEN` 環境変数 |
+| `--name` | `-n` | ボット表示名 | "MetatellCLI" |
+| `--debug` | `-d` | デバッグログ有効 | false |
+
+## 環境変数
 
-Room inspection and monitoring:
+- `METATELL_TOKEN` — デフォルト認証トークン（任意）
+
+## 開発
+
+### ローカル開発環境のセットアップ
+
+CLIをローカルで開発・テストする場合の手順：
 
 ```bash
-# ルーム情報の確認
-metatell-cli inspect https://metatell.app/ROOM_ID
+# 1. リポジトリをクローン
+git clone https://github.com/urth-inc/metatell-ai-bot.git
+cd metatell-ai-bot
+
+# 2. 依存関係をインストール
+npm install
+
+# 3. CLIパッケージへ移動
+cd packages/cli
+
+# 4. ビルド
+npm run build
+
+# 5. ローカルにリンク（グローバルコマンドとして登録）
+npm link
+
+# 6. 動作確認
+metatell-cli --version
+metatell-cli --help
 ```
 
-### Options
+### 開発時の便利なコマンド
 
-- `-t, --token <token>`: Authentication token (optional - 未ログインでも入室可能)
-- `-n, --name <name>`: Bot display name (interactive mode)
-- `-d, --debug`: Enable debug logging
+```bash
+# TypeScriptをウォッチモードでコンパイル
+npm run dev
+
+# ビルド
+npm run build
+
+# 型チェック
+npm run typecheck
+
+# テスト実行（ルートディレクトリから）
+cd ../.. && npm test packages/cli/src/cli.spec.ts
+```
+
+### アンリンク（クリーンアップ）
 
-### Environment Variables
+開発が終了したら、グローバルリンクを削除：
 
-- `METATELL_TOKEN`: Default authentication token (optional)
+```bash
+npm unlink -g @metatell/bot-cli
+```
 
-## Features
+## License
 
-- Simple connection testing
-- Room state inspection
-- Interactive command-line interface
-- User presence monitoring
-- Message activity tracking
-- Clean implementation using SDK facade API
+MIT

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/cli.js

@@ -1,31 +1,37 @@
 #!/usr/bin/env node
-"use strict";
 /**
  * Metatell CLI - Interactive tool for bot development and testing
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var commander_1 = require("commander");
-var connect_js_1 = require("./commands/connect.js");
-var inspect_js_1 = require("./commands/inspect.js");
-var interactive_js_1 = require("./commands/interactive.js");
-var program = new commander_1.Command();
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Command } from 'commander';
+import { connectCommand } from './commands/connect.js';
+import { inspectCommand } from './commands/inspect.js';
+import { startInteractiveMode } from './commands/interactive.js';
+// パッケージのバージョンを動的に取得
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+const version = packageJson.version;
+const program = new Command();
 program
     .name('metatell-cli')
     .description('CLI tool for Metatell bot development and testing')
-    .version('1.0.0');
+    .version(version);
 // Connect command - Simple connection test
 program
     .command('connect <url>')
     .description('Connect to a Metatell room and show basic info')
     .option('-t, --token <token>', 'Authentication token')
     .option('-d, --debug', 'Enable debug logging')
-    .action(connect_js_1.connectCommand);
+    .action(connectCommand);
 // Inspect command - Room inspection
 program
     .command('inspect <url>')
     .description('Inspect room state and user presence')
     .option('-t, --token <token>', 'Authentication token')
-    .action(inspect_js_1.inspectCommand);
+    .action(inspectCommand);
 // Interactive mode (default)
 program
     .command('interactive <url>')
@@ -34,14 +40,14 @@ program
     .option('-t, --token <token>', 'Authentication token')
     .option('-n, --name <name>', 'Bot display name', 'MetatellCLI')
     .option('-d, --debug', 'Enable debug logging')
-    .action(interactive_js_1.startInteractiveMode);
+    .action(startInteractiveMode);
 // Default to interactive mode
 program
     .arguments('<url>')
     .option('-t, --token <token>', 'Authentication token')
     .option('-n, --name <name>', 'Bot display name', 'MetatellCLI')
     .option('-d, --debug', 'Enable debug logging')
-    .action(function (url, options) {
-    (0, interactive_js_1.startInteractiveMode)(url, options);
+    .action((url, options) => {
+    startInteractiveMode(url, options);
 });
 program.parse();

package/dist/commands/connect.js

@@ -1,91 +1,36 @@
-"use strict";
 /**
  * Simple connection test command
  */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.connectCommand = connectCommand;
-var bot_sdk_1 = require("@metatell/bot-sdk");
-var url_js_1 = require("../utils/url.js");
-function connectCommand(url, options) {
-    return __awaiter(this, void 0, void 0, function () {
-        var _a, serverUrl, roomId, client, users, error_1;
-        return __generator(this, function (_b) {
-            switch (_b.label) {
-                case 0:
-                    console.log('Connecting to:', url);
-                    _b.label = 1;
-                case 1:
-                    _b.trys.push([1, 4, , 5]);
-                    _a = (0, url_js_1.parseUrl)(url), serverUrl = _a.serverUrl, roomId = _a.roomId;
-                    client = (0, bot_sdk_1.createMetatellClient)({
-                        serverUrl: serverUrl,
-                        roomId: roomId,
-                        token: options.token || process.env.METATELL_TOKEN || '',
-                        username: 'MetatellCLI',
-                        debug: options.debug,
-                    });
-                    return [4 /*yield*/, client.connect()];
-                case 2:
-                    _b.sent();
-                    console.log('✓ Connected successfully!');
-                    console.log('Session ID:', client.getSessionId());
-                    console.log('Status:', client.getStatus());
-                    users = client.getUsers();
-                    console.log("\nUsers in room: ".concat(users.length));
-                    users.forEach(function (user) {
-                        console.log("- ".concat(user.name || 'Anonymous', " (").concat(user.id, ")").concat(user.isBot ? ' [Bot]' : ''));
-                    });
-                    // Clean disconnect
-                    return [4 /*yield*/, client.disconnect()];
-                case 3:
-                    // Clean disconnect
-                    _b.sent();
-                    console.log('\n✓ Disconnected successfully');
-                    process.exit(0);
-                    return [3 /*break*/, 5];
-                case 4:
-                    error_1 = _b.sent();
-                    console.error('Connection failed:', error_1);
-                    process.exit(1);
-                    return [3 /*break*/, 5];
-                case 5: return [2 /*return*/];
-            }
+import { createMetatellClient } from '@metatell/bot-sdk';
+import { parseUrl } from '../utils/url.js';
+export async function connectCommand(url, options) {
+    console.log('Connecting to:', url);
+    try {
+        const { serverUrl, roomId } = parseUrl(url);
+        const client = createMetatellClient({
+            serverUrl,
+            roomId,
+            token: options.token || process.env.METATELL_TOKEN || '',
+            username: 'MetatellCLI',
+            debug: options.debug,
+        });
+        await client.connect();
+        console.log('✓ Connected successfully!');
+        console.log('Session ID:', client.getSessionId());
+        console.log('Status:', client.getStatus());
+        // Show presence info
+        const users = client.getUsers();
+        console.log(`\nUsers in room: ${users.length}`);
+        users.forEach((user) => {
+            console.log(`- ${user.name || 'Anonymous'} (${user.id})${user.isBot ? ' [Bot]' : ''}`);
         });
-    });
+        // Clean disconnect
+        await client.disconnect();
+        console.log('\n✓ Disconnected successfully');
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Connection failed:', error);
+        process.exit(1);
+    }
 }

package/dist/commands/inspect.js

@@ -1,113 +1,56 @@
-"use strict";
 /**
  * Room inspection command
  */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.inspectCommand = inspectCommand;
-var bot_sdk_1 = require("@metatell/bot-sdk");
-var url_js_1 = require("../utils/url.js");
-function inspectCommand(url, options) {
-    return __awaiter(this, void 0, void 0, function () {
-        var _a, serverUrl, roomId, client, users, humans, bots, messageCount_1, joinCount_1, leaveCount_1, error_1;
-        return __generator(this, function (_b) {
-            switch (_b.label) {
-                case 0:
-                    console.log('Inspecting room:', url);
-                    _b.label = 1;
-                case 1:
-                    _b.trys.push([1, 5, , 6]);
-                    _a = (0, url_js_1.parseUrl)(url), serverUrl = _a.serverUrl, roomId = _a.roomId;
-                    client = (0, bot_sdk_1.createMetatellClient)({
-                        serverUrl: serverUrl,
-                        roomId: roomId,
-                        token: options.token || process.env.METATELL_TOKEN || '',
-                        username: 'MetatellInspector',
-                        debug: false, // Keep quiet for inspection
-                    });
-                    return [4 /*yield*/, client.connect()];
-                case 2:
-                    _b.sent();
-                    console.log('\n=== Room Information ===');
-                    console.log('Room ID:', roomId);
-                    console.log('Server:', serverUrl);
-                    console.log('Session:', client.getSessionId());
-                    users = client.getUsers();
-                    console.log('\n=== User Presence ===');
-                    console.log("Total users: ".concat(users.length));
-                    humans = users.filter(function (u) { return !u.isBot; });
-                    bots = users.filter(function (u) { return u.isBot; });
-                    console.log("Humans: ".concat(humans.length));
-                    console.log("Bots: ".concat(bots.length));
-                    if (users.length > 0) {
-                        console.log('\nDetailed list:');
-                        users.forEach(function (user) {
-                            var type = user.isBot ? '[Bot]' : '[Human]';
-                            console.log("  ".concat(type, " ").concat(user.name || 'Anonymous', " (").concat(user.id, ")"));
-                        });
-                    }
-                    // Listen for a few seconds to detect activity
-                    console.log('\n=== Monitoring Activity (5 seconds) ===');
-                    messageCount_1 = 0;
-                    joinCount_1 = 0;
-                    leaveCount_1 = 0;
-                    client.on('message', function () { return messageCount_1++; });
-                    client.on('user-join', function () { return joinCount_1++; });
-                    client.on('user-leave', function () { return leaveCount_1++; });
-                    return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 5000); })];
-                case 3:
-                    _b.sent();
-                    console.log("Messages: ".concat(messageCount_1));
-                    console.log("Users joined: ".concat(joinCount_1));
-                    console.log("Users left: ".concat(leaveCount_1));
-                    return [4 /*yield*/, client.disconnect()];
-                case 4:
-                    _b.sent();
-                    console.log('\n✓ Inspection complete');
-                    process.exit(0);
-                    return [3 /*break*/, 6];
-                case 5:
-                    error_1 = _b.sent();
-                    console.error('Inspection failed:', error_1);
-                    process.exit(1);
-                    return [3 /*break*/, 6];
-                case 6: return [2 /*return*/];
-            }
+import { createMetatellClient } from '@metatell/bot-sdk';
+import { parseUrl } from '../utils/url.js';
+export async function inspectCommand(url, options) {
+    console.log('Inspecting room:', url);
+    try {
+        const { serverUrl, roomId } = parseUrl(url);
+        const client = createMetatellClient({
+            serverUrl,
+            roomId,
+            token: options.token || process.env.METATELL_TOKEN || '',
+            username: 'MetatellInspector',
+            debug: false, // Keep quiet for inspection
         });
-    });
+        await client.connect();
+        console.log('\n=== Room Information ===');
+        console.log('Room ID:', roomId);
+        console.log('Server:', serverUrl);
+        console.log('Session:', client.getSessionId());
+        const users = client.getUsers();
+        console.log('\n=== User Presence ===');
+        console.log(`Total users: ${users.length}`);
+        const humans = users.filter((u) => !u.isBot);
+        const bots = users.filter((u) => u.isBot);
+        console.log(`Humans: ${humans.length}`);
+        console.log(`Bots: ${bots.length}`);
+        if (users.length > 0) {
+            console.log('\nDetailed list:');
+            users.forEach((user) => {
+                const type = user.isBot ? '[Bot]' : '[Human]';
+                console.log(`  ${type} ${user.name || 'Anonymous'} (${user.id})`);
+            });
+        }
+        // Listen for a few seconds to detect activity
+        console.log('\n=== Monitoring Activity (5 seconds) ===');
+        let messageCount = 0;
+        let joinCount = 0;
+        let leaveCount = 0;
+        client.on('message', () => messageCount++);
+        client.on('user-join', () => joinCount++);
+        client.on('user-leave', () => leaveCount++);
+        await new Promise((resolve) => setTimeout(resolve, 5000));
+        console.log(`Messages: ${messageCount}`);
+        console.log(`Users joined: ${joinCount}`);
+        console.log(`Users left: ${leaveCount}`);
+        await client.disconnect();
+        console.log('\n✓ Inspection complete');
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Inspection failed:', error);
+        process.exit(1);
+    }
 }