Files
learnharness/components/practice-cards.tsx
T
amosblomqvist 793638d6ce practice: the agent's data drawer — full transparency on every conclude card (round 17)
Owner ask (2026-10-06): reveal everything the agent filled in when
writing the problem and concluding it, at the very bottom of the
conclude card, collapsible, arriving collapsed.

The fields, both calls:
- problem: mode (recall/discrimination/composition), target
  proposition ids, statement, modelSolution (the last two ARE the
  visible card — the drawer shows the metadata only)
- conclude: outcome, hint rung (R0–R5/null), miss class
  (cue/discrimination/execution/careless/structural/null), retest.

Seams: problemInputForConclude (native-messages) walks the reveal's
walk and folds the WHOLE problem-call input onto the conclude part
(projectView join; same refused-pose law — an unacked pose folds
nothing); ArtifactPartProps grows problemInput. Targets resolve to
proposition NAMES at render (one lazy module-cached /api/graph fetch;
failure degrades to raw ids — observability never breaks the card).
The drawer: divider + chevron 'AGENT'S DATA' toggle (mono-caps
eyebrow register), definition rows with mono values, 'untagged'/
'none' honest empties, absent entirely when the calls filled nothing
(the dismissal line, legacy bare records).
2026-10-06 04:18:26 +03:00

250 lines
10 KiB
TypeScript

