feat: web admin dashboard — phase 1 prototype #48

Open

nazim wants to merge 15 commits from nazim/cobot:feat/web-admin into main

pull from: nazim/cobot:feat/web-admin

merge into: ultanio:main

ultanio:main

ultanio:fix/filedrop-error-handling

ultanio:feat/communication-events

ultanio:kn/web-plugin-v2-product-brief

ultanio:feature/telegram-lurker

ultanio:docs/prd-plugin-dependency-tree

ultanio:feature/interaction-ledger-merged

ultanio:fix/headless-mode

ultanio:feature/dockerization

ultanio:fix/filedrop-malformed-json

ultanio:docs/product-brief

ultanio:docs/prd

ultanio:docs/bmad-brownfield-scan

ultanio:release/v0.2.0

ultanio:feat/176-workspace-location

ultanio:fix/174-exec-cwd

ultanio:fix/deploy-v2

ultanio:test/init-integration

ultanio:fix/deploy-command

ultanio:fix/graceful-plugin-discovery

ultanio:feat/trust-plugin

ultanio:fix/identity-and-wake

ultanio:fix/forgejo-ci-workflow

ultanio:fix/test-alpha-script

ultanio:fix/filedrop-reply-to-sender

ultanio:fix/filedrop-reply-logging

ultanio:feature/openai-compat

ultanio:fix/99-telegram-pairing-passthrough

ultanio:fix/deploy-chown

ultanio:chore/retrigger-deploy-2

ultanio:fix/retrigger-deploy

ultanio:feat/integration-tests

ultanio:feat/deploy-workspace-context

ultanio:fix/alpha-deploy-bugs

ultanio:fix/deploy-known-hosts

ultanio:fix/deploy-workflow-v2

ultanio:test/deploy-ci-verification

ultanio:fix/deploy-workflow-simplify

ultanio:fix/trigger-deploy-test

ultanio:fix/add-deploy-script

ultanio:fix/deploy-runner-label

ultanio:fix/deploy-debug

ultanio:fix/deploy-host-fingerprint

ultanio:feature/auto-deploy

ultanio:fix-97

ultanio:story-109

ultanio:fix/97-run-sync-typo

ultanio:story-108

ultanio:story-107

ultanio:story-106

ultanio:story-105

ultanio:story-103

ultanio:feat/colored-logs

ultanio:story-80

ultanio:fix/antipattern-cleanup

ultanio:story-75

ultanio:story-69

ultanio:story-70

ultanio:story-62

ultanio:story-61

ultanio:story-60

ultanio:feature/scheduled-execution

ultanio:feature/knowledge-plugin

ultanio:k9ert-patch-4

ultanio:k9ert-patch-3

ultanio:k9ert-patch-2

ultanio:k9ert-patch-1

Conversation 0 Commits 15 Files changed 26 +2128 -7

nazim commented 2026-02-20 17:27:34 +00:00

Contributor

Copy link

Web Admin Dashboard + Plugin Enhancements

Web Admin (Starlette + HTMX + Pico CSS)

Plugin-contributed admin dashboard. Plugins extend via web_panels(), web_settings(), web_routes().

Plugin Extension Map

Plugin	Capability	Implements	Extension Points	Web	CLI
config	config	—	—	panel	—
ppq	llm	llm.chat, llm.models	—	panel + settings	—
ollama	llm	llm.chat, llm.models	—	—	—
communication	—	—	communication.*	panel	—
session	—	communication.*	session.*	—	—
nostr	communication	session.receive/send	—	panel + settings	identity, relays, dm, inbox
telegram	—	session.*	telegram.command/callback	—	—
wallet	wallet	—	—	panel + settings	balance, address, pay
tools	tools	—	—	panel + settings	list, run
security	security	—	—	panel + settings	—
knowledge	knowledge, tools	—	memory.*	panel + settings	—
logger	—	loop.on_message/after_send/on_error	—	panel + settings	—
compaction	—	loop.transform_history	—	—	—
persistence	—	loop.on_message/after_send	—	—	—
soul	—	loop.transform_system_prompt	—	—	—
memory	—	—	memory.*	—	store, get, search
memory_files	—	memory.*	—	—	—
loop	loop	—	loop.*	—	—
pairing	—	telegram.command/callback, filedrop.verify	—	—	list, approve, reject, revoke
web	loop	—	—	(self)	—

