Administrative HTTP RPC Plane - Hiroshi OS

Hiroshi features a local administrative HTTP RPC server providing operational endpoints for status queries, instant vision screenshots, and manual messaging bypasses.

🔑 1. Setup Instructions

To activate the administrative control plane, configure rpc parameters inside config.toml:

[rpc]
enabled = true
port = 3999
secret_token = "your-cryptographic-token-here"

📡 2. Endpoint Matrix

`GET /v1/status`

Returns metadata regarding active dynamic channel drivers and worker loops:

curl -H "Authorization: Bearer <TOKEN>" http://127.0.0.1:3999/v1/status

`POST /v1/vision/capture`

Triggers an immediate coordinate-mapped screenshot capture:

curl -X POST -H "Authorization: Bearer <TOKEN>" http://127.0.0.1:3999/v1/vision/capture

`POST /v1/message/dispatch`

Instantly pushes a custom notification down the target gateway thread:

curl -X POST -H "Authorization: Bearer <TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{"channel_id": "slack_webhook", "target_recipient": "general", "message": "Alert!"}' \
     http://127.0.0.1:3999/v1/message/dispatch