"use client";
import { MessageResponse } from "@/components/ai-elements/message";
import { cn } from "@/lib/utils";
import type { ArtifactPartProps } from "@/src/core";
/**
* The practice transcript cards (practice sessions, owner design
* 2026-10-04): three quiet records in the stream —
*
* - ProblemCard — a posed problem: the statement, compact-expandable
* (like every card here; the dock is the working surface, this is the
* record). The commitment NEVER renders — only the call's statement.
* - ConcludeCard — the conclusion: outcome badge + verdict + the reveal
* (the committed solution, shown when the problem ended). A dismissal
* synthesis (outcome:"dismissed") renders as one muted line.
* - ThinkingCard — the learner's own submission, user-side: the register
* is the two buttons' (Nudge = working trace, Commit = answer). The
* UNIFIED ThinkingBlock (owner round 2026-10-05): the quiz quote-block
* language in a faint user-side shell, never collapsible.
*/
import { ChevronDownIcon } from "lucide-react";
import { useEffect, useState } from "react";
import { ThinkingBlock } from "@/components/thinking-block";
/* TARGET NAMES (owner round 17, 2026-10-06): targets are normalized to
* opaque node ids at the record seam (owner round 9 — the mastery trace
* groups on them), so the drawer resolves names at render time. One
* lazy module-cached fetch of the graph view (the id → name map is a
* few KB); failures degrade to raw ids — observability never breaks the
* card. */
let nodeNameMapPromise: Promise<Record<string, string>> | null = null;
function nodeNameMap(): Promise<Record<string, string>> {
nodeNameMapPromise ??= fetch("/api/graph")
.then((r) => (r.ok ? r.json() : { nodes: [] }))
.then((g: { nodes?: Array<{ id?: unknown; name?: unknown }> }) =>
Object.fromEntries(
(g.nodes ?? [])
.filter((n) => typeof n.id === "string")
.map((n) => [n.id as string, typeof n.name === "string" ? (n.name as string) : (n.id as string)]),
),
)
.catch(() => ({}));
return nodeNameMapPromise;
}
/** The practice-thinking marker's details (native-messages.ts). */
export interface PracticeThinkingData {
problemCallId: string;
/** Legacy records (pre 2026-10-05) carry the old two-lane flag; ignored. */
commit?: boolean;
text: string;
}
export function ProblemCard({ part }: ArtifactPartProps) {
// Always open, no chevron (owner round, 2026-10-05): the record IS the
// statement — same container + eyebrow discipline as the answered card
// and the dock (which mirrors this in Slice D). The commitment never
// renders — only the call's statement.
const input = (part.input ?? {}) as { statement?: string };
const statement = typeof input.statement === "string" ? input.statement : "";
return (
<div data-testid="problem-card" className="lh-card-enter my-1 rounded-xl border bg-card p-4">
<div className="mb-1 text-xs font-medium uppercase tracking-wide text-muted-foreground">Problem</div>
<div className="lh-prose text-[15px]">
<MessageResponse>{statement}</MessageResponse>
</div>
</div>
);
}
const OUTCOME_LABEL: Record<string, string> = {
solved: "Solved",
solvedWithHints: "Solved with hints",
movedOn: "Moved on",
surrendered: "Surrendered",
dismissed: "Dismissed",
};
/* The outcome chips (owner round 3, 2026-10-05): the EXACT register of the
* quiz cards' correct/incorrect bubbles. Colors per outcome — solved reads
* green (the "correct" twin), solved-with-hints amber (succeeded with
* cost), surrendered red (the problem beat the learner), moved on muted
* (the agent's call, not a verdict against him). */
const OUTCOME_CHIP: Record<string, string> = {
solved: "bg-green-500/15 text-green-500",
solvedWithHints: "bg-amber-500/15 text-amber-500",
movedOn: "bg-muted text-muted-foreground",
surrendered: "bg-red-500/15 text-red-500",
dismissed: "bg-muted text-muted-foreground",
};
export function ConcludeCard({ part }: ArtifactPartProps) {
// The conclusion redesigned (owner round, 2026-10-05): the SOLUTION is
// the hero — the modelSolution committed at pose time (part.reveal, the
// view-seam join), shown verbatim, never re-authored. The verdict sits
// below in the quiz-explanation register (small, muted, low-key).
// Nothing collapsible. Legacy inputs (pre-slim records) that carry
// their own solutionReveal fall back to it.
const input = (part.input ?? {}) as { outcome?: string; verdict?: string; solutionReveal?: string };
const outcome = typeof input.outcome === "string" ? input.outcome : "";
const verdict = typeof input.verdict === "string" ? input.verdict : "";
const reveal =
typeof part.reveal === "string" ? part.reveal : typeof input.solutionReveal === "string" ? input.solutionReveal : "";
// The dismissal synthesis: no verdict, no reveal — one muted line (the
// learner clicked; the record needs only the fact).
if (outcome === "dismissed") {
return (
<div data-testid="conclude-card" className="my-1 px-1 text-sm text-muted-foreground/70">
Problem dismissed.
</div>
);
}
return (
<div data-testid="conclude-card" className="lh-card-enter my-1 rounded-xl border bg-card p-4">
{/* The heading row (owner round 3, 2026-10-05): plain 'Concluded'
eyebrow + the outcome in the quiz cards' EXACT chip register —
no more two same-weight headings stacked. */}
<div className="mb-1 flex items-center gap-2 text-xs font-medium uppercase tracking-wide text-muted-foreground">
Concluded
{(OUTCOME_LABEL[outcome] ?? "") !== "" && outcome !== "dismissed" && (
<span className={cn("rounded px-1.5 py-0.5", OUTCOME_CHIP[outcome] ?? OUTCOME_CHIP.movedOn)}>
{OUTCOME_LABEL[outcome]}
</span>
)}
</div>
{/* The verdict — plain prose under the heading, no 'Verdict:' label
(owner round 3): the same quiet 50% register as quiz explanations. */}
{verdict.length > 0 && (
<div className="text-sm text-foreground/50">
<MessageResponse>{verdict}</MessageResponse>
</div>
)}
{/* Then the divider, then the labeled model solution (Slice G: the
hero is the pose's commitment, verbatim). */}
{reveal.length > 0 && (
<>
<div className="my-3 border-t" />
<div>
<div className="mb-0.5 text-xs font-medium uppercase tracking-wide text-muted-foreground">Model solution</div>
<div className="lh-prose text-[15px]">
<MessageResponse>{reveal}</MessageResponse>
</div>
</div>
</>
)}
<AgentsDataDrawer
concludeInput={input}
problemInput={(part.problemInput ?? {}) as { mode?: unknown; target?: unknown }}
/>
</div>
);
}
/* THE AGENT'S DATA DRAWER (owner round 17, 2026-10-06 — full
* transparency): a collapsible at the very bottom of the conclude card,
* arriving collapsed, showing every field the agent filled in both the
* problem call (mode, targets) and the conclude call (outcome, rung,
* miss class, retest). Statement and modelSolution stay out — they are
* the visible card above. Pure rows, the eyebrow register, mono values. */
function AgentsDataDrawer({
concludeInput,
problemInput,
}: {
concludeInput: { outcome?: string; rung?: unknown; missClass?: unknown; retest?: unknown };
problemInput: { mode?: unknown; target?: unknown };
}) {
const [open, setOpen] = useState(false);
const [names, setNames] = useState<Record<string, string> | null>(null);
const targets = Array.isArray(problemInput.target)
? problemInput.target.filter((t): t is string => typeof t === "string")
: [];
// Resolve names only when there is something to resolve.
useEffect(() => {
if (!open || targets.length === 0 || names) return;
let alive = true;
void nodeNameMap().then((m) => {
if (alive) setNames(m);
});
return () => {
alive = false;
};
}, [open, targets.length, names]);
const mode = typeof problemInput.mode === "string" ? problemInput.mode : "";
const rung = typeof concludeInput.rung === "string" ? concludeInput.rung : "";
const miss = typeof concludeInput.missClass === "string" ? concludeInput.missClass : "";
const retest = typeof concludeInput.retest === "boolean" ? concludeInput.retest : undefined;
const outcome = typeof concludeInput.outcome === "string" ? concludeInput.outcome : "";
if (!mode && targets.length === 0 && !rung && !miss && retest === undefined) return null;
return (
<>
<div className="my-3 border-t" />
<div>
<button
type="button"
data-testid="agents-data-toggle"
onClick={() => setOpen((v) => !v)}
aria-expanded={open}
className="flex w-full items-center gap-1 text-xs font-medium uppercase tracking-wide text-muted-foreground transition-colors hover:text-foreground"
>
<ChevronDownIcon className={cn("size-3.5 transition-transform", open && "rotate-180")} />
Agent&rsquo;s data
</button>
{open && (
<dl data-testid="agents-data" className="mt-2 grid grid-cols-[auto_1fr] gap-x-4 gap-y-1 text-xs">
<dt className="text-muted-foreground">Mode</dt>
<dd className="font-mono">{mode || "—"}</dd>
<dt className="text-muted-foreground">Targets</dt>
<dd className="font-mono">
{targets.length === 0 ? (
"untagged"
) : (
<span>
{targets.map((t, i) => (
<span key={t}>
{i > 0 && ", "}
{names?.[t] ?? t}
</span>
))}
</span>
)}
</dd>
<dt className="text-muted-foreground">Outcome</dt>
<dd className="font-mono">{outcome || "—"}</dd>
<dt className="text-muted-foreground">Hint rung</dt>
<dd className="font-mono">{rung || "none"}</dd>
<dt className="text-muted-foreground">Miss class</dt>
<dd className="font-mono">{miss || "none"}</dd>
<dt className="text-muted-foreground">Retest</dt>
<dd className="font-mono">{retest === undefined ? "—" : retest ? "yes" : "no"}</dd>
</dl>
)}
</div>
</>
);
}
export function ThinkingCard({ data }: { data: PracticeThinkingData }) {
// The unified row (owner rounds, 2026-10-05): one style, one label —
// collapsed arrival, "Your thinking", 50%-italic quote block on expand.
// Legacy records' commit flag is deliberately unread (one lane now).
return <ThinkingBlock testId="thinking-card" label="YOUR THINKING" text={data.text} />;
}