@saadnvd1/agent-os 0.3.613 → 0.3.614

package/app/api/learning-cards/route.test.ts

@@ -0,0 +1,31 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import { setExperiment } from "@/lib/experiments";
+import { clearCards, seedSession } from "@/lib/learning-cards/__fixtures__/db";
+import { insertCard } from "@/lib/learning-cards/store";
+import { GET } from "./route";
+
+beforeEach(() => {
+  clearCards();
+  setExperiment("learning-cards", true);
+});
+
+describe("GET /api/learning-cards", () => {
+  it("lists every pending card, and none while the experiment is off", async () => {
+    const s = seedSession();
+    insertCard({
+      sessionId: s.id,
+      workspaceId: s.ws.id,
+      kind: "lesson",
+      destination: "rule",
+      payload: { lesson: "Run tests first", destination: "rule", pairs: 1 },
+    });
+    const on = await (await GET()).json();
+    expect(on.cards).toHaveLength(1);
+    expect(on.cards[0]).toMatchObject({
+      sessionId: s.id,
+      title: "Run tests first",
+    });
+    setExperiment("learning-cards", false);
+    expect((await (await GET()).json()).cards).toEqual([]);
+  });
+});

package/app/api/learning-cards/route.ts

@@ -0,0 +1,7 @@
+import { NextResponse } from "next/server";
+import { pendingCards } from "@/lib/learning-cards";
+
+// Every pending learning card, for the sidebar's badges.
+export async function GET() {
+  return NextResponse.json({ cards: pendingCards() });
+}

package/components/Chat/ChatPanel.tsx

