@amaster.ai/runtime-cli 1.0.0-beta.72

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amaster Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,274 @@
+# @amaster.ai/runtime-cli
+
+Unified CLI for Amaster SDK and OpenClaw integration. Manage entities, BPM processes, workflows, S3 files, authentication, and OpenClaw skills from a single command-line interface.
+
+## Features
+
+- **Authentication**: Login, logout, register users, manage sessions
+- **Entity Management**: CRUD operations on entities with type-safe API
+- **BPM**: Manage Camunda processes, tasks, and instances
+- **Workflow**: Execute and monitor workflows
+- **S3 Storage**: Upload, download, list, and manage files
+- **OpenClaw Integration**: Initialize app-specific skills and MCP servers for AI assistants
+
+## Installation
+
+```bash
+npm install -g @amaster.ai/runtime-cli
+```
+
+Or use with npx:
+
+```bash
+npx @amaster.ai/runtime-cli
+```
+
+### Automatic Cleanup
+
+When you uninstall `@amaster.ai/runtime-cli`, it will automatically clean up the OpenClaw integration for the configured app:
+
+```bash
+npm uninstall -g @amaster.ai/runtime-cli
+# Automatically removes skills and MCP servers
+```
+
+To skip automatic cleanup:
+
+```bash
+npm_config_ignore_scripts=1 npm uninstall -g @amaster.ai/runtime-cli
+```
+
+## Quick Start
+
+### 1. Configure the CLI
+
+```bash
+# Set your API key
+amaster config set apiKey YOUR_API_KEY
+
+# Set base URL (optional, defaults to https://api.amaster.ai)
+amaster config set baseURL https://api.amaster.ai
+
+# View configuration
+amaster config list
+```
+
+### 2. Authenticate
+
+```bash
+# Login
+amaster login
+
+# Or with options
+amaster login --email user@example.com --password secret
+
+# Check who you are
+amaster whoami
+```
+
+### 3. Use SDK Features
+
+```bash
+# List entities
+amaster entity list myapp users
+
+# Get a specific entity
+amaster entity get myapp users 123
+
+# Create an entity
+amaster entity create myapp users --data '{"name":"John","email":"john@example.com"}'
+
+# List BPM processes
+amaster bpm processes
+
+# Start a process
+amaster bpm start my-process --variables '{"key":"value"}'
+
+# List workflows
+amaster workflow list
+
+# Execute a workflow
+amaster workflow execute my-workflow --input '{"data":"value"}'
+
+# List S3 files
+amaster s3 list
+
+# Upload a file
+amaster s3 upload ./myfile.pdf --bucket mybucket --key documents/myfile.pdf
+```
+
+### 4. Setup OpenClaw Integration
+
+Initialize OpenClaw integration for a specific app (downloads app-specific skills and MCP servers):
+
+```bash
+# Initialize for an app
+amaster init --app-code myapp
+
+# With API key
+amaster init --app-code myapp --api-key YOUR_API_KEY
+
+# Force reinitialize
+amaster init --app-code myapp --force
+```
+
+Check integration status:
+
+```bash
+amaster doctor
+```
+
+List installed components:
+
+```bash
+amaster list
+```
+
+Switch to a different app:
+
+```bash
+amaster switch another-app
+```
+
+Remove integration for current app:
+
+```bash
+amaster uninstall --yes
+```
+
+## Commands
+
+### Configuration
+
+```bash
+amaster config set <key> <value>    # Set config value
+amaster config get <key>            # Get config value
+amaster config list                 # List all config
+```
+
+### Authentication
+
+```bash
+amaster login [options]             # Login with email/password
+amaster logout                      # Logout
+amaster whoami                      # Show current user
+amaster register [options]          # Register new user
+amaster users [options]             # List users
+```
+
+### Entity Management
+
+```bash
+amaster entity list <app> <entity> [options]
+amaster entity get <app> <entity> <id>
+amaster entity create <app> <entity> [options]
+amaster entity update <app> <entity> <id> [options]
+amaster entity delete <app> <entity> <id>
+amaster entity types <app>
+```
+
+### BPM
+
+```bash
+amaster bpm processes               # List process definitions
+amaster bpm start <key> [options]   # Start process instance
+amaster bpm tasks [options]         # List tasks
+amaster bpm complete <id> [options] # Complete task
+amaster bpm claim <id> [options]    # Claim task
+amaster bpm instances               # List process instances
+amaster bpm instance <id>           # Get instance details
+```
+
+### Workflow
+
+```bash
+amaster workflow list               # List workflows
+amaster workflow get <id>           # Get workflow details
+amaster workflow execute <id> [options]
+amaster workflow executions [options]
+amaster workflow execution <id>
+```
+
+### S3 Storage
+
+```bash
+amaster s3 list [options]           # List files
+amaster s3 upload <file> [options]  # Upload file
+amaster s3 download <key> [options] # Download file
+amaster s3 delete <key> [options]   # Delete file
+amaster s3 url <key> [options]      # Get file URL
+```
+
+### OpenClaw Integration
+
+```bash
+amaster init [options]              # Initialize integration for an app
+amaster doctor                      # Check integration status
+amaster list                        # List installed skills and MCP servers
+amaster switch <app-code> [options] # Switch to a different app
+amaster uninstall [options]         # Remove integration for current app
+```
+
+## Configuration
+
+Configuration is stored in `~/.amaster/cli-config.json`.
+
+### Environment Variables
+
+- `AMASTER_API_KEY` - Your Amaster API key
+- `AMASTER_BASE_URL` - Base URL for API (default: https://api.amaster.ai)
+
+### File Locations
+
+- CLI Config: `~/.amaster/cli-config.json`
+- OpenClaw Config: `~/.openclaw/config.json`
+- Installed Skills: `~/.openclaw/skills/{appCode}/`
+- Amaster Config: `~/.amaster/openclaw-config.json`
+
+## OSS Structure
+
+The CLI expects skills and MCP configurations to be organized by app code in OSS:
+
+```
+/openclaw/
+├── apps/
+│   ├── {appCode1}/
+│   │   ├── skills/
+│   │   │   ├── manifest.json       # Skills manifest for this app
+│   │   │   └── {skill-id}.zip      # Skill packages
+│   │   └── mcp-config.yaml         # MCP server config for this app
+│   └── {appCode2}/
+│       ├── skills/
+│       └── mcp-config.yaml
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm run build
+
+# Development mode
+pnpm run dev
+
+# Type check
+pnpm run type-check
+```
+
+## Architecture
+
+The CLI integrates all Amaster SDK clients:
+
+- `@amaster.ai/client` - Unified client for all services
+- `@amaster.ai/auth-client` - Authentication
+- `@amaster.ai/entity-client` - Entity CRUD
+- `@amaster.ai/bpm-client` - BPM processes
+- `@amaster.ai/workflow-client` - Workflow execution
+- `@amaster.ai/s3-client` - File storage
+
+## License
+
+MIT