@juspay/shooter 1.5.0 → 1.6.1

package/src/lib/types/ws.ts

@@ -0,0 +1,161 @@
+// WebSocket module types — extracted from ws/ handler files.
+// All WebSocket-related type/interface definitions live here.
+//
+// Names use a "Wire" prefix where they collide with generated types
+// in WsProtocol.ts (which use class-wrapper discriminated unions).
+// These "Wire" types are the simple literal unions used at runtime.
+
+import type { WebSocket } from 'ws';
+
+import type {
+  MessageRole,
+  NotificationSession,
+  PermissionDecision,
+  SessionSource,
+  TerminalSignal,
+  TextContentBlock,
+} from './generated';
+import type { ConversationMessage } from './sessions';
+
+// ── events-handler types ────────────────────────────────────────────
+
+export interface PendingPong {
+  onClose: () => void;
+  onPong: () => void;
+  timer: ReturnType<typeof setTimeout>;
+}
+
+// ── keepalive types ─────────────────────────────────────────────────
+
+export type Session = NotificationSession;
+
+// ── session-handler types ───────────────────────────────────────────
+
+export interface SessionManagedTerminal {
+  id: string;
+  openCodeSessionId: null | string;
+  pty: {
+    pid: number;
+    write: (data: string) => void;
+  };
+  sessionFile: null | string;
+  status: 'exited' | 'running';
+}
+
+/** Extended PTY manager interface with list() for UUID-based terminal search. */
+export interface SessionPtyManagerFullLike extends SessionPtyManagerLike {
+  list: () => SessionManagedTerminal[];
+}
+
+export interface SessionPtyManagerLike {
+  getTerminal: (id: string) => SessionManagedTerminal | undefined;
+}
+
+export interface SessionWatcherLike {
+  getHistory: (sessionFile: string) => ConversationMessage[];
+  subscribe: (
+    sessionFile: string,
+    callback: (messages: ConversationMessage[]) => void
+  ) => () => void;
+}
+
+export interface TerminalManagedTerminal {
+  clients: Set<WebSocket>;
+  exitCode: null | number;
+  id: string;
+  pty: {
+    kill: (signal: string) => void;
+    pid: number;
+    resize: (cols: number, rows: number) => void;
+    write: (data: string) => void;
+  };
+  status: 'exited' | 'running';
+}
+
+export interface TerminalPtyManagerLike {
+  attach: (id: string, ws: WebSocket) => boolean;
+  detach: (id: string, ws: WebSocket) => boolean;
+  getTerminal: (id: string) => TerminalManagedTerminal | undefined;
+}
+
+/** A message in the history payload. */
+export interface WireHistoryMessage {
+  content: WireHistoryPart[];
+  id: string;
+  role: MessageRole;
+  timestamp: string;
+}
+
+/** A single part within a history message — discriminated union. */
+export type WireHistoryPart =
+  | { content: string; type: 'text' }
+  | { content: string; type: 'thinking' }
+  | { id: string; input: Record<string, unknown>; toolName: string; type: 'tool_use' }
+  | { isError: boolean; output: string; toolUseId: string; type: 'tool_result' };
+
+/** Inbound messages from the client (session channel). */
+export type WireSessionClientMessage =
+  | { sessionId: string; type: 'subscribe' }
+  | { text: string; type: 'send-input' }
+  | { type: 'cancel' };
+
+// ── terminal-handler types ──────────────────────────────────────────
+
+/** Outbound messages to the client (session channel). */
+export type WireSessionServerMessage =
+  | { content: TextContentBlock[]; role: MessageRole; timestamp: string; type: 'message' }
+  | {
+      id: string;
+      input: Record<string, unknown>;
+      name: string;
+      status: 'running';
+      type: 'tool-use';
+    }
+  | { id: string; isError: boolean; output: string; status: 'done'; type: 'tool-result' }
+  | { message: string; type: 'error' }
+  | { messages: WireHistoryMessage[]; type: 'history' }
+  | { text: string; type: 'thinking' }
+  | { type: 'session-end' };
+
+export type WireShooterEvent =
+  | { code: null | number; terminalId: string; type: 'terminal-exited' }
+  | { command: string; terminalId: string; type: 'terminal-created' }
+  | { command?: string; filePath?: string; terminalId?: string; tool: string; type: 'tool-started' }
+  | { decision: PermissionDecision; requestId: string; type: 'permission-resolved' }
+  | { error: string; terminalId?: string; tool: string; type: 'tool-failed' }
+  | {
+      input: Record<string, unknown>;
+      requestId: string;
+      tool: string;
+      type: 'permission-requested';
+    }
+  | { message: string; sessionId?: string; terminalId?: string; type: 'agent-question' }
+  | { message?: string; sessionId?: string; terminalId?: string; type: 'agent-idle' }
+  | { project: string; sessionId: string; source: SessionSource; type: 'session-started' }
+  | { sessionId: string; summary: string; type: 'session-ended' }
+  | { success: boolean; terminalId?: string; tool: string; type: 'tool-completed' };
+
+/** Inbound messages from the client (terminal channel). */
+export type WireTerminalClientMessage =
+  | { cols: number; rows: number; type: 'resize' }
+  | { data: string; type: 'input' }
+  | { signal: TerminalSignal; type: 'signal' };
+
+/** Outbound messages to the client (terminal channel). */
+export type WireTerminalServerMessage =
+  | { bytes: number; type: 'output-dropped' }
+  | { chunk: number; data: string; total: number; type: 'scrollback' }
+  | { code: null | number; signal: null | string; type: 'exit' }
+  | { data: string; type: 'output' }
+  | { message: string; type: 'error' };
+
+// ── notification-sessions type alias ────────────────────────────────
+
+/** Per-connection state tracked for cleanup. */
+export interface WsConnectionState {
+  /** True when the session is file-only (no terminal backing it). */
+  isExternalSession: boolean;
+  retryInterval: null | ReturnType<typeof setInterval>;
+  terminalId: string;
+  unsubscribe: (() => void) | null;
+}

