🤖 feat: add storybook story for auto-compact warning

- Add contextUsage parameter to createAssistantMessage for testing high token usage
- Add AutoCompactWarning story showing the indicator at 65% context usage

Author: ammar-agent

src/browser/components/CompactionWarning.tsx

@@ -47,7 +47,7 @@ export const CompactionWarning: React.FC<{
   }
 
   return (
-    <div className="mx-auto -mb-1 w-full max-w-4xl px-[15px] text-right text-[10px]">
+    <div className="mx-auto mb-1 w-full max-w-4xl px-[15px] text-right text-[10px]">
       <button
         type="button"
         onClick={props.onCompactClick}

src/browser/stories/App.chat.stories.tsx

@@ -398,6 +398,116 @@ export const GenericTool: AppStory = {
   },
 };
 
+/** Shows auto-compact warning when context usage approaches threshold */
+export const AutoCompactWarning: AppStory = {
+  render: () => (
+    <AppWithMocks
+      setup={() =>
+        setupSimpleChatStory({
+          workspaceId: "ws-compaction-warning",
+          messages: [
+            createUserMessage("msg-1", "Help me set up authentication for this app", {
+              historySequence: 1,
+              timestamp: STABLE_TIMESTAMP - 600000,
+            }),
+            createAssistantMessage(
+              "msg-2",
+              "I'll help you set up authentication. Let me first examine your current project structure and dependencies.",
+              {
+                historySequence: 2,
+                timestamp: STABLE_TIMESTAMP - 580000,
+                toolCalls: [
+                  createFileReadTool(
+                    "call-1",
+                    "package.json",
+                    '{\n  "name": "my-app",\n  "dependencies": {\n    "express": "^4.18.0",\n    "mongoose": "^7.0.0"\n  }\n}'
+                  ),
+                ],
+              }
+            ),
+            createUserMessage("msg-3", "I want to use JWT tokens for the auth", {
+              historySequence: 3,
+              timestamp: STABLE_TIMESTAMP - 500000,
+            }),
+            createAssistantMessage(
+              "msg-4",
+              "Great choice! I'll implement JWT-based authentication. Let me create the auth middleware and user routes.",
+              {
+                historySequence: 4,
+                timestamp: STABLE_TIMESTAMP - 480000,
+                toolCalls: [
+                  createFileEditTool(
+                    "call-2",
+                    "src/middleware/auth.ts",
+                    "+ import jwt from 'jsonwebtoken';\n+ export const authenticate = (req, res, next) => {\n+   const token = req.headers.authorization?.split(' ')[1];\n+   // ... verification logic\n+ };"
+                  ),
+                ],
+              }
+            ),
+            createUserMessage("msg-5", "Add password hashing too", {
+              historySequence: 5,
+              timestamp: STABLE_TIMESTAMP - 400000,
+            }),
+            createAssistantMessage(
+              "msg-6",
+              "I'll add bcrypt for secure password hashing. Here's the updated user model with password hashing on save.",
+              {
+                historySequence: 6,
+                timestamp: STABLE_TIMESTAMP - 380000,
+                toolCalls: [
+                  createTerminalTool("call-3", "bun add bcrypt", "added bcrypt@5.1.0"),
+                  createFileEditTool(
+                    "call-4",
+                    "src/models/user.ts",
+                    "+ import bcrypt from 'bcrypt';\n+ userSchema.pre('save', async function() {\n+   this.password = await bcrypt.hash(this.password, 10);\n+ });"
+                  ),
+                ],
+              }
+            ),
+            createUserMessage("msg-7", "Now add refresh token support", {
+              historySequence: 7,
+              timestamp: STABLE_TIMESTAMP - 300000,
+            }),
+            createAssistantMessage(
+              "msg-8",
+              "I've implemented refresh token support with secure rotation. The access token expires in 15 minutes and the refresh token in 7 days.",
+              {
+                historySequence: 8,
+                timestamp: STABLE_TIMESTAMP - 280000,
+                // High context usage to trigger warning (65% of 200k)
+                contextUsage: { inputTokens: 130000, outputTokens: 5000, totalTokens: 135000 },
+              }
+            ),
+          ],
+        })
+      }
+    />
+  ),
+  play: async ({ canvasElement }: { canvasElement: HTMLElement }) => {
+    const canvas = within(canvasElement);
+
+    // Wait for last assistant message to render (unique text from assistant)
+    await waitFor(() => {
+      canvas.getByText(/access token expires in 15 minutes/);
+    });
+
+    // Wait a bit for auto-scroll to settle, then scroll up
+    await new Promise((r) => setTimeout(r, 100));
+    const messageWindow = canvasElement.querySelector('[data-testid="message-window"]');
+    if (messageWindow) {
+      messageWindow.scrollTop = messageWindow.scrollHeight - messageWindow.clientHeight - 150;
+    }
+  },
+  parameters: {
+    docs: {
+      description: {
+        story:
+          "Displays the auto-compact warning indicator above the chat input when context usage is approaching the compaction threshold. The indicator shows remaining headroom and is clickable to insert /compact command.",
+      },
+    },
+  },
+};
+
 /** Streaming compaction with shimmer effect - tests GPU-accelerated animation */
 export const StreamingCompaction: AppStory = {
   render: () => (

src/browser/stories/mockFactory.ts

@@ -203,6 +203,8 @@ export function createAssistantMessage(
     model?: string;
     reasoning?: string;
     toolCalls?: MuxPart[];
+    /** Custom context usage for testing compaction warning (default: small values) */
+    contextUsage?: { inputTokens: number; outputTokens: number; totalTokens: number };
   }
 ): ChatMuxMessage {
   const parts: MuxPart[] = [];
@@ -213,6 +215,11 @@ export function createAssistantMessage(
   if (opts.toolCalls) {
     parts.push(...opts.toolCalls);
   }
+  const contextUsage = opts.contextUsage ?? {
+    inputTokens: 100,
+    outputTokens: 50,
+    totalTokens: 150,
+  };
   return {
     type: "message",
     id,
@@ -222,8 +229,8 @@ export function createAssistantMessage(
       historySequence: opts.historySequence,
       timestamp: opts.timestamp ?? STABLE_TIMESTAMP,
       model: opts.model ?? DEFAULT_MODEL,
-      usage: { inputTokens: 100, outputTokens: 50, totalTokens: 150 },
-      contextUsage: { inputTokens: 100, outputTokens: 50, totalTokens: 150 },
+      usage: contextUsage,
+      contextUsage,
       duration: 1000,
     },
   };