Console

<http_base_url>/console

cd console
npm run dev    # starts Vite at http://localhost:5199 with proxy to gateway

┌─────────────┬──────────────────────────┬────────────────┐
│  Sidebar    │  Dock (chat panels)      │  Activity Rail │
│  (agents)   │  ┌────┐ ┌────┐          │  (events)      │
│             │  │tab1│ │tab2│  +        │                │
│  + Spawn    │  ├────┴─┴────┴──────────┤│  Events        │
│  ↻ Reconcile│  │                      ││  • text_delta  │
│             │  │   Conversation        ││  • run_started │
│  Agents + ≡ │  │                      ││  • ...         │
│  ┌ Domain 3 │  │   [Message Billing]  ││                │
│  │ Billing  │  │   ↑                  ││                │
│  │ Delivery │  │                      ││                │
│  │ Support  │  │  To: Billing  lead   ││                │
│  ├ Internal │  └──────────────────────┘│                │
│  │ Gate     │                          │                │
│  └ Coord. 2 │                          │                │
│    Router   │                          │                │
│    Triage   │                          │                │
└─────────────┴──────────────────────────┴────────────────┘

[agent_list]
group_by = ["labels.console_group", "labels.group", "role"]
subgroup_by = ["labels.org", "labels.realm"]
section_order = ["Personal", "Initiatives", "Internal"]
fallback_group = "Agents"
fallback_subgroup = "Other"
default_pinned_agent_ids = ["identity:ops-lead"]
collapse_single_subgroup = true

use std::collections::BTreeMap;

use meerkat_mob::ids::AgentIdentity;
use meerkat_mob::{ProfileName, SpawnMemberSpec};

fn labels(pairs: &[(&str, &str)]) -> BTreeMap<String, String> {
    pairs.iter().map(|(k, v)| (k.to_string(), v.to_string())).collect()
}

SpawnMemberSpec::new(
    ProfileName::from("lead"),
    AgentIdentity::from("domain:billing"),
)
    .with_labels(labels(&[
        ("display_name", "Billing"),
        ("console_group", "Domain"),
        ("org", "Payments"),
    ]));

title = "OB3"

[brand]
label = "Open Brain"
logo_url = "/assets/ob3.svg"
logo_alt = "OB3"

[appearance]
default_theme = "dark"
default_variant = "graphite"

[environment]
label = "prod"

[layout]
initial_preset = "two_columns"
initial_control = "roster"
initial_agent = "identity:ops-lead"
sidebar_collapsed = false

[rail]
visible = true
collapsed = false
active_preset_id = "critical"
empty_text = "No meaningful signals yet."

[[rail.filter_presets]]
id = "critical"
label = "Critical"
alert_levels = ["critical"]

[sidebar]
visible_controls = ["topology", "roster", "logs", "health"]
hidden_controls = []

[[sidebar.buttons]]
id = "ob3-board"
label = "OB3 Board"
href = "https://example.test/ob3"
target = "_blank"
icon_name = "external-link"

[agent_list]
group_by = ["labels.console_group", "labels.group", "role"]
subgroup_by = ["labels.org", "labels.realm"]
section_order = ["Personal", "Initiatives", "Internal"]
fallback_group = "Agents"
fallback_subgroup = "Other"
default_pinned_agent_ids = ["identity:ops-lead"]
collapse_single_subgroup = true

[[agent_list.badges]]
id = "org"
label = "Org"
field = "labels.org"
tone = "info"

[[agent_list.sections]]
name = "Initiatives"
collapsed = false
empty_title = "No initiatives"
empty_text = "Create one in Linear."

[actions]
inspect_label = "Profile"
chat_label = "Open chat"
send_label = "Send to agent"
respawn_label = "Respawn"
retire_label = "Retire"
reset_label = "Reset"
show_reset = false

[realms.ob3]
title = "OB3"

[realms.ob3.agent_list]
subgroup_by = ["labels.org"]

interface ConsoleAgent {
  agent_id: string;
  member_id: string;
  label: string;
  kind: string;           // "mob_agent" or "module_agent"
  profile?: string;
  state?: string;
  group?: string;         // sidebar grouping
  addressable?: boolean;
  affordances?: {
    can_send_message?: boolean;
    can_retire?: boolean;
    can_respawn?: boolean;
    runtime_mode?: string;
  };
  labels?: Record<string, string>;
}

use meerkat_mobkit::{TopologyControlMode, TopologyControlPolicy, UnifiedRuntime};

let runtime = UnifiedRuntime::builder()
    .definition_path("config/mob.toml")
    .persistent_state(".mobkit/state")
    .topology_control(TopologyControlPolicy {
        mode: TopologyControlMode::Editable,
        allow_bulk: false,
        max_batch_size: 1,
        allow_cross_authority: false,
        ..TopologyControlPolicy::default()
    })?
    .build()
    .await?;

ConsolePolicy {
    require_app_auth: true,   // the default; set false only for local development
    read_only: false,         // set true for view-only deployments
}

# Terminal 1: start the gateway
MOBKIT_REF_ADDR=127.0.0.1:63210 MOBKIT_REF_HTTP_MODE=serve \
  ./scripts/repo-cargo run -p meerkat-mobkit --example library_mode_reference

# Terminal 2: start the Vite dev server (proxies API calls to gateway)
cd console && npm run dev

packages/
├── console-core/         # Types, state management, reducers (framework-agnostic)
│   └── src/
│       ├── conversation.ts   # Message types, timeline grouping
│       ├── dock.ts           # Multi-panel state, presets, actions
│       ├── sidebar.ts        # Block → section → item hierarchy
│       ├── activity.ts       # Roster, pulse, feed panel types
│       ├── composer.ts       # Composer view state, toolbar items
│       └── rich-content.ts   # Markdown → rich block parser
│
├── console-components/   # React components + CSS (portable, no app imports)
│   └── src/
│       ├── workbench/        # 3-column grid layout
│       ├── sidebar/          # Hierarchical agent sidebar
│       ├── dock/             # Tabbed multi-panel with splits
│       ├── conversation/     # Message transcript + empty state
│       ├── composer/         # Frosted glass input shell
│       ├── activity/         # Activity rail with roster/pulse/feed
│       └── styles/           # CSS tokens, themes, per-domain stylesheets
│
console/
├── src/
│   ├── ConsoleApp.tsx        # Main app: wires shared components + data
│   ├── lib/adapters.ts       # MobKit data → console-core view states
│   ├── lib/network.ts        # RPC, SSE, fetch helpers
│   ├── lib/agents.ts         # Agent normalization
│   ├── icon.tsx              # SVG sprite sheet + Icon renderer
│   ├── console-host.css      # MobKit-specific overrides + global styles
│   └── types.ts              # ConsoleAgent, ConsoleFrame, etc.
├── build.cjs                 # esbuild production build
├── vite.config.ts            # Vite dev server config
└── smoke.cjs                 # JSDOM smoke test