package/src/routes/+error.svelte

@@ -27,8 +27,13 @@
       {/if}
     </p>
     <div class="error-actions">
-      <button class="error-btn" onclick={() => goto('/')}>Go Home</button>
-      <button class="error-btn error-btn-secondary" onclick={() => { history.back(); }}>Go Back</button>
+      <button class="error-btn" onclick={(): void => void goto('/')}>Go Home</button>
+      <button
+        class="error-btn error-btn-secondary"
+        onclick={(): void => {
+          history.back();
+        }}>Go Back</button
+      >
     </div>
   </div>
 </main>

package/src/routes/+layout.server.ts

@@ -0,0 +1,9 @@
+import { env } from '$env/dynamic/private';
+import { getProviderAvailability } from '$lib/modules/shared/providers';
+
+import type { LayoutServerLoad } from './$types';
+
+export const load: LayoutServerLoad = () => ({
+  aiProviders: getProviderAvailability(env),
+  neurolinkProvider: env.NEUROLINK_PROVIDER ?? '',
+});

package/src/routes/+layout.svelte

@@ -1,12 +1,29 @@
 <script lang="ts">
+  import type { LayoutData } from '$lib/types';
+
   import '../app.css';
   import '$lib/theme.css';
+  import { browser } from '$app/environment';
   import { goto } from '$app/navigation';
   import { page } from '$app/stores';
-  import { StatusBadge } from '$lib/modules/client/common';
+  import { Icon, StatusBadge } from '$lib/modules/client/common';
   import { onMount, type Snippet } from 'svelte';
 
-  const { children }: { children: Snippet } = $props();
+  const { children, data }: { children: Snippet; data: LayoutData } = $props();
+
+  // Expose AI provider flags for summarizers (they run outside SvelteKit's data flow)
+  $effect(() => {
+    if (!browser || !data?.aiProviders) {
+      return;
+    }
+    (window as unknown as Record<string, unknown>).__aiProviders = data.aiProviders;
+    if (data.neurolinkProvider) {
+      const proc = (window as unknown as { process?: { env?: Record<string, string> } }).process;
+      if (proc?.env) {
+        proc.env.NEUROLINK_PROVIDER = data.neurolinkProvider;
+      }
+    }
+  });
 
   let systemStatus = $state<'degraded' | 'error' | 'healthy' | 'unknown'>('unknown');
 
@@ -51,7 +68,9 @@
         <StatusBadge status={systemStatus} />
         <button
           class="btn-gear {$page.url.pathname === '/config' ? 'btn-gear-active' : ''}"
-          onclick={() => goto('/config')}
+          onclick={(): void => {
+            void goto('/config');
+          }}
           aria-label="Settings"
         >
           <svg