@@ -739,11 +739,14 @@ export function ChatPanel({
             onGo={(item) => {
               if (item.kind === "ask") needsYouFocusActions.ask(item.ask.id);
               else if (item.kind === "chat") toEnd();
-              else if (item.kind === "task") {
+              else if (item.kind === "task" || item.kind === "card") {
                 window.history.pushState(
                   null,
                   "",
-                  hrefWithSession(location.href, item.sessionId)
+                  hrefWithSession(
+                    location.href,
+                    item.kind === "task" ? item.sessionId : item.card.sessionId
+                  )
                 );
                 window.dispatchEvent(new PopStateEvent("popstate"));
               } else

package/components/LearningCards/LearningCard.tsx

@@ -149,12 +149,15 @@ function LessonRow({
 
 export function LearningCards({
   cards,
+  embedded = false,
   busy = false,
   onApply,
   onDismiss,
   onEditRecipe,
 }: {
   cards: Card[];
+  // Inside another surface (the Needs-you strip): no frame of its own.
+  embedded?: boolean;
   busy?: boolean;
   onApply: (
     id: number,
@@ -168,7 +171,11 @@ export function LearningCards({
     <div
       role="region"
       aria-label="Learning cards"
-      className="bg-card popover-surface mb-2 flex flex-col gap-3 rounded-2xl p-3"
+      className={
+        embedded
+          ? "flex flex-col gap-3 px-3 pt-1 pb-3"
+          : "bg-card popover-surface mb-2 flex flex-col gap-3 rounded-2xl p-3"
+      }
     >
       {cards.map((c) =>
         c.kind === "recipe" ? (
@@ -195,12 +202,22 @@ export function LearningCards({
 }
 
 // On a finished session, above the composer. Nothing while the experiment is off.
-export function LearningCardsHost({ sessionId }: { sessionId: string }) {
+export function LearningCardsHost({
+  sessionId,
+  only,
+  embedded,
+}: {
+  sessionId: string;
+  // Just this card.
+  only?: number;
+  embedded?: boolean;
+}) {
   const { data } = useLearningCards(sessionId);
-  const { apply, dismiss, isPending } = useApplyCard(sessionId);
+  const { apply, dismiss, isPending } = useApplyCard();
   return (
     <LearningCards
-      cards={data ?? []}
+      embedded={embedded}
+      cards={(data ?? []).filter((c) => only === undefined || c.id === only)}
       busy={isPending}
       onApply={apply}
       onDismiss={dismiss}

package/components/Orchestrator/NeedsYouStrip.tsx

@@ -6,12 +6,15 @@ import {
   ChevronDown,
   CornerDownLeft,
   GitMerge,
+  Lightbulb,
   MessageCircleQuestion,
   UserRound,
   X,
 } from "lucide-react";
 import { toast } from "sonner";
+import { useApplyCard } from "@/data/learning-cards";
 import { useDismissNeedsYou } from "@/data/orchestrators";
+import { LearningCardsHost } from "@/components/LearningCards/LearningCard";
 import { useNeedsYou } from "@/hooks/useNeedsYou";
 import type { NeedsYouItem } from "@/lib/orchestrator/needs-you-items";
 import { cn } from "@/lib/utils";
@@ -21,6 +24,7 @@ const ICON = {
   question: MessageCircleQuestion,
   chat: MessageCircleQuestion,
   task: UserRound,
+  card: Lightbulb,
 } as const;
 
 const STORE = "agentos:needs-you-open";
@@ -42,6 +46,9 @@ export const NeedsYouStrip = memo(function NeedsYouStrip({
 }: NeedsYouActions & { workspaceId: string; chatWaiting: boolean }) {
   const items = useNeedsYou(workspaceId, chatWaiting);
   const dismiss = useDismissNeedsYou(workspaceId);
+  const cards = useApplyCard();
+  // The learning card opened in place.
+  const [openCard, setOpenCard] = useState<number | null>(null);
   // Open on a wide screen, closed on a phone, then as he left it. It renders
   // nothing until the orchestrator's data has loaded, so never on the server.
   const [open, setOpen] = useState(() => {
@@ -55,19 +62,21 @@ export const NeedsYouStrip = memo(function NeedsYouStrip({
     setOpen(!open);
   };
   const hide = (item: NeedsYouItem) =>
-    dismiss.mutate(
-      { key: item.key },
-      {
-        onSuccess: () =>
-          toast("Hidden from Needs you", {
-            action: {
-              label: "Undo",
-              onClick: () => dismiss.mutate({ key: item.key, undo: true }),
-            },
-          }),
-        onError: (e) => toast.error(e.message),
-      }
-    );
+    item.kind === "card"
+      ? cards.dismiss(item.card.id)
+      : dismiss.mutate(
+          { key: item.key },
+          {
+            onSuccess: () =>
+              toast("Hidden from Needs you", {
+                action: {
+                  label: "Undo",
+                  onClick: () => dismiss.mutate({ key: item.key, undo: true }),
+                },
+              }),
+            onError: (e) => toast.error(e.message),
+          }
+        );
   const newest = items[0];
 
   return (
@@ -101,43 +110,73 @@ export const NeedsYouStrip = memo(function NeedsYouStrip({
         />
       </button>
       {open && (
-        <ul className="max-h-48 divide-y divide-amber-500/15 overflow-y-auto border-t border-amber-500/15">
+        <ul
+          className={cn(
+            "divide-y divide-amber-500/15 overflow-y-auto border-t border-amber-500/15",
+            openCard === null ? "max-h-48" : "max-h-[60vh]"
+          )}
+        >
           {items.map((item) => {
             const Icon =
               item.kind === "ask" && item.ask.kind === "gate"
                 ? GitMerge
                 : ICON[item.kind];
+            const card = item.kind === "card" ? item.card : null;
+            const expanded = !!card && openCard === card.id;
             return (
-              <li key={item.key} className="flex items-center">
-                <button
-                  type="button"
-                  onClick={() => onGo(item)}
-                  className="hover:bg-foreground/[0.04] flex min-h-11 min-w-0 flex-1 items-center gap-2 px-3 text-left text-xs"
-                >
-                  <Icon className="text-muted-foreground h-3.5 w-3.5 shrink-0" />
-                  <span className="min-w-0 flex-1 truncate">{item.title}</span>
-                  <span className="text-muted-foreground/70 hidden max-w-[30%] shrink-0 truncate sm:block">
-                    {item.sub}
-                  </span>
-                </button>
-                {item.kind === "question" && (
+              <li key={item.key}>
+                <div className="flex items-center">
+                  <button
+                    type="button"
+                    aria-expanded={card ? expanded : undefined}
+                    onClick={() =>
+                      card ? setOpenCard(expanded ? null : card.id) : onGo(item)
+                    }
+                    className="hover:bg-foreground/[0.04] flex min-h-11 min-w-0 flex-1 items-center gap-2 px-3 text-left text-xs"
+                  >
+                    <Icon className="text-muted-foreground h-3.5 w-3.5 shrink-0" />
+                    <span className="min-w-0 flex-1 truncate">
+                      {item.title}
+                    </span>
+                    <span className="text-muted-foreground/70 hidden max-w-[30%] shrink-0 truncate sm:block">
+                      {item.sub}
+                    </span>
+                  </button>
+                  {item.kind === "question" && (
+                    <button
+                      type="button"
+                      onClick={() => onReply(item)}
+                      aria-label="Reply"
+                      className="text-muted-foreground hover:text-foreground flex size-11 shrink-0 items-center justify-center"
+                    >
+                      <CornerDownLeft className="h-3.5 w-3.5" />
+                    </button>
+                  )}
                   <button
                     type="button"
-                    onClick={() => onReply(item)}
-                    aria-label="Reply"
+                    onClick={() => hide(item)}
+                    aria-label="Dismiss"
                     className="text-muted-foreground hover:text-foreground flex size-11 shrink-0 items-center justify-center"
                   >
-                    <CornerDownLeft className="h-3.5 w-3.5" />
+                    <X className="h-3.5 w-3.5" />
                   </button>
+                </div>
+                {card && expanded && (
+                  <>
+                    <LearningCardsHost
+                      sessionId={card.sessionId}
+                      only={card.id}
+                      embedded
+                    />
+                    <button
+                      type="button"
+                      onClick={() => onGo(item)}
+                      className="text-muted-foreground hover:text-foreground min-h-11 px-3 text-left text-xs underline-offset-2 hover:underline"
+                    >
+                      Open {card.sessionName}
+                    </button>
+                  </>
                 )}
-                <button
-                  type="button"
-                  onClick={() => hide(item)}
-                  aria-label="Dismiss"
-                  className="text-muted-foreground hover:text-foreground flex size-11 shrink-0 items-center justify-center"
-                >
-                  <X className="h-3.5 w-3.5" />
-                </button>
               </li>
             );
           })}

package/components/SessionList/RowParts.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import { Lightbulb } from "lucide-react";
 import { useEffect, useRef, useState, type ReactNode } from "react";
 import type { SidebarRow } from "@/lib/sidebar/shelves";
 import { cn } from "@/lib/utils";
@@ -45,6 +46,21 @@ export function UnreadDot() {
   );
 }
 
+// A learning card is waiting on this session.
+export function CardBadge({ count }: { count: number }) {
+  return (
+    <span
+      data-tip="Learning card waiting: open the session to keep or drop it"
+      className="shrink-0"
+    >
+      <Lightbulb
+        aria-label={count > 1 ? `${count} learning cards` : "Learning card"}
+        className="h-3 w-3 text-amber-600 dark:text-amber-400"
+      />
+    </span>
+  );
+}
+
 export function RowRename({
   initial,
   onDone,

package/components/SessionList/SessionRow.tsx

@@ -14,6 +14,7 @@ import { compactTimeAgo } from "@/lib/session-meta";
 import { wakeLabel } from "@/lib/sidebar/snooze";
 import { sameRow, type SidebarRow } from "@/lib/sidebar/shelves";
 import { rowStatusBadge } from "@/lib/sidebar/row-badge";
+import { usePendingCardSessions } from "@/data/learning-cards";
 import { useMinuteTick } from "@/hooks/useMinuteTick";
 import { selectionStore, selectionActions } from "@/stores/sessionSelection";
 import { cn } from "@/lib/utils";
@@ -21,7 +22,7 @@ import { QuickChangeRow } from "./QuickChangeRow";
 import { useRowContext } from "./RowContext";
 import { SessionRowMenu } from "./SessionRowMenu";
 import { RowShell, type RowMenuKind } from "./RowShell";
-import { NestRail, RowDot, RowRename, UnreadDot } from "./RowParts";
+import { CardBadge, NestRail, RowDot, RowRename, UnreadDot } from "./RowParts";
 import { RowSubtitle } from "./RowSubtitle";
 import { OrchestratorAsks } from "./OrchestratorAsks";
 
@@ -63,6 +64,7 @@ export const SessionRow = memo(function SessionRow({
   };
 
   const badge = rowStatusBadge(row);
+  const cardCount = usePendingCardSessions().get(session.id) ?? 0;
 
   const menu = (kind: RowMenuKind) => (
     <SessionRowMenu
@@ -102,6 +104,7 @@ export const SessionRow = memo(function SessionRow({
                 />
               </span>
             )}
+            {cardCount > 0 && <CardBadge count={cardCount} />}
             {row.unread && !badge && <UnreadDot />}
             {isFork(session) && (
               <GitFork className="text-muted-foreground/60 h-3 w-3 shrink-0" />

package/components/SessionList/SessionShelves.tsx

@@ -11,6 +11,7 @@ import {
 import type { MachineGroup } from "@/lib/sidebar/machines";
 import { sidebarUiActions } from "@/stores/sidebarUi";
 import { cn } from "@/lib/utils";
+import { usePendingCardSessions } from "@/data/learning-cards";
 import { SessionRow } from "./SessionRow";
 import { OrchestratorPinRow, OrchestratorStartRow } from "./OrchestratorPinRow";
 import { QueuedRow } from "./QueuedRow";
@@ -125,7 +126,14 @@ export function SessionShelves({
 }) {
   const shown = shelves.done.slice(0, doneLimit(donePages));
   const hidden = shelves.done.length - shown.length;
-  const summary = doneSummary(shelves.done).text;
+  const pendingCards = usePendingCardSessions();
+  const doneCards = shelves.done.reduce(
+    (n, r) => n + (pendingCards.get(r.session.id) ?? 0),
+    0
+  );
+  const summary =
+    doneSummary(shelves.done).text +
+    (doneCards ? ` · ${doneCards} card${doneCards > 1 ? "s" : ""}` : "");
   // Live work above, what's resting below a hairline.
   const live =
     shelves.orchestrators.length +

package/data/learning-cards/index.ts

@@ -1,9 +1,12 @@
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { toast } from "sonner";
-import type { Card } from "@/lib/learning-cards/types";
+import { useMemo } from "react";
+import type { Card, PendingCardView } from "@/lib/learning-cards/types";
 import { useExperiment } from "../experiments";
+import { orchestratorKeys } from "../orchestrators";
+import { usePollWhenOffline } from "../push/connection";
 
-export type { Card };
+export type { Card, PendingCardView };
 
 export interface CardEdits {
   lesson?: string;
@@ -12,7 +15,10 @@ export interface CardEdits {
 }
 
 export const learningCardsKeys = {
-  session: (sessionId: string) => ["learning-cards", sessionId] as const,
+  all: ["learning-cards"] as const,
+  pending: ["learning-cards", "pending"] as const,
+  session: (sessionId: string) =>
+    ["learning-cards", "session", sessionId] as const,
 };
 
 async function json<T>(res: Response): Promise<T> {
@@ -36,11 +42,39 @@ export function useLearningCards(sessionId: string) {
       ).cards,
     enabled,
     staleTime: 10_000,
-    refetchInterval: 30_000,
+    // Pushed when a card is made or decided; this is the offline fallback.
+    refetchInterval: usePollWhenOffline(60_000),
   });
 }
 
-function useDecide(sessionId: string) {
+// Every pending card, for the sidebar's badges. One request for the list.
+export function usePendingCards() {
+  const enabled = useExperiment("learning-cards");
+  return useQuery({
+    queryKey: learningCardsKeys.pending,
+    queryFn: async () =>
+      (
+        await json<{ cards: PendingCardView[] }>(
+          await fetch("/api/learning-cards")
+        )
+      ).cards,
+    enabled,
+    staleTime: 10_000,
+    refetchInterval: usePollWhenOffline(60_000),
+  });
+}
+
+export function usePendingCardSessions(): Map<string, number> {
+  const { data } = usePendingCards();
+  return useMemo(() => {
+    const m = new Map<string, number>();
+    for (const c of data ?? [])
+      m.set(c.sessionId, (m.get(c.sessionId) ?? 0) + 1);
+    return m;
+  }, [data]);
+}
+
+function useDecide() {
   const queryClient = useQueryClient();
   return useMutation({
     mutationFn: async (
@@ -54,9 +88,9 @@ function useDecide(sessionId: string) {
         })
       ),
     onSuccess: (_d, v) => {
-      queryClient.invalidateQueries({
-        queryKey: learningCardsKeys.session(sessionId),
-      });
+      // The chat's card, the sidebar badge and the Needs-you strip.
+      queryClient.invalidateQueries({ queryKey: learningCardsKeys.all });
+      queryClient.invalidateQueries({ queryKey: orchestratorKeys.all });
       // A saved recipe or a new rule shows up in their own lists.
       if (v.action === "apply") {
         queryClient.invalidateQueries({ queryKey: ["recipes"] });
@@ -68,8 +102,8 @@ function useDecide(sessionId: string) {
   });
 }
 
-export const useApplyCard = (sessionId: string) => {
-  const m = useDecide(sessionId);
+export const useApplyCard = () => {
+  const m = useDecide();
   return {
     ...m,
     apply: (id: number, edits: CardEdits = {}) =>

package/data/push/topics.ts

@@ -17,6 +17,7 @@ import { featureKeys } from "../features";
 import { archivedKeys } from "../done";
 import { awayKeys } from "../away";
 import { bookmarkKeys } from "../bookmarks/keys";
+import { learningCardsKeys } from "../learning-cards";
 
 // What each pushed topic (a table that changed, lib/db/changes.ts, or a
 // pushed view) means the browser should refetch. Only queries on screen
@@ -73,6 +74,8 @@ function keysFor(topic: string): QueryKey[] {
       return [awayKeys.all];
     case "dev_servers":
       return [devServerKeys.all];
+    case "learning_cards":
+      return [learningCardsKeys.all, orchestratorKeys.all];
     case "chat_bookmarks":
       return [bookmarkKeys.all];
     default:

package/hooks/useNeedsYou.ts

@@ -6,6 +6,7 @@ import { useSessionsQuery } from "@/data/sessions/queries";
 import { useProjectsQuery } from "@/data/projects/queries";
 import { fetchStatuses } from "@/data/statuses/queries";
 import { statusKeys } from "@/data/sessions/keys";
+import { useExperiment } from "@/data/experiments";
 import { useOrchestratorOverview } from "@/data/orchestrators";
 import {
   needsYouItems,
@@ -20,6 +21,7 @@ export function useNeedsYou(
   chatWaiting: boolean
 ): NeedsYouItem[] {
   const overview = useOrchestratorOverview(workspaceId);
+  const cardsOn = useExperiment("learning-cards");
   const { data: sessions } = useSessionsQuery();
   const { data: projects = [] } = useProjectsQuery();
   const { data: statuses } = useQuery({
@@ -45,9 +47,10 @@ export function useNeedsYou(
         questions: overview?.questions ?? [],
         dismissed: overview?.dismissed ?? [],
         tasks,
+        cards: cardsOn ? (overview?.cards ?? []) : [],
         chatWaiting,
         chatKey: `approval:${workspaceId}`,
       }),
-    [overview, tasks, chatWaiting, workspaceId]
+    [overview, tasks, cardsOn, chatWaiting, workspaceId]
   );
 }

package/lib/db/changes.ts

@@ -43,6 +43,8 @@ export const TABLES_WATCHED_80 = [
 
 export const TABLES_WATCHED_CHAT_BOOKMARKS = ["chat_bookmarks"] as const;
 
+export const TABLES_WATCHED_LEARNING_CARDS = ["learning_cards"] as const;
+
 // Every table any migration watches, for the browser's topic map to cover.
 export const WATCHED_TABLES: readonly string[] = [
   ...TABLES_WATCHED_45,
@@ -52,6 +54,7 @@ export const WATCHED_TABLES: readonly string[] = [
   ...TABLES_WATCHED_78,
   ...TABLES_WATCHED_80,
   ...TABLES_WATCHED_CHAT_BOOKMARKS,
+  ...TABLES_WATCHED_LEARNING_CARDS,
 ];
 
 export function installChangeTriggers(

package/lib/db/migrations/20261014T2300_learning_cards_watch.ts

@@ -0,0 +1,18 @@
+import type { Migration } from "../migration-types";
+import {
+  installChangeTriggers,
+  TABLES_WATCHED_LEARNING_CARDS,
+} from "../changes";
+
+export default {
+  key: "20261014T2300_learning_cards_watch",
+  up: (db) => {
+    // A card decided in one place disappears from every open screen.
+    // Additive: an index and change triggers.
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_learning_cards_pending
+         ON learning_cards(status, created_at)`
+    );
+    installChangeTriggers(db, TABLES_WATCHED_LEARNING_CARDS);
+  },
+} satisfies Migration;

package/lib/learning-cards/__fixtures__/db.ts

@@ -46,7 +46,7 @@ export function seedSession(
 
 export const clearCards = () =>
   db.exec(
-    `DELETE FROM learning_cards; DELETE FROM experiment_usage; DELETE FROM orchestrator_notes`
+    `DELETE FROM learning_cards; DELETE FROM experiment_usage; DELETE FROM orchestrator_notes; DELETE FROM orchestrator_events`
   );
 
 export const uid = () => randomUUID();

package/lib/learning-cards/analyze.ts

@@ -4,7 +4,7 @@
 import os from "os";
 import { runClaude, type ClaudeRunner } from "../orchestrator/claude-cli";
 import { getOrchestrator } from "../orchestrator/home";
-import { addNote } from "../orchestrator/notes";
+import { queueEventOnce } from "../orchestrator/events";
 import { untrusted, UNTRUSTED_RULE } from "../orchestrator/untrusted";
 import { isRemoteHost } from "../hosts";
 import { getProject } from "../projects";
@@ -17,7 +17,13 @@ import { readSession } from "./input";
 import { correctionPairs } from "./pairs";
 import { recipeSignals } from "./signals";
 import { insertCard } from "./store";
-import type { Destination, Pair, SessionInput } from "./types";
+import {
+  cardTitle,
+  type Card,
+  type Destination,
+  type Pair,
+  type SessionInput,
+} from "./types";
 
 const ID = "learning-cards" as const;
 const LESSON_MAX = 200;
@@ -136,7 +142,7 @@ export async function analyzeSession(
       detail: `signals: ${recipe.signals.join(",") || "none"}; pairs: ${pairs.length}`,
     });
 
-    let made = 0;
+    const made: Card[] = [];
     if (recipe.hit && input.workspaceId) {
       try {
         recipePrefill(sessionId);
@@ -153,15 +159,15 @@ export async function analyzeSession(
         if (
           (out as { repeatable?: unknown } | null)?.repeatable === true &&
           draft
-        )
-          made += insertCard({
+        ) {
+          const card = insertCard({
             sessionId,
             workspaceId: input.workspaceId,
             kind: "recipe",
             payload: { signals: recipe.signals, ...draft },
-          })
-            ? 1
-            : 0;
+          });
+          if (card) made.push(card);
+        }
       } catch (error) {
         console.warn("[learning-cards] recipe draft:", error);
       }
@@ -191,8 +197,8 @@ export async function analyzeSession(
           runner
         )) as Verdict | null;
         const ok = checkLesson(out, where);
-        if (ok)
-          made += insertCard({
+        if (ok) {
+          const card = insertCard({
             sessionId,
             workspaceId: input.workspaceId,
             kind: "lesson",
@@ -205,23 +211,24 @@ export async function analyzeSession(
               projectName: where.project?.name,
               pairs: pairs.length,
             },
-          })
-            ? 1
-            : 0;
+          });
+          if (card) made.push(card);
+        }
       } catch (error) {
         console.warn("[learning-cards] lesson:", error);
       }
     }
 
-    if (made && input.workspaceId && getOrchestrator(input.workspaceId))
-      addNote(
-        input.workspaceId,
-        `Learning card on ${input.name}: ${
-          made > 1
-            ? "save as a recipe and keep a lesson"
-            : "a suggestion to save or keep"
-        }? Open the session to decide.`
-      );
+    // One line per card, once: the key is the card, so a rerun or a restart
+    // tells the orchestrator nothing new.
+    if (input.workspaceId && getOrchestrator(input.workspaceId))
+      for (const card of made)
+        queueEventOnce(
+          input.workspaceId,
+          `learning-card:${card.id}`,
+          sessionId,
+          `Learning card on "${input.name.replace(/\s+/g, " ")}", waiting on Saad's Needs-you strip: ${untrusted("learning card", cardTitle(card))}`
+        );
   } finally {
     inFlight.delete(sessionId);
   }

package/lib/learning-cards/index.ts

@@ -1,7 +1,12 @@
 import { experimentOn } from "../experiments";
 import { countEvent } from "../experiments/meter";
-import { listCards, markShown } from "./store";
-import type { Card, RecipePayload } from "./types";
+import { listCards, listPending, markShown } from "./store";
+import {
+  cardTitle,
+  type Card,
+  type PendingCardView,
+  type RecipePayload,
+} from "./types";
 
 const ID = "learning-cards" as const;
 
@@ -27,3 +32,21 @@ export function pendingRecipeDraft(sessionId: string) {
   const p = card?.payload as RecipePayload | undefined;
   return p ? { brief: p.brief, summary: p.summary } : undefined;
 }
+
+// Every pending card, or one workspace's. Reading it is not seeing the card:
+// nothing is stamped as shown. Nothing while the experiment is off.
+export function pendingCards(workspaceId?: string): PendingCardView[] {
+  if (!experimentOn(ID)) return [];
+  return listPending()
+    .filter((c) => workspaceId === undefined || c.ws === workspaceId)
+    .map((c) => ({
+      id: c.id,
+      sessionId: c.session_id,
+      sessionName: c.session_name,
+      workspaceId: c.ws,
+      kind: c.kind,
+      title: cardTitle(c),
+      destination: c.destination,
+      createdAt: c.created_at,
+    }));
+}

package/lib/learning-cards/store.ts

@@ -21,6 +21,28 @@ export function getCard(id: number): Card | null {
   return row ? toCard(row) : null;
 }
 
+export type PendingRow = Card & { session_name: string; ws: string | null };
+
+// Every pending card of a session that still exists, newest first.
+export function listPending(): PendingRow[] {
+  const rows = db
+    .prepare(
+      `SELECT lc.*, s.name AS session_name,
+              COALESCE(lc.workspace_id, s.workspace_id, p.workspace_id) AS ws
+       FROM learning_cards lc
+       JOIN sessions s ON s.id = lc.session_id
+       LEFT JOIN projects p ON p.id = s.project_id
+       WHERE lc.status = 'pending'
+       ORDER BY lc.created_at DESC, lc.id DESC`
+    )
+    .all() as (Row & { session_name: string; ws: string | null })[];
+  return rows.map((r) => ({
+    ...toCard(r),
+    session_name: r.session_name,
+    ws: r.ws,
+  }));
+}
+
 export function listCards(sessionId: string, status?: CardStatus): Card[] {
   const rows = db
     .prepare(

package/lib/learning-cards/types.ts

@@ -77,3 +77,26 @@ export interface Pair {
   before: string;
   after: string;
 }
+
+// A pending card as a list shows it, without the whole payload.
+export interface PendingCardView {
+  id: number;
+  sessionId: string;
+  sessionName: string;
+  workspaceId: string | null;
+  kind: CardKind;
+  // One line: the lesson, or the recipe's summary.
+  title: string;
+  destination: Destination | null;
+  createdAt: number;
+}
+
+const TITLE_MAX = 140;
+
+export function cardTitle(c: Pick<Card, "kind" | "payload">): string {
+  const p = c.payload as Partial<RecipePayload & LessonPayload>;
+  const raw =
+    c.kind === "lesson" ? p.lesson : p.summary || p.brief?.split("\n")[0];
+  const line = (raw ?? "").replace(/\s+/g, " ").trim();
+  return line.length > TITLE_MAX ? `${line.slice(0, TITLE_MAX)}…` : line;
+}

package/lib/orchestrator/ask-view.ts

@@ -1,6 +1,8 @@
 // What a client sees of the orchestrator's asks. Client-safe (no database),
 // so any client (the web, an API client) can import it.
 
+import type { PendingCardView } from "../learning-cards/types";
+
 export const ASK_KINDS = [
   "decision",
   "public",
@@ -49,4 +51,6 @@ export interface OrchestratorOverview {
   questions: QuestionView[];
   // Keys (ask:<id>, question:<id>) he hid from the Needs-you strip.
   dismissed: string[];
+  // Learning cards waiting on him; none while the experiment is off.
+  cards: PendingCardView[];
 }

package/lib/orchestrator/needs-you-items.ts

@@ -2,6 +2,7 @@
 // Client-safe and pure, so the strip and its tests share one rule.
 
 import { NEED_LABEL, type SessionNeed } from "../sidebar/shelves";
+import type { PendingCardView } from "../learning-cards/types";
 import type { AskView, QuestionView } from "./ask-view";
 
 export type NeedsYouItem =
@@ -21,6 +22,15 @@ export type NeedsYouItem =
       at: number;
       question: QuestionView;
     }
+  // A learning card a finished session left, waiting to be kept or dropped.
+  | {
+      key: string;
+      kind: "card";
+      title: string;
+      sub: string;
+      at: number;
+      card: PendingCardView;
+    }
   // The orchestrator's own chat waiting on an approval or an answer.
   | { key: string; kind: "chat"; title: string; sub: string; at: number }
   | {
@@ -56,6 +66,7 @@ export function needsYouItems(input: {
   questions: QuestionView[];
   dismissed: readonly string[];
   tasks?: TaskNeed[];
+  cards?: PendingCardView[];
   chatWaiting?: boolean;
   chatKey?: string;
 }): NeedsYouItem[] {
@@ -82,6 +93,15 @@ export function needsYouItems(input: {
       })
     ),
   ];
+  for (const card of input.cards ?? [])
+    items.push({
+      key: `card:${card.id}`,
+      kind: "card",
+      title: card.title,
+      sub: card.sessionName,
+      at: card.createdAt,
+      card,
+    });
   if (input.chatWaiting)
     items.push({
       key: input.chatKey ?? "approval:chat",

package/lib/orchestrator/overview.ts

@@ -11,6 +11,7 @@ import { askBinding, openAsks, PRESENCE_KINDS } from "./asks";
 import type { OrchestratorOverview } from "./ask-view";
 import { getOrchestrator } from "./home";
 import { resolveStaleAsks } from "./ask-settle";
+import { pendingCards } from "../learning-cards";
 import { dismissedKeys, openQuestions } from "./questions";
 
 export type { AskView, OrchestratorOverview } from "./ask-view";
@@ -33,6 +34,7 @@ function inReview(workspaceId: string): number {
 }
 
 export function orchestratorOverview(): OrchestratorOverview[] {
+  const cards = pendingCards();
   return listWorkspaces().map((w) => {
     // Asks about work that finished elsewhere never reach Saad's list.
     resolveStaleAsks(w.id);
@@ -60,6 +62,7 @@ export function orchestratorOverview(): OrchestratorOverview[] {
       }),
       questions: openQuestions(w.id),
       dismissed: dismissedKeys(w.id),
+      cards: cards.filter((c) => c.workspaceId === w.id),
     };
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saadnvd1/agent-os",
-  "version": "0.3.613",
+  "version": "0.3.614",
   "description": "Self-hosted web UI for managing Claude Code sessions",
   "bin": {
     "agent-os": "scripts/agent-os"