Dashboard Styling

• Background matched to logo (#0d0f14)
• SVG logo in sidebar (from docs/logo.svg)

CLI Commands Added

• cobot wallet balance|address|pay <invoice>
• cobot nostr identity|relays|dm <recipient> <message>|inbox [--since N]
• cobot tools list|run <command> [-t timeout]

Tests

• 139 unit tests passing
• 36 Playwright e2e tests (gracefully skipped when playwright not installed)

Dependencies

Web admin requires: starlette, jinja2, uvicorn (optional — graceful fallback)

## Web Admin Dashboard + Plugin Enhancements ### Web Admin (Starlette + HTMX + Pico CSS) Plugin-contributed admin dashboard. Plugins extend via `web_panels()`, `web_settings()`, `web_routes()`. ### Plugin Extension Map | Plugin | Capability | Implements | Extension Points | Web | CLI | |--------|-----------|------------|-----------------|-----|-----| | `config` | config | — | — | panel | — | | `ppq` | llm | `llm.chat`, `llm.models` | — | panel + settings | — | | `ollama` | llm | `llm.chat`, `llm.models` | — | — | — | | `communication` | — | — | `communication.*` | panel | — | | `session` | — | `communication.*` | `session.*` | — | — | | `nostr` | communication | `session.receive/send` | — | panel + settings | `identity`, `relays`, `dm`, `inbox` | | `telegram` | — | `session.*` | `telegram.command/callback` | — | — | | `wallet` | wallet | — | — | panel + settings | `balance`, `address`, `pay` | | `tools` | tools | — | — | panel + settings | `list`, `run` | | `security` | security | — | — | panel + settings | — | | `knowledge` | knowledge, tools | — | `memory.*` | panel + settings | — | | `logger` | — | `loop.on_message/after_send/on_error` | — | panel + settings | — | | `compaction` | — | `loop.transform_history` | — | — | — | | `persistence` | — | `loop.on_message/after_send` | — | — | — | | `soul` | — | `loop.transform_system_prompt` | — | — | — | | `memory` | — | — | `memory.*` | — | `store`, `get`, `search` | | `memory_files` | — | `memory.*` | — | — | — | | `loop` | loop | — | `loop.*` | — | — | | `pairing` | — | `telegram.command/callback`, `filedrop.verify` | — | — | `list`, `approve`, `reject`, `revoke` | | `web` | loop | — | — | (self) | — | ### Dashboard Styling - Background matched to logo (`#0d0f14`) - SVG logo in sidebar (from `docs/logo.svg`) ### CLI Commands Added - `cobot wallet balance|address|pay <invoice>` - `cobot nostr identity|relays|dm <recipient> <message>|inbox [--since N]` - `cobot tools list|run <command> [-t timeout]` ### Tests - 139 unit tests passing - 36 Playwright e2e tests (gracefully skipped when playwright not installed) ### Dependencies Web admin requires: `starlette`, `jinja2`, `uvicorn` (optional — graceful fallback)

nazim added 1 commit 2026-02-20 17:27:34 +00:00

feat: web admin dashboard — phase 1 prototype (#43) ... 34a4d32591

Plugin-contributed admin dashboard using Starlette + HTMX + Jinja2.

Base class additions:
- web_panels() → dashboard cards (structured data, framework renders)
- web_settings() → config UI declarations
- web_routes() → custom API endpoints (auto-namespaced)

Data types: WebPanel, WebSetting, WebRoute

Web plugin (cobot/plugins/web/):
- Starlette app as loop plugin (runs alongside main loop)
- Collects contributions from all plugins on start
- Dashboard page with HTMX auto-refresh panels
- Settings page with generated forms
- Panel content rendered as HTML fragments (kv, table, log, markdown)
- Pico.css for styling, ~14KB HTMX, zero build step

Plugin contributions (3 plugins wired up):
- logger: live log stream panel + log level setting
- ppq: LLM status panel (model, API key, base URL) + settings
- communication: channel status table

Config: web.enabled, web.host (default 127.0.0.1), web.port (default 8080)
Dependencies: starlette, uvicorn, jinja2 (optional — graceful fallback)

nazim added 1 commit 2026-02-20 17:59:25 +00:00

test: add 34 Playwright e2e tests for web admin plugin ... 506c54543e

Tests cover:
- Dashboard: page load, nav, category headers, KV/table/log/markdown panels, dark theme
- Settings: page load, grouped by plugin, number/bool/select/secret inputs, help text, restart warnings
- API: panels list, panel content (all kinds), error handling, 404, settings list/save, custom routes
- Navigation: dashboard <-> settings
- Edge case: empty dashboard/settings with no plugin contributions

Uses mock plugins contributing panels, settings, and custom routes.
Requires: starlette, jinja2, uvicorn, playwright, pytest-playwright

nazim added 1 commit 2026-02-20 18:01:52 +00:00

fix: clearer web plugin startup messages ... 106203cc7b

- Missing deps: '⚠️ Not starting — starlette not installed'
- Success: '🌐 Admin dashboard ready at http://...'
- Include uvicorn in the starlette error hint

nazim added 1 commit 2026-02-20 18:05:53 +00:00

fix: WebPlugin._registry not set when started by real registry ... b14f84505c

_collect_contributions() now falls back to get_registry() if _registry
wasn't explicitly set (e.g. in tests). Fixes AttributeError on cobot run.

nazim added 1 commit 2026-02-20 18:07:51 +00:00

fix: static/ dir missing crashes startup ... 3e0e37ad42

- Add .gitkeep to static/ so git tracks the empty directory
- Make static mount conditional (skip if dir doesn't exist)

nazim added 1 commit 2026-02-20 18:13:23 +00:00

fix: web admin server not actually listening ... c03d6ce6ba

The web plugin declared 'loop' capability but run() was never called —
the main agent loop doesn't dispatch loop plugins yet (needs PR #34).

Fix: add start_background() method that creates a background asyncio task,
and call it from agent.run_loop() for all loop-capable plugins.

This is a bridge until the loop plugin architecture is merged.

nazim force-pushed feat/web-admin from c03d6ce6ba to b0f04e4d06 2026-02-20 18:17:26 +00:00 Compare

nazim added 1 commit 2026-02-20 18:18:31 +00:00

fix: start loop plugins (web admin) in stdin mode too ... 064aa2e7db

run_stdin only talked to the first loop plugin. Now all other
loop-capable plugins (like web admin) run as background tasks,
so the dashboard is available in both --stdin and normal mode.

nazim added 1 commit 2026-02-20 18:19:30 +00:00

fix: cli.py calls run_loop_sync but agent.py has run_sync ... 4d1ef873eb

Also fixes stdin mode — both modes now start all loop plugins.

nazim added 1 commit 2026-02-20 18:27:14 +00:00

ui: sidebar layout + per-plugin settings navigation ... edddc686c1

- Replace top nav with persistent left sidebar (220px)
- Dashboard and Settings as prominent sidebar links with icons
- Settings page: plugin list in sidebar, click to show only that plugin
- Auto-selects first plugin when visiting /settings
- URL-addressable: /settings/mock-table shows only mock-table settings
- Added 2 new Playwright tests (plugin navigation, sidebar visible)
- Updated existing tests for new layout (36 total e2e tests)

nazim added 1 commit 2026-02-20 18:35:07 +00:00

feat: add logo + web panels for wallet/nostr/tools/security/knowledge/config plugins dd3edda3c7

nazim added 1 commit 2026-02-20 20:25:19 +00:00

style: match dashboard background to logo (#0d0f14) 5bb73eeaa0

nazim added 1 commit 2026-02-20 20:30:05 +00:00

fix: skip playwright e2e tests when playwright not installed 5784d09872

nazim added 1 commit 2026-02-20 20:34:08 +00:00

style: ruff format new web panel methods 4dceff2db6

nazim added 1 commit 2026-02-20 20:36:59 +00:00

feat: add CLI commands for wallet, nostr, and tools plugins ... 1a68c69a93

wallet: balance, address, pay
nostr: identity, relays, dm, inbox
tools: list, run

nazim referenced this pull request 2026-02-22 09:30:22 +00:00

[#54] Plugin introspection CLI + web visualization #56

nazim referenced this pull request 2026-02-22 12:31:05 +00:00

[#54] refactor: move plugin graph inspection into PluginRegistry #77

nazim referenced this pull request 2026-02-22 13:16:30 +00:00

Web plugin: extension point architecture (following CLI pattern) #80

doxios referenced this pull request 2026-02-22 13:19:51 +00:00

Web plugin: extension point architecture (following CLI pattern) #80

doxios referenced this pull request 2026-03-09 05:30:38 +00:00

docs: web plugin v2.0.0 product brief #233

All checks were successful

Hide all checks

CI / lint (pull_request) Successful in 10s

Details

CI / test (3.11) (pull_request) Successful in 21s

Details

CI / test (3.12) (pull_request) Successful in 23s

Details

E2E Tests / e2e (pull_request) Successful in 10s

Details

CI / test (3.13) (pull_request) Successful in 23s

Details

CI / build (pull_request) Successful in 7s

Details

This pull request has changes conflicting with the target branch.

• cobot/agent.py
• cobot/plugins/logger/plugin.py
• cobot/plugins/web/plugin.py
• cobot/plugins/web/templates/base.html

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u feat/web-admin:nazim-feat/web-admin

git switch nazim-feat/web-admin

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

Compat/Breaking

Breaking change that won't be backward compatible

  

Kind/Bug

Something is not working

  

Kind/Competitor

Anything we found interesting at competitory

  

Kind/Documentation

Documentation changes

  

Kind/Enhancement

Improve existing functionality

  

Kind/Epic

Business requirement — groups related stories

  

Kind/Feature

New functionality

  

Kind/Security

This is security issue

  

Kind/Story

Implementable unit with AC — results in a PR

  

Kind/Testing

Issue or pull request related to testing

  

Priority

Critical

The priority is critical

  

Priority

High

The priority is high

  

Priority

Low

The priority is low

  

Priority

Medium

The priority is medium

  

Reviewed

Confirmed

Issue has been confirmed

  

Reviewed

Duplicate

This issue or pull request already exists

  

Reviewed

Invalid

Invalid issue

  

Reviewed

Won't Fix

This issue won't be fixed

  

Scope/Core

Changes to core non-plugin code (CLI, config loading, etc.).

  

Scope/Cross-Plugin

Touches multiple existing plugins. Needs extra scrutiny, may require a PRD.

  

Scope/Plugin-System

Changes to plugin infrastructure (base.py, registry.py, interfaces.py, __init__.py, agent.py plugin dispatch). PRD required before merge.

  

Scope/Single-Plugin

Changes contained to one plugin (or adds one new plugin). Standard review.

  

Status

Abandoned

Somebody has started to work on this but abandoned work

  

Status

Blocked

Something is blocking this issue or pull request

  

Status

Need More Info

Feedback is required to reproduce issue or to continue work

No labels

Compat/Breaking

Kind/Bug

Kind/Competitor

Kind/Documentation

Kind/Enhancement

Kind/Epic

Kind/Feature

Kind/Security

Kind/Story

Kind/Testing

Priority

Critical

Priority

High

Priority

Low

Priority

Medium

Reviewed

Confirmed

Reviewed

Duplicate

Reviewed

Invalid

Reviewed

Won't Fix

Scope/Core

Scope/Cross-Plugin

Scope/Plugin-System

Scope/Single-Plugin

Status

Abandoned

Status

Blocked

Status

Need More Info

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

ultanio/cobot!48

No description provided.