@agentarea/cli 0.1.0

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@agentarea/cli",
+  "version": "0.1.0",
+  "description": "Interactive CLI for AgentArea — authenticate, discover agents, submit tasks, and monitor real-time execution via SSE.",
+  "license": "Apache-2.0",
+  "author": "AgentArea",
+  "homepage": "https://github.com/agentarea/agentarea/tree/main/agentarea-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentarea/agentarea.git",
+    "directory": "agentarea-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/agentarea/agentarea/issues"
+  },
+  "keywords": [
+    "agentarea",
+    "cli",
+    "agents",
+    "ai",
+    "ink",
+    "sse"
+  ],
+  "bin": {
+    "agentarea": "dist/cli.js"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=16"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ink": "^4.1.0",
+    "meow": "^11.0.0",
+    "react": "^18.2.0",
+    "axios": "^1.16.1",
+    "eventsource": "^2.0.2",
+    "@zowe/secrets-for-zowe-sdk": "^8.8.3",
+    "async-exit-hook": "^2.0.1",
+    "conf": "^12.0.0"
+  },
+  "devDependencies": {
+    "@sindresorhus/tsconfig": "^8.1.0",
+    "@types/react": "^18.0.32",
+    "@types/node": "^20.0.0",
+    "@types/eventsource": "^1.1.11",
+    "@vdemedes/prettier-config": "^2.0.1",
+    "ava": "^5.2.0",
+    "chalk": "^5.2.0",
+    "eslint": "^9.39.4",
+    "eslint-config-xo-react": "^0.30.1",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "ink-testing-library": "^3.0.0",
+    "prettier": "^2.8.7",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3",
+    "webpack": "^5.106.1",
+    "xo": "^0.61.1"
+  },
+  "ava": {
+    "extensions": {
+      "ts": "module",
+      "tsx": "module"
+    },
+    "nodeArguments": [
+      "--loader=ts-node/esm"
+    ]
+  },
+  "xo": {
+    "react": true,
+    "semicolon": true,
+    "prettier": true,
+    "rules": {
+      "react/prop-types": "off",
+      "unicorn/expiring-todo-comments": "off"
+    }
+  },
+  "prettier": "@vdemedes/prettier-config",
+  "overrides": {
+    "@eslint/plugin-kit@<0.3.4": "0.7.1",
+    "axios@>=1.0.0 <1.15.2": "1.16.1",
+    "brace-expansion@<1.1.13": "1.1.14",
+    "brace-expansion@>=4.0.0 <5.0.6": "5.0.6",
+    "diff@>=4.0.0 <4.0.4": "4.0.4",
+    "fast-uri@<=3.1.1": "3.1.2",
+    "json-schema-typed@8.0.1": "8.0.2",
+    "minimatch@>=3.0.0 <3.1.5": "3.1.5",
+    "ws@>=8.0.0 <8.20.1": "8.21.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "prettier --check . && xo",
+    "test": "prettier --check . && tsc --noEmit"
+  }
+}

package/readme.md

