Add dashboard session and usage views

Author: terrywangcode

.gitignore

@@ -40,3 +40,13 @@ sprints/
 htmlcov/
 .mcp.json
 .playwright-mcp/
+
+# Local E2E screenshots
+login-error.png
+login-fixed.png
+login-page.png
+login-username-password.png
+pm-admin-denied.png
+project-detail.png
+projects-after-login.png
+projects-page.png

login-error.png

@@ -189,6 +189,21 @@ class AddUserRequest(BaseModel):
     role: Literal["pm", "admin"] = "pm"
 
 
+class UpdateUserFeishuBindingRequest(BaseModel):
+    """Admin request to update a platform user's Feishu binding."""
+
+    feishu_user_id: str | None = Field(default=None, max_length=128)
+
+
+class KeeperPairingCodeInfo(BaseModel):
+    """One-time code used to bind a PM's Feishu account to a project Keeper bot."""
+
+    code: str
+    project_id: str
+    expires_at: datetime
+    status: Literal["active", "used", "expired"]
+
+
 class LoginRequest(BaseModel):
     """Request to log in with username and password."""
 
@@ -226,6 +241,16 @@ class TokenUsageDayRow(BaseModel):
     output_tokens: int
 
 
+class TokenUsageScopeRow(BaseModel):
+    """Aggregated token consumption for one scope (agent/session) and model."""
+
+    scope_id: str
+    model: str
+    input_tokens: int
+    output_tokens: int
+    request_count: int
+
+
 class CreateProjectRequest(BaseModel):
     """Request to create a new project from the Dashboard."""
 
@@ -306,6 +331,53 @@ class UpdateScoutRequest(BaseModel):
 # ============================================================================
 
 
+class ConversationSessionListItem(BaseModel):
+    """Summary row for one stored conversation session."""
+
+    session_id: str
+    project_id: str
+    agent_id: str
+    agent_role: Literal["keeper", "scout", "queen", "forager"] | str
+    source: Literal["feishu_private", "feishu_group", "web"]
+    counterparty_id: str | None = None
+    counterparty_name: str | None = None
+    group_id: str | None = None
+    status: str
+    message_count: int
+    started_at: datetime
+    last_message_at: datetime
+    last_trace_id: str | None = None
+
+
+class ConversationMessageItem(BaseModel):
+    """One message within a stored conversation transcript."""
+
+    message_id: str
+    session_id: str
+    project_id: str
+    agent_id: str
+    trace_id: str | None = None
+    role: Literal["user", "assistant", "tool", "system"] | str
+    sender_id: str | None = None
+    sender_name: str | None = None
+    content_text: str
+    content_json: dict = Field(default_factory=dict)
+    message_source_id: str | None = None
+    created_at: datetime
+
+
+class ConversationSessionDetail(ConversationSessionListItem):
+    """Full transcript view for one conversation session."""
+
+    messages: list[ConversationMessageItem]
+
+
+class PostSessionMessageRequest(BaseModel):
+    """Post one user-authored message from the dashboard into a Keeper session."""
+
+    content_text: str = Field(min_length=1, max_length=20000)
+
+
 # ============================================================================
 # Trace / Span Types
 # ============================================================================

login-fixed.png

@@ -40,6 +40,45 @@ export interface ScoutInfo {
   created_at: string;
 }
 
+export interface ConversationSessionListItem {
+  session_id: string;
+  project_id: string;
+  agent_id: string;
+  agent_role: string;
+  source: "feishu_private" | "feishu_group" | "web";
+  counterparty_id: string | null;
+  counterparty_name: string | null;
+  group_id: string | null;
+  status: string;
+  message_count: number;
+  started_at: string;
+  last_message_at: string;
+  last_trace_id: string | null;
+}
+
+export interface ConversationMessageItem {
+  message_id: string;
+  session_id: string;
+  project_id: string;
+  agent_id: string;
+  trace_id: string | null;
+  role: string;
+  sender_id: string | null;
+  sender_name: string | null;
+  content_text: string;
+  content_json: Record<string, unknown>;
+  message_source_id: string | null;
+  created_at: string;
+}
+
+export interface ConversationSessionDetail extends ConversationSessionListItem {
+  messages: ConversationMessageItem[];
+}
+
+export interface PostSessionMessageRequest {
+  content_text: string;
+}
+
 export interface ProjectDetail {
   project_id: string;
   project_name: string;
@@ -146,6 +185,17 @@ export interface AddUserRequest {
   role: "pm" | "admin";
 }
 
+export interface UpdateUserFeishuBindingRequest {
+  feishu_user_id: string | null;
+}
+
+export interface KeeperPairingCodeInfo {
+  code: string;
+  project_id: string;
+  expires_at: string;
+  status: "active" | "used" | "expired";
+}
+
 export interface CreateInviteCodeRequest {
   expires_in_hours: number;
 }
@@ -172,6 +222,14 @@ export interface TokenUsageDayRow {
   output_tokens: number;
 }
 
+export interface TokenUsageScopeRow {
+  scope_id: string;
+  model: string;
+  input_tokens: number;
+  output_tokens: number;
+  request_count: number;
+}
+
 // ============================================================================
 // Trace / Span Types
 // ============================================================================