@@ -79,7 +98,7 @@
     {@render children()}
   </div>
 
-  <!-- Bottom tab bar: Projects + Terminals -->
+  <!-- Bottom tab bar: Dashboard + Activity + Terminals -->
   <nav class="bottom-tabs">
     <div class="bottom-tabs-inner">
       <a
@@ -97,10 +116,20 @@
           stroke-linecap="round"
           stroke-linejoin="round"
         >
-          <path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"
-          ></path>
+          <rect x="3" y="3" width="7" height="7"></rect>
+          <rect x="14" y="3" width="7" height="7"></rect>
+          <rect x="3" y="14" width="7" height="7"></rect>
+          <rect x="14" y="14" width="7" height="7"></rect>
         </svg>
-        <span>Projects</span>
+        <span>Dashboard</span>
+      </a>
+      <a
+        href="/activity"
+        class="tab-item"
+        class:active={$page.url.pathname.startsWith('/activity')}
+      >
+        <Icon name="bell" size={26} />
+        <span>Activity</span>
       </a>
       <a
         href="/terminals"

package/src/routes/+page.server.ts

@@ -0,0 +1,7 @@
+import { env } from '$env/dynamic/private';
+
+import type { PageServerLoad } from './$types';
+
+export const load: PageServerLoad = () => ({
+  googleAiConfigured: Boolean(env.GOOGLE_AI_API_KEY?.trim()),
+});

package/src/routes/+page.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import type { ProjectGroup, ShooterConfig } from '$generated/types';
+  import type { DashboardCard, ProjectGroup, ShooterConfig } from '$lib/types';
 
   import { goto } from '$app/navigation';
   import {
@@ -11,6 +11,7 @@
     isShooterConfig,
     setCache,
   } from '$lib/modules/client/common';
+  import { connect, DashboardView, disconnect, getCards } from '$lib/modules/client/dashboard';
   import { Banner, Button, Pill, Shimmer } from '@juspay/svelte-ui-components';
   import { onDestroy, onMount } from 'svelte';
 
@@ -26,6 +27,8 @@
   let hasMore = $state(false);
   let currentOffset = $state(0);
 
