Skip to content

A desktop coding agent with free access to frontier models.

TypeScript

feat(desktop): replay-ready sessions and spins get a star

ogsamrat38a4208fbc83
diff --git a/apps/app/src/app/lib/quality.ts b/apps/app/src/app/lib/quality.ts
index e8cca058..f2ff7b75 100644
--- a/apps/app/src/app/lib/quality.ts
+++ b/apps/app/src/app/lib/quality.ts
@@ -270,6 +270,9 @@ export function nearMissText(spin: QualitySpin, jackpotTokens?: number | null):
return `So close to ${compactTokenCount(jackpot)}!`;
}
+/** The star, explained wherever it shows. */
+export const CLIENT_GRADE_NOTE = "★ Client-grade sessions earn +2 spins on a richer wheel.";
+
export function newSpinIdempotencyKey(): string {
return globalThis.crypto.randomUUID();
}
diff --git a/apps/app/src/react-app/domains/quality/quality-notice.tsx b/apps/app/src/react-app/domains/quality/quality-notice.tsx
index 0f1ac7c6..d1399e5d 100644
--- a/apps/app/src/react-app/domains/quality/quality-notice.tsx
+++ b/apps/app/src/react-app/domains/quality/quality-notice.tsx
@@ -6,6 +6,7 @@ import { cn } from "@/lib/utils";
import { omnirushAccountStatus, omnirushQualityDetails } from "../../../app/lib/desktop";
import {
+ CLIENT_GRADE_NOTE,
NOTICE_SEEN_STORAGE_KEY,
NUDGE_SEEN_STORAGE_KEY,
canSpinNow,
@@ -56,6 +57,8 @@ export function SessionReasons({ reasons }: { reasons: QualitySessionReasons | n
if (sessions === null) return <div className="text-xs text-white/50">Loading your sessions…</div>;
if (!sessions.length) return <div className="text-xs text-white/50">No sessions checked yet. They are checked about once an hour.</div>;
return (
+ <>
+ <p className="mb-2 text-[11px] text-amber-200/80" data-testid="quality-client-grade-note">{CLIENT_GRADE_NOTE}</p>
<ul className="space-y-2" data-testid="quality-session-reasons">
{sessions.slice(0, 6).map((session) => (
<li key={session.sessionId} className="rounded-xl border border-white/10 bg-black/20 px-3 py-2">
@@ -67,10 +70,12 @@ export function SessionReasons({ reasons }: { reasons: QualitySessionReasons | n
</div>
{session.why ? <div className="mt-0.5 text-xs leading-5 text-white/80">{session.why}</div> : null}
{workSummary(session.work) ? <div className="mt-0.5 text-[10.5px] text-white/45">{workSummary(session.work)}</div> : null}
- {session.fails.length || session.reproducible === "pass" ? (
+ {session.fails.length || session.reproducible === "pass" || session.clientGrade ? (
<div className="mt-1 flex flex-wrap gap-1">
- {session.reproducible === "pass" ? (
- <span className="rounded-full bg-[#a3e635]/15 px-1.5 py-0.5 text-[10px] text-[#d9f99d]">reproducible</span>
+ {session.clientGrade ? (
+ <span data-testid="quality-client-grade" className="rounded-full bg-amber-300/15 px-1.5 py-0.5 text-[10px] font-semibold text-amber-200">client-grade ★</span>
+ ) : session.reproducible === "pass" ? (
+ <span data-testid="quality-reproducible" className="rounded-full bg-[#a3e635]/15 px-1.5 py-0.5 text-[10px] text-[#d9f99d]">reproducible ✓</span>
) : null}
{session.fails.map((fail) => (
<span key={fail} data-fail={fail} className="rounded-full bg-white/[0.06] px-1.5 py-0.5 text-[10px] text-white/60">
@@ -82,6 +87,7 @@ export function SessionReasons({ reasons }: { reasons: QualitySessionReasons | n
</li>
))}
</ul>
+ </>
);
}
diff --git a/apps/app/src/react-app/domains/quality/quality-parts.tsx b/apps/app/src/react-app/domains/quality/quality-parts.tsx
index 688a2fdb..dad83c90 100644
--- a/apps/app/src/react-app/domains/quality/quality-parts.tsx
+++ b/apps/app/src/react-app/domains/quality/quality-parts.tsx
@@ -78,13 +78,17 @@ export function SpinButton(props: {
}) {
const { quality } = props;
const ready = quality.spinsAvailable;
+ const stars = Math.min(ready, quality.clientSpinsAvailable ?? 0);
return (
<button
type="button"
onClick={props.onClick}
data-testid={props.testId ?? "quality-spin-button"}
data-spins={ready}
- title={ready > 0 ? `${ready} spin${ready === 1 ? "" : "s"} ready` : "No spins yet: good sessions earn spins."}
+ data-client-spins={stars}
+ title={ready > 0
+ ? `${ready} spin${ready === 1 ? "" : "s"} ready${stars > 0 ? `, ${stars} client-grade ★ on the richer wheel` : ""}`
+ : "No spins yet: good sessions earn spins."}
className={cn(
"relative inline-flex h-6 items-center gap-1.5 rounded-full px-2.5 text-[11px] font-semibold transition",
ready > 0
@@ -103,6 +107,14 @@ export function SpinButton(props: {
</span>
</span>
) : null}
+ {stars > 0 ? (
+ <span
+ data-testid="quality-client-spins"
+ className="inline-flex h-4 items-center rounded-full bg-amber-300 px-1 text-[9.5px] font-bold text-amber-950"
+ >
+ ★{stars > 9 ? "9+" : stars}
+ </span>
+ ) : null}
</button>
);
}
diff --git a/apps/app/src/react-app/domains/quality/quality-spin-dialog.tsx b/apps/app/src/react-app/domains/quality/quality-spin-dialog.tsx
index 3ad29c89..66355981 100644
--- a/apps/app/src/react-app/domains/quality/quality-spin-dialog.tsx
+++ b/apps/app/src/react-app/domains/quality/quality-spin-dialog.tsx
@@ -7,6 +7,7 @@ import { cn } from "@/lib/utils";
import { omnirushAccountStatus, omnirushQualityDetails, omnirushQualitySpin, omnirushQualitySpins } from "../../../app/lib/desktop";
import { compactTokenCount } from "../../../app/lib/omnirush-usage";
import {
+ CLIENT_GRADE_NOTE,
DEFAULT_WHEEL_SEGMENTS,
SOUND_STORAGE_KEY,
canSpinNow,
@@ -176,12 +177,23 @@ export function QualitySpinDialog(props: QualitySpinDialogProps) {
data-phase={phase}
className="relative w-full max-w-[520px] overflow-hidden rounded-[28px] border border-white/10 bg-[radial-gradient(ellipse_at_top,#1a2e05_0%,#0b1120_45%,#05070c_100%)] p-6 text-white shadow-2xl shadow-black/60"
>
+ {result?.clientGrade ? (
+ <div
+ data-testid="quality-client-grade-header"
+ className="-mx-6 -mt-6 mb-4 bg-gradient-to-r from-amber-500/30 via-amber-300/25 to-amber-500/30 px-6 py-2 text-center text-xs font-bold uppercase tracking-[0.24em] text-amber-200"
+ >
+ ★ client-grade wheel
+ </div>
+ ) : null}
<div className="flex items-start justify-between gap-3">
<div className="min-w-0">
<div className="flex items-center gap-2">
<QualityTierBadge quality={quality} />
<span className="text-[11px] text-white/50">
{spinsLeft} spin{spinsLeft === 1 ? "" : "s"} ready
+ {!result && quality.clientSpinsAvailable > 0 ? (
+ <span className="ms-1 font-semibold text-amber-200" data-testid="quality-dialog-client-spins">· ★{quality.clientSpinsAvailable} client-grade</span>
+ ) : null}
</span>
</div>
<h2 id="quality-spin-title" className="mt-2 text-2xl font-semibold tracking-[-0.02em]">
@@ -267,9 +279,13 @@ export function QualitySpinDialog(props: QualitySpinDialogProps) {
{spinPayoutText(result)}
</div>
<div className="mt-2 flex flex-wrap items-center justify-center gap-2 text-[11px]">
- {result.reproducible ? (
+ {result.clientGrade ? (
+ <span className="inline-flex items-center gap-1 rounded-full border border-amber-300/50 bg-amber-300/15 px-2 py-0.5 font-semibold text-amber-200">
+ client-grade ★
+ </span>
+ ) : result.reproducible ? (
<span className="inline-flex items-center gap-1 rounded-full border border-[#a3e635]/40 bg-[#a3e635]/10 px-2 py-0.5 text-[#d9f99d]">
- <Sparkles className="size-3" aria-hidden="true" /> Reproducible session
+ <Sparkles className="size-3" aria-hidden="true" /> reproducible ✓
</span>
) : null}
{result.alreadySpun ? <span className="text-white/50">This spin was already counted.</span> : null}
@@ -291,6 +307,7 @@ export function QualitySpinDialog(props: QualitySpinDialogProps) {
<div className="pt-4 text-sm text-white/60">
{quality.preview ? "Preview: spins show what you would win, and pay 0 tokens." : "The wheel decides. Every prize goes into your pot."}
{expectedTokens ? <span className="block text-white/40">Average spin: {compactTokenCount(expectedTokens)} tokens</span> : null}
+ <span className="mt-1 block text-[11px] text-amber-200/70" data-testid="quality-client-grade-note">{CLIENT_GRADE_NOTE}</span>
</div>
)}
</div>
diff --git a/apps/app/src/react-app/domains/session/sidebar/app-sidebar.tsx b/apps/app/src/react-app/domains/session/sidebar/app-sidebar.tsx
index 11ea3b18..e88f7094 100644
--- a/apps/app/src/react-app/domains/session/sidebar/app-sidebar.tsx
+++ b/apps/app/src/react-app/domains/session/sidebar/app-sidebar.tsx
@@ -1003,7 +1003,7 @@ function QualityFooterStrip({ quality }: { quality: AccountQuality }) {
>
{hint ? <ProgressRing progress={hint.progress} size={16} stroke={2.25} /> : null}
<span className="truncate">
- {hint ? `next ${Math.round(hint.progress * 100)}%` : quality.streakDays > 0 ? `${quality.streakDays}-day streak` : "How to earn spins"}
+ {hint ? `${Math.round(hint.progress * 100)}%` : quality.streakDays > 0 ? `${quality.streakDays}-day streak` : "How to earn spins"}
</span>
</button>
</div>
diff --git a/apps/app/tests/quality.test.tsx b/apps/app/tests/quality.test.tsx
index 59e93fb9..907560b2 100644
--- a/apps/app/tests/quality.test.tsx
+++ b/apps/app/tests/quality.test.tsx
@@ -26,7 +26,7 @@ import {
type QualitySpin,
type QualityTier,
} from "../src/app/lib/quality";
-import { QualityTierBadge, streakText } from "../src/react-app/domains/quality/quality-parts";
+import { QualityTierBadge, SpinButton, streakText } from "../src/react-app/domains/quality/quality-parts";
import { QualityNoticeCard, QualityRewards, SessionReasons, failLabel } from "../src/react-app/domains/quality/quality-notice";
import { QualitySpinDialog } from "../src/react-app/domains/quality/quality-spin-dialog";
@@ -36,6 +36,7 @@ const quality: AccountQuality = {
tokensMultiplier: 1,
spinsAvailable: 2,
reproSpinsAvailable: 1,
+ clientSpinsAvailable: 0,
spinsExpireAt: "2026-10-06T10:00:00Z",
nextTierHint: "Score 0.52. Stay above 0.45 to keep Gold.",
tips: ["Start omnirush inside the project folder, not ~, and keep edits there.", "Add tests: tested work earns spins."],
@@ -68,6 +69,7 @@ const spin: QualitySpin = {
nearMiss: false,
jackpotTokens: 10_000_000,
streakDays: 4,
+ clientGrade: false,
};
function memoryStorage() {
@@ -257,14 +259,40 @@ describe("revision: fail labels, jackpot, open session", () => {
failLabels: { home_folder: "Started in your home folder" },
sessions: [{
sessionId: "ses_1", at: null, verdict: "review", why: "Started in ~.", fails: ["home_folder"], workspace: "my-app", spins: 0, counted: true,
- reproducible: "pass", workSize: 3, work: { codeFiles: 3, linesChanged: 120, toolCalls: 14, testRuns: 0, floor: 2, step: 3 },
+ reproducible: "pass", reproClient: "fail", clientGrade: false, workSize: 3, work: { codeFiles: 3, linesChanged: 120, toolCalls: 14, testRuns: 0, floor: 2, step: 3 },
}],
}}
/>,
);
expect(html).toContain("Started in your home folder");
expect(html).toContain("3 code files · 120 lines · no tests");
- expect(html).toContain("reproducible");
+ expect(html).toContain("reproducible ✓");
+ expect(html).not.toContain("client-grade ★");
+ expect(html).toContain("+2 spins on a richer wheel");
+ });
+
+ test("the spin button shows a ★ count only for client-grade spins", () => {
+ const plain = renderToStaticMarkup(<SpinButton quality={quality} onClick={() => undefined} />);
+ expect(plain).not.toContain("quality-client-spins");
+ const starred = renderToStaticMarkup(<SpinButton quality={{ ...quality, clientSpinsAvailable: 1 }} onClick={() => undefined} />);
+ expect(starred).toContain("data-testid=\"quality-client-spins\"");
+ expect(starred).toContain("★1");
+ });
+
+ test("a client-grade session shows the star instead of the check", () => {
+ const html = renderToStaticMarkup(
+ <SessionReasons
+ reasons={{
+ failLabels: {},
+ sessions: [{
+ sessionId: "ses_2", at: null, verdict: "recommended", why: "Replays on a clean machine.", fails: [], workspace: "my-app", spins: 4, counted: true,
+ reproducible: "pass", reproClient: "pass", clientGrade: true, workSize: 4, work: null,
+ }],
+ }}
+ />,
+ );
+ expect(html).toContain("client-grade ★");
+ expect(html).not.toContain("reproducible ✓");
});
test("the jackpot slice is the segment paying jackpot_tokens", () => {
diff --git a/apps/desktop/electron/omnirush-account.mjs b/apps/desktop/electron/omnirush-account.mjs
index 183e5adc..39aaa7a4 100644
--- a/apps/desktop/electron/omnirush-account.mjs
+++ b/apps/desktop/electron/omnirush-account.mjs
@@ -1129,6 +1129,7 @@ export function createDesktopOmniRushAccountStore({
const jackpot = Number(payload.jackpot_tokens);
return {
segments: parseWheelSegments(payload.segments),
+ clientSegments: parseWheelSegments(payload.client_segments),
expectedTokens: Number.isFinite(expected) ? expected : null,
jackpotTokens: Number.isFinite(jackpot) && jackpot > 0 ? jackpot : null,
sessions: parseQualitySessions(payload.sessions),
diff --git a/apps/desktop/electron/quality.mjs b/apps/desktop/electron/quality.mjs
index 0598256c..7da0cb81 100644
--- a/apps/desktop/electron/quality.mjs
+++ b/apps/desktop/electron/quality.mjs
@@ -18,6 +18,7 @@ export const SPIN_REFUSALS = /** @type {const} */ (["no_spins", "wheel_resting",
* tokensMultiplier: number,
* spinsAvailable: number,
* reproSpinsAvailable: number,
+ * clientSpinsAvailable: number,
* spinsExpireAt: string | null,
* nextTierHint: string | null,
* tips: string[],
@@ -127,6 +128,8 @@ export function parseAccountQuality(value) {
tokensMultiplier: Number.isFinite(multiplier) && multiplier > 0 ? multiplier : 1,
spinsAvailable,
reproSpinsAvailable: Math.min(spinsAvailable, count(value.repro_spins_available)),
+ // Of those, earned by client-grade sessions (the richer wheel).
+ clientSpinsAvailable: Math.min(spinsAvailable, count(value.client_spins_available)),
spinsExpireAt: isoTime(value.spins_expire_at),
nextTierHint: text(value.next_tier_hint),
tips: Array.isArray(value.tips) ? value.tips.map(text).filter((tip) => tip !== null).slice(0, 8) : [],
@@ -179,6 +182,8 @@ export function parseSpinResult(value) {
nearMiss: value.near_miss === true,
jackpotTokens: count(value.jackpot_tokens) || null,
streakDays: value.streak_days === undefined || value.streak_days === null ? null : count(value.streak_days),
+ // A spin earned by a client-grade session, on the richer wheel (`segments` is the wheel used).
+ clientGrade: value.client_grade === true,
};
}
@@ -197,12 +202,19 @@ export function parseQualitySessions(value) {
workspace: text(session.workspace),
spins: count(session.spins),
counted: session.counted === true,
- reproducible: ["pass", "fail", "unknown"].includes(session.reproducible) ? session.reproducible : null,
+ // The looser reward level; `reproClient` is the strict client grade.
+ reproducible: reproLevel(session.reproducible),
+ reproClient: reproLevel(session.repro_client),
+ clientGrade: session.client_grade === true,
workSize: Number.isInteger(session.work_size) ? Math.min(4, Math.max(0, session.work_size)) : null,
work: parseSessionWork(session.work),
}));
}
+function reproLevel(value) {
+ return value === "pass" || value === "fail" || value === "unknown" ? value : null;
+}
+
function parseSessionWork(value) {
if (!value || typeof value !== "object") return null;
return {
diff --git a/apps/desktop/electron/quality.test.mjs b/apps/desktop/electron/quality.test.mjs
index 49e5db6f..8ed179db 100644
--- a/apps/desktop/electron/quality.test.mjs
+++ b/apps/desktop/electron/quality.test.mjs
@@ -18,6 +18,7 @@ const QUALITY = {
tokens_multiplier: 1,
spins_available: 2,
repro_spins_available: 1,
+ client_spins_available: 1,
spins_expire_at: "2026-10-06T10:00:00Z",
next_tier_hint: "Keep it up.",
tips: ["Start omnirush inside the project folder.", "", 7],
@@ -80,6 +81,7 @@ test("quality block parses every field, including revision 2", () => {
tokensMultiplier: 1,
spinsAvailable: 2,
reproSpinsAvailable: 1,
+ clientSpinsAvailable: 1,
spinsExpireAt: "2026-10-06T10:00:00Z",
nextTierHint: "Keep it up.",
tips: ["Start omnirush inside the project folder."],
@@ -109,6 +111,8 @@ test("a spin answer must name a segment the wheel can land on", () => {
assert.equal(spin.reproducible, true);
assert.equal(spin.celebrate, "none");
assert.equal(spin.jackpotTokens, 10000000);
+ assert.equal(spin.clientGrade, false);
+ assert.equal(parseSpinResult({ ...SPIN, client_grade: true }).clientGrade, true);
assert.equal(parseSpinResult({ ...SPIN, segment_index: 6 }), null);
assert.equal(parseSpinResult({ ...SPIN, segment_index: -1 }), null);
assert.equal(parseSpinResult({ ...SPIN, segments: [] }), null);
@@ -217,8 +221,9 @@ test("quality details: segments, expected tokens and the sessions' reasons", asy
return Response.json({
quality: QUALITY,
sessions: [{ session_id: "ses_1", at: "2026-10-04T10:00:00Z", verdict: "review", why: "Edits outside the project.", fails: ["outside_path"], workspace: "my-app", spins: 0, counted: true,
- reproducible: "fail", work_size: 3, work: { code_files: 3, lines_changed: 120, tool_calls: 14, test_runs: 0, floor: 2, step: 3 } },
- { session_id: "ses_2", reproducible: "maybe", work_size: 9, work: null }],
+ reproducible: "pass", repro_client: "fail", client_grade: false, work_size: 3, work: { code_files: 3, lines_changed: 120, tool_calls: 14, test_runs: 0, floor: 2, step: 3 } },
+ { session_id: "ses_2", reproducible: "maybe", repro_client: "pass", client_grade: true, work_size: 9, work: null }],
+ client_segments: [{ tokens: 1000000, weight: 50 }, { tokens: 20000000, weight: 1 }],
segments: SEGMENTS,
expected_tokens: 1037500,
jackpot_tokens: 10000000,
@@ -231,7 +236,12 @@ test("quality details: segments, expected tokens and the sessions' reasons", asy
assert.equal(details.jackpotTokens, 10000000);
assert.deepEqual(details.failLabels, { outside_path: "Edits outside the project folder" });
assert.deepEqual(details.sessions[0].fails, ["outside_path"]);
- assert.equal(details.sessions[0].reproducible, "fail");
+ assert.equal(details.sessions[0].reproducible, "pass");
+ assert.equal(details.sessions[0].reproClient, "fail");
+ assert.equal(details.sessions[0].clientGrade, false);
+ assert.equal(details.sessions[1].reproClient, "pass");
+ assert.equal(details.sessions[1].clientGrade, true);
+ assert.deepEqual(details.clientSegments, [{ tokens: 1000000, weight: 50 }, { tokens: 20000000, weight: 1 }]);
assert.equal(details.sessions[0].workSize, 3);
assert.deepEqual(details.sessions[0].work, { codeFiles: 3, linesChanged: 120, toolCalls: 14, testRuns: 0, floor: 2, step: 3 });
assert.equal(details.sessions[1].reproducible, null);
diff --git a/packages/types/src/desktop-ipc.ts b/packages/types/src/desktop-ipc.ts
index d97ab969..e3d979c5 100644
--- a/packages/types/src/desktop-ipc.ts
+++ b/packages/types/src/desktop-ipc.ts
@@ -216,6 +216,8 @@ export type OmniRushAccountQuality = {
spinsAvailable: number;
/** Of `spinsAvailable`, those earned by reproducible sessions (always payable). */
reproSpinsAvailable: number;
+ /** Of `spinsAvailable`, those earned by client-grade sessions (the richer wheel). */
+ clientSpinsAvailable: number;
/** UTC ISO 8601, the soonest expiry. */
spinsExpireAt: string | null;
nextTierHint: string | null;
@@ -253,7 +255,12 @@ export type OmniRushQualitySession = {
workspace: string | null;
spins: number;
counted: boolean;
+ /** The reward level of reproducibility. */
reproducible: "pass" | "fail" | "unknown" | null;
+ /** The strict client grade. */
+ reproClient: "pass" | "fail" | "unknown" | null;
+ /** Client-grade: +2 spins, on the richer wheel. */
+ clientGrade: boolean;
/** The work-size step, 0..4. */
workSize: number | null;
work: { codeFiles: number; linesChanged: number; toolCalls: number; testRuns: number; floor: number; step: number } | null;
@@ -261,6 +268,8 @@ export type OmniRushQualitySession = {
export type OmniRushQualityDetails = {
segments: OmniRushWheelSegment[];
+ /** The richer wheel client-grade spins use. */
+ clientSegments: OmniRushWheelSegment[];
expectedTokens: number | null;
/** The top segment's prize. */
jackpotTokens: number | null;
@@ -295,6 +304,8 @@ export type OmniRushQualitySpin = {
nearMiss: boolean;
jackpotTokens: number | null;
streakDays: number | null;
+ /** Earned by a client-grade session; spun on the richer wheel. */
+ clientGrade: boolean;
};
export type OmniRushQualitySpinRefusal = "no_spins" | "wheel_resting" | "quality_rewards_off";