12abdfe81d
Implements FED-010: Agent Spawn via Federation feature that enables spawning and managing Claude agents on remote federated Mosaic Stack instances via COMMAND message type. Features: - Federation agent command types (spawn, status, kill) - FederationAgentService for handling agent operations - Integration with orchestrator's agent spawner/lifecycle services - API endpoints for spawning, querying status, and killing agents - Full command routing through federation COMMAND infrastructure - Comprehensive test coverage (12/12 tests passing) Architecture: - Hub → Spoke: Spawn agents on remote instances - Command flow: FederationController → FederationAgentService → CommandService → Remote Orchestrator - Response handling: Remote orchestrator returns agent status/results - Security: Connection validation, signature verification Files created: - apps/api/src/federation/types/federation-agent.types.ts - apps/api/src/federation/federation-agent.service.ts - apps/api/src/federation/federation-agent.service.spec.ts Files modified: - apps/api/src/federation/command.service.ts (agent command routing) - apps/api/src/federation/federation.controller.ts (agent endpoints) - apps/api/src/federation/federation.module.ts (service registration) - apps/orchestrator/src/api/agents/agents.controller.ts (status endpoint) - apps/orchestrator/src/api/agents/agents.module.ts (lifecycle integration) Testing: - 12/12 tests passing for FederationAgentService - All command service tests passing - TypeScript compilation successful - Linting passed Refs #93 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
101 lines
2.2 KiB
Markdown
101 lines
2.2 KiB
Markdown
# Mosaic Brain Skill
|
|
|
|
A Clawdbot skill for integrating with Mosaic Stack's Ideas/Brain API.
|
|
|
|
## Features
|
|
|
|
- **Quick Brain Dump**: Capture ideas rapidly with `capture` command
|
|
- **Semantic Search**: Query your knowledge base using natural language
|
|
- **Full CRUD**: Create, read, update, delete ideas with rich metadata
|
|
- **Tag Management**: Organize ideas with tags
|
|
- **Flexible Queries**: Filter by status, tags, dates, and more
|
|
|
|
## Installation
|
|
|
|
1. Copy this skill to your Clawdbot skills directory or link it:
|
|
|
|
```bash
|
|
ln -s ~/src/mosaic-stack/packages/skills/brain ~/.config/clawdbot/skills/mosaic-brain
|
|
```
|
|
|
|
2. Configure your Mosaic Stack connection:
|
|
|
|
```bash
|
|
mkdir -p ~/.config/mosaic
|
|
cat > ~/.config/mosaic/brain.conf <<EOF
|
|
MOSAIC_API_URL=http://localhost:3001
|
|
MOSAIC_WORKSPACE_ID=your-workspace-uuid
|
|
MOSAIC_API_TOKEN=your-auth-token
|
|
EOF
|
|
```
|
|
|
|
3. Verify setup:
|
|
```bash
|
|
./brain.sh list --limit 5
|
|
```
|
|
|
|
## Usage
|
|
|
|
See [SKILL.md](./SKILL.md) for detailed usage documentation.
|
|
|
|
### Quick Examples
|
|
|
|
```bash
|
|
# Capture a quick thought
|
|
./brain.sh capture "Need to implement user authentication for the new app"
|
|
|
|
# Create detailed idea
|
|
./brain.sh create \
|
|
--title "Authentication System" \
|
|
--content "Implement OAuth2 + JWT auth..." \
|
|
--tags "backend,security,auth" \
|
|
--priority "HIGH"
|
|
|
|
# Search semantically
|
|
./brain.sh query "What did I say about authentication?"
|
|
|
|
# List recent ideas
|
|
./brain.sh list --limit 10
|
|
|
|
# Update an idea
|
|
./brain.sh update <id> --status "IN_PROGRESS" --add-tags "urgent"
|
|
```
|
|
|
|
## API Reference
|
|
|
|
This skill interfaces with the following Mosaic Stack endpoints:
|
|
|
|
- `POST /api/ideas/capture` - Quick capture
|
|
- `POST /api/ideas` - Create full idea
|
|
- `GET /api/ideas` - List ideas
|
|
- `GET /api/ideas/:id` - Get idea
|
|
- `PATCH /api/ideas/:id` - Update idea
|
|
- `DELETE /api/ideas/:id` - Delete idea
|
|
- `POST /api/brain/query` - Semantic query
|
|
- `GET /api/brain/search` - Keyword search
|
|
|
|
## Development
|
|
|
|
### Requirements
|
|
|
|
- `curl` - HTTP client
|
|
- `jq` - JSON processor
|
|
- Mosaic Stack API running and accessible
|
|
|
|
### Testing
|
|
|
|
```bash
|
|
# Test capture
|
|
./brain.sh capture "Test idea $(date)"
|
|
|
|
# Test search
|
|
./brain.sh search "test"
|
|
|
|
# Test query
|
|
./brain.sh query "recent test ideas"
|
|
```
|
|
|
|
## License
|
|
|
|
Part of the Mosaic Stack ecosystem.
|