+  const cards = $derived(getCards());
+
   onMount(() => {
     loadConfiguration();
 
@@ -51,6 +54,7 @@
       clearInterval(pollTimer);
       pollTimer = null;
     }
+    disconnect();
   });
 
   function loadConfiguration(): void {
@@ -60,6 +64,8 @@
         const parsed: unknown = JSON.parse(saved);
         if (isShooterConfig(parsed)) {
           config = parsed;
+          // Connect dashboard store with API key
+          void connect(config.apiKey);
         } else {
           localStorage.removeItem('shooter_config');
           config = null;
@@ -97,7 +103,7 @@
       }
 
       fetchError = null;
-      const result: { projects: ProjectGroup[]; total?: number } = await response.json();
+      const result = (await response.json()) as { projects: ProjectGroup[]; total?: number };
       if (append) {
         projects = [...projects, ...result.projects];
       } else {
@@ -129,22 +135,26 @@
     void goto('/config');
   }
 
+  function navigateToTerminal(terminalId: string): void {
+    void goto(`/terminals/${terminalId}`);
+  }
+
   function totalSessionCount(): number {
     return projects.reduce((sum, p) => sum + p.sessionCount, 0);
   }
 </script>
 
 <svelte:head>
-  <title>Projects - Shooter</title>
-  <meta name="description" content="Claude Code sessions across all projects" />
+  <title>Dashboard - Shooter</title>
+  <meta name="description" content="Active terminals and Claude Code sessions" />
 </svelte:head>
 
 <main class="main">
   <div class="page-header">
     <div class="page-header-content">
       <div>
-        <h1 class="page-title">Projects</h1>
-        <p class="page-description">Claude Code sessions across all projects</p>
+        <h1 class="page-title">Dashboard</h1>
+        <p class="page-description">Active terminals and Claude Code sessions</p>
       </div>
       <div class="page-actions">
         <Button classes="btn-secondary" onclick={forceRefresh} disabled={loading}>
@@ -159,9 +169,9 @@
     <Banner text={fetchError} classes="banner-error" />
   {/if}
 
-  {#if loading && projects.length === 0}
+  {#if loading && projects.length === 0 && cards.length === 0}
     <div class="loading-container">
-      {#each Array(5) as _, i (i)}
+      {#each Array(3) as _, i (i)}
         <Shimmer classes="shimmer-card" />
       {/each}
     </div>
@@ -173,36 +183,63 @@
     >
       <Button classes="btn-primary" onclick={navigateToConfig} text="Configure Settings" />
     </EmptyState>
-  {:else if totalSessionCount() === 0}
-    <EmptyState
-      icon="bell"
-      title="No sessions yet"
-      description="Claude Code sessions will appear here once JSONL files are found"
-    />
   {:else}
-    <div class="projects-container">
-      {#each projects as project (project.id)}
-        <a href="/project?id={project.id}" class="session-card">
-          <div class="session-card-header">
-            <div>
-              <h3 class="session-card-title">{project.name}</h3>
-              <div class="session-card-subtitle">{project.fullPath}</div>
+    <!-- Dashboard section: active terminal sessions -->
+    {#if cards.length > 0}
+      <div class="dashboard-section">
+        <DashboardView
+          {cards}
+          onCardClick={(card: DashboardCard): void => {
+            navigateToTerminal(card.terminalId);
+          }}
+        />
+      </div>
+    {/if}
+
+    <!-- Sessions archive below dashboard -->
+    {#if loading && projects.length === 0}
+      <div class="loading-container">
+        {#each Array(3) as _, i (i)}
+          <Shimmer classes="shimmer-card" />
+        {/each}
+      </div>
+    {:else if totalSessionCount() === 0 && cards.length === 0}
+      <EmptyState
+        icon="bell"
+        title="No sessions yet"
+        description="Claude Code sessions will appear here once JSONL files are found"
+      />
+    {:else if projects.length > 0}
+      {#if cards.length > 0}
+        <h3 class="section-label">Sessions</h3>
+      {/if}
+      <div class="projects-container">
+        {#each projects as project (project.id)}
+          <a href="/project?id={project.id}" class="session-card">
+            <div class="session-card-header">
+              <div>
+                <h3 class="session-card-title">{project.name}</h3>
+                <div class="session-card-subtitle">{project.fullPath}</div>
+              </div>
+              <Pill
+                text="Last updated {formatRelativeTime(project.lastModified)}"
+                classes="pill-session-time"
+              />
             </div>
-            <Pill text="Last updated {formatRelativeTime(project.lastModified)}" classes="pill-session-time" />
-          </div>
-          <div class="session-stats">
-            <span
-              ><strong>{project.sessionCount}</strong>
-              {project.sessionCount === 1 ? 'session' : 'sessions'}</span
-            >
-          </div>
-        </a>
-      {/each}
-    </div>
-    {#if hasMore}
-      <div style="text-align: center; padding: 1rem;">
-        <Button classes="btn-secondary" onclick={loadMore} text="Load More" />
+            <div class="session-stats">
+              <span
+                ><strong>{project.sessionCount}</strong>
+                {project.sessionCount === 1 ? 'session' : 'sessions'}</span
+              >
+            </div>
+          </a>
+        {/each}
       </div>
+      {#if hasMore}
+        <div style="text-align: center; padding: 1rem;">
+          <Button classes="btn-secondary" onclick={loadMore} text="Load More" />
+        </div>
+      {/if}
     {/if}
   {/if}
 </main>
@@ -238,6 +275,19 @@
     flex-shrink: 0;
   }
 
+  .dashboard-section {
+    margin-bottom: var(--space-6);
+  }
+
+  .section-label {
+    font-size: var(--text-xs, 12px);
+    font-weight: 600;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    color: var(--text-secondary);
+    margin-bottom: var(--space-3);
+  }
+
   .projects-container {
     display: flex;
     flex-direction: column;

package/src/routes/activity/+page.server.ts

@@ -0,0 +1,7 @@
+import { env } from '$env/dynamic/private';
+
+import type { PageServerLoad } from './$types';
+
+export const load: PageServerLoad = () => ({
+  googleAiConfigured: Boolean(env.GOOGLE_AI_API_KEY?.trim()),
+});

package/src/routes/activity/+page.svelte

@@ -0,0 +1,58 @@
+<script lang="ts">
+  import { browser } from '$app/environment';
+  import { goto } from '$app/navigation';
+  import { ActivityFeed } from '$lib/modules/client/activity';
+  import { isShooterConfig } from '$lib/modules/client/common';
+  import { onMount } from 'svelte';
+
+  let configured = $state(false);
+
+  onMount(() => {
+    if (!browser) {
+      return;
+    }
+
+    // Check config exists
+    try {
+      const saved = localStorage.getItem('shooter_config');
+      if (!saved) {
+        void goto('/config');
+        return;
+      }
+      const parsed: unknown = JSON.parse(saved);
+      if (!isShooterConfig(parsed)) {
+        localStorage.removeItem('shooter_config');
+        void goto('/config');
+        return;
+      }
+      configured = true;
+    } catch {
+      // Malformed config in storage — clear it before redirecting so
+      // revisits don't keep bouncing back to /config with stale state.
+      localStorage.removeItem('shooter_config');
+      void goto('/config');
+    }
+  });
+</script>
+
+<svelte:head>
+  <title>Activity Feed - Shooter</title>
+  <meta name="description" content="Real-time activity feed" />
+</svelte:head>
+
+<main class="main">
+  <h1 class="page-title">Activity Feed</h1>
+  {#if configured}
+    <ActivityFeed />
+  {/if}
+</main>
+
+<style>
+  .page-title {
+    font-size: var(--text-2xl);
+    font-weight: 600;
+    letter-spacing: -0.03em;
+    color: var(--text-primary);
+    margin-bottom: var(--space-4);
+  }
+</style>

package/src/routes/api/health/+server.ts

@@ -1,22 +1,20 @@
-import type {
-  FCMConfiguration,
-  HealthChecks,
-  HealthConfiguration,
-  HealthStatus,
-} from '$generated/types';
+import type { FCMConfiguration, HealthChecks, HealthConfiguration, HealthStatus } from '$lib/types';
 
 import { env } from '$env/dynamic/private';
 import { validateAuth } from '$lib/modules/server/auth';
+import { getProviderAvailability } from '$lib/modules/shared/providers';
 import { json } from '@sveltejs/kit';
 import { readFileSync } from 'fs';
 import { join } from 'path';
 
 import type { RequestHandler } from './$types';
 
-const PKG_VERSION: string = (() => {
+const PKG_VERSION: string = ((): string => {
   const root = process.env.SHOOTER_PKG_ROOT || process.cwd();
   try {
-    const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf-8')) as { version?: string };
+    const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf-8')) as {
+      version?: string;
+    };
     return pkg.version || 'unknown';
   } catch {
     return 'unknown';
@@ -76,19 +74,26 @@ export const GET: RequestHandler = ({ request, url }) => {
     warnings.push('FCM not configured — Android push notifications disabled');
   }
 
-  const health: {
-    checks: HealthChecks;
-    configuration: HealthConfiguration;
-    environment: string;
-    status: HealthStatus;
-    timestamp: string;
-    version: string;
-    warnings: string[];
-  } = {
+  // AI provider checks
+  const aiProviders = getProviderAvailability(env);
+  const hasAnyAiProvider = Object.values(aiProviders).some(Boolean);
+
+  if (!hasAnyAiProvider) {
+    warnings.push(
+      'No AI provider configured — AI summaries disabled. Run "shooter setup" to configure.'
+    );
+  }
+
+  const health = {
+    ai: {
+      activeProvider: env.NEUROLINK_PROVIDER ?? 'auto',
+      hasAnyProvider: hasAnyAiProvider,
+      providers: aiProviders,
+    },
     checks,
     configuration,
     environment: env.NODE_ENV || 'development',
-    status: 'healthy',
+    status: 'healthy' as HealthStatus,
     timestamp: new Date().toISOString(),
     version: PKG_VERSION,
     warnings,
@@ -101,7 +106,15 @@ export const GET: RequestHandler = ({ request, url }) => {
 
   // Public response: status + warnings. Authenticated: full details.
   if (!wantsDetails) {
-    return json({ status: health.status, timestamp: health.timestamp, version: health.version, warnings: health.warnings });
+    // Filter AI provider configuration warnings from the unauthenticated
+    // response so we don't leak system capability details to anonymous callers.
+    const publicWarnings = health.warnings.filter((w) => !w.includes('AI provider'));
+    return json({
+      status: health.status,
+      timestamp: health.timestamp,
+      version: health.version,
+      warnings: publicWarnings,
+    });
   }
 
   return json(health);