@@ -0,0 +1,229 @@
+# agentarea-cli
+
+Interactive CLI for Agent Management using Ink. Authenticate, discover agents, submit tasks, and monitor real-time execution output via Server-Sent Events (SSE).
+
+## Features
+
+- 🔐 **Authentication**: Secure login with token persistence in OS keychain
+- 👥 **Agent Discovery**: List and filter available agents by status and capabilities
+- 📋 **Task Submission**: Submit tasks with configurable parameters to agents
+- 🔄 **Real-time Streaming**: Monitor task execution with live output streaming via SSE
+- ⌨️ **Interactive CLI**: Responsive Ink-based interface with keyboard navigation
+- 🛡️ **Error Handling**: Graceful error handling with user-friendly messages
+
+## Installation
+
+```bash
+# Install globally
+npm install --global agentarea-cli
+
+# Or run locally
+npm install
+npm run build
+npm start
+```
+
+## Quick Start
+
+```bash
+$ agentarea-cli
+
+# First time: You'll be prompted to login
+[?] Email: your.email@example.com
+[?] Password: ••••••••
+
+# Then: Select an agent and submit a task
+[?] Select agent: Agent-1 (online)
+[?] Task title: Run Analysis
+[?] Parameters: {"dataset": "data.csv"}
+
+# Finally: Watch real-time output
+Running analysis...
+Processing: 50%
+✓ Analysis complete!
+```
+
+## Usage
+
+### Login
+
+```bash
+$ agentarea-cli
+# Prompts for email and password
+# Token stored securely in OS keychain
+```
+
+### List Agents
+
+After login, select "List Agents" to:
+
+- View all available agents
+- See agent status (online/offline/busy)
+- View agent capabilities
+- Filter by status or search by name
+
+### Submit Task
+
+After selecting an agent:
+
+1. Enter task title
+2. Provide task description (optional)
+3. Configure parameters
+4. Confirm submission
+
+### Monitor Execution
+
+Once task is submitted:
+
+- Real-time stdout/stderr output displayed
+- Progress indicators updated
+- Status changes shown
+- Completion or failure reported
+
+## Configuration
+
+Create a `.env` file based on `.env.example`:
+
+```bash
+# API Configuration
+API_URL=http://localhost:3000
+API_TIMEOUT=30000
+MAX_RETRIES=3
+
+# Logging
+LOG_LEVEL=info
+
+# UI
+THEME=auto
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Watch mode
+npm run dev
+
+# Build
+npm run build
+
+# Test
+npm test
+
+# Lint and format
+npm run test
+```
+
+## Architecture
+
+```
+source/
+├── cli.tsx              # CLI entry point with meow parser
+├── app.tsx              # Main application component
+├── components/          # Ink UI components
+├── services/            # API clients and business logic
+├── hooks/               # React hooks for state management
+├── context/             # React context providers
+├── utils/               # Utility functions
+└── types/               # TypeScript type definitions
+```
+
+## API Requirements
+
+The CLI expects the following API endpoints:
+
+### Authentication
+
+- `POST /auth/login` - Login with credentials
+- `POST /auth/refresh` - Refresh access token
+- `POST /auth/logout` - Logout and invalidate token
+
+### Agents
+
+- `GET /agents` - List available agents
+- `GET /agents/{agentId}` - Get agent details
+- `GET /agents/{agentId}/capabilities` - Get agent capabilities
+
+### Tasks
+
+- `POST /tasks` - Submit a new task
+- `GET /tasks` - List tasks
+- `GET /tasks/{taskId}` - Get task details
+- `DELETE /tasks/{taskId}` - Cancel a task
+- `GET /sse/tasks/{taskId}` - SSE stream for task output
+
+## Authentication
+
+Credentials are stored securely:
+
+- **macOS**: Keychain
+- **Linux**: Secret Service (requires `libsecret`)
+- **Windows**: Credential Manager
+
+Token is automatically:
+
+- Retrieved on app startup
+- Refreshed before expiration
+- Cleared on logout
+
+## Keyboard Shortcuts
+
+| Key    | Action           |
+| ------ | ---------------- |
+| ↑/↓    | Navigate options |
+| Enter  | Select/Submit    |
+| q      | Back to menu     |
+| Escape | Cancel           |
+| Ctrl+C | Exit CLI         |
+
+## Testing
+
+```bash
+# Run all tests
+npm test
+
+# Watch mode
+npm run test -- --watch
+
+# With coverage
+npm run test -- --coverage
+```
+
+## Troubleshooting
+
+### "Cannot find module"
+
+```bash
+npm install
+npm run build
+```
+
+### Keychain errors
+
+```bash
+# Linux: Install libsecret
+sudo apt-get install libsecret-1-dev
+
+# Then rebuild
+npm rebuild
+```
+
+### API connection errors
+
+1. Check API_URL in .env
+2. Verify API server is running
+3. Check network connectivity
+4. Enable debug logging: `LOG_LEVEL=debug`
+
+## License
+
+MIT
+
+## See Also
+
+- [Feature Specification](../specs/001-ink-cli/spec.md)
+- [Implementation Plan](../specs/001-ink-cli/plan.md)
+- [API Contracts](../specs/001-ink-cli/contracts/)
+- [Data Model](../specs/001-ink-cli/data-model.md)