icoa-cli 2.19.457 → 2.19.459

package/dist/lib/arena-submit.d.ts

@@ -1,23 +0,0 @@
-/**
- * arena-submit — pure builder for an arena submission payload (Phase 3 of the
- * CLI notebook arena). The all-in-CLI loop: a student computes in `icoa ipynb`,
- * saves a local predictions.csv, and submits it here.
- *
- * If the input is a path that exists on disk, we send its CONTENT inline
- * (`predictions_csv`) — this is what makes local submission work against a
- * REMOTE server (prod can't read the student's disk, so a bare path is useless;
- * the legacy Google-Drive link existed only to get the file TO the server).
- * Otherwise we fall back to the Drive link (`gdrive_url`). Kept pure (fs deps
- * injected) so the routing decision is unit-tested.
- */
-export interface SubmitPayload {
-    arena_token: string;
-    predictions_csv?: string;
-    gdrive_url?: string;
-    source: 'local' | 'gdrive';
-}
-export interface SubmitFsDeps {
-    exists: (path: string) => boolean;
-    read: (path: string) => string;
-}
-export declare function buildSubmitPayload(input: string, arenaToken: string, deps: SubmitFsDeps): SubmitPayload;

package/dist/lib/banner.d.ts

@@ -1,9 +0,0 @@
-export declare const ICOA_BIG: readonly string[];
-/**
- * Ready-to-print logo lines, bold white, indented by `indent`.
- *
- * Degrades to a one-line wordmark when the terminal is too narrow for the block
- * art (Chromebook split-screen / narrow WSL pane), so it never overflow-wraps.
- * 60 cols is the rich-display floor from the cross-platform baseline.
- */
-export declare function icoaBannerLines(indent?: string): string[];

package/dist/lib/bgtasks.d.ts

@@ -1,21 +0,0 @@
-import { type ChildProcess } from 'node:child_process';
-export interface BgTask {
-    id: number;
-    cmd: string;
-    kind: 'shell' | 'async';
-    status: 'running' | 'done' | 'failed';
-    exitCode: number | null;
-    startedAt: number;
-    endedAt: number | null;
-    output: string;
-    child?: ChildProcess;
-    render?: () => void;
-    notified: boolean;
-}
-export declare function startBgTask(cmd: string, cwd: string): BgTask;
-export declare function startAsyncTask<T>(label: string, worker: () => Promise<T>, renderer: (result: T) => void): BgTask;
-export declare function listBgTasks(): BgTask[];
-export declare function getBgTask(id: number): BgTask | undefined;
-export declare function runningCount(): number;
-export declare function drainCompleted(): BgTask[];
-export declare function killAllBgTasks(): void;

package/dist/lib/board-render.d.ts

@@ -1,14 +0,0 @@
-/**
- * board-render — pure formatting for the ICOA Board CLI (no chalk, no I/O;
- * caller applies colors). Mirrors the arena-submit.ts pure-module pattern.
- */
-export interface BoardRow {
-    rank: number;
-    label: string;
-    value?: number | null;
-    display_score?: number | null;
-    total_display?: number | null;
-    tasks_counted?: number;
-}
-export declare function deltaLine(prevRank: number | null | undefined, rank: number | null | undefined, fieldSize: number | null | undefined): string;
-export declare function renderBoardLines(rows: BoardRow[], width: number): string[];

package/dist/lib/budget.d.ts

@@ -1 +0,0 @@
-export declare function addTokenUsage(tokensUsed: number): void;

package/dist/lib/card-engine.d.ts

@@ -1,45 +0,0 @@
-export interface CardChoice {
-    key: string;
-    text: string;
-}
-export interface Card {
-    /** Short all-caps label shown in the card header. */
-    title: string;
-    /** Optional chartart block — pre-rendered ASCII, one string per line. */
-    chartart?: string[];
-    /** Narrative body lines. */
-    body: string[];
-    choices: CardChoice[];
-    /** Key of the correct choice, lower-case. */
-    correct: string;
-    /** Shown after the user answers, regardless of right or wrong. */
-    reveal: string[];
-}
-export interface Deck {
-    /** Command word — also the sub-REPL prompt token (`icoa demo4> `). */
-    id: string;
-    /** Banner title line. */
-    title: string;
-    /** Banner subtitle / tagline. */
-    tagline: string;
-    /** Accent colour applied to the frame. */
-    accent: 'cyan' | 'magenta' | 'green' | 'yellow';
-    cards: Card[];
-    /** Terminal payload — the render reward. */
-    finale: () => Promise<void>;
-    /** Closing hook lines shown after the finale. */
-    outro: string[];
-}
-/** A deck bundle carries both language variants; the runner picks one. */
-export interface DeckPack {
-    en: Deck;
-    zh: Deck;
-}
-/** True while a card deck owns stdin. The main REPL's prompt wrapper checks
- *  this so it does not stamp `icoa> ` over our `icoa demo4> `. */
-export declare function isCardDeckActive(): boolean;
-/**
- * Run a two-language card pack. Typing `zh` / `en` (or `lang zh` / `lang en`)
- * at any card prompt switches language and restarts the deck.
- */
-export declare function runDeckPack(pack: DeckPack, initialLang: string): Promise<void>;

package/dist/lib/challenge-dir.d.ts

@@ -1 +0,0 @@
-export declare function challengeDownloadDir(id: string, base?: string): string;

package/dist/lib/colors.d.ts

@@ -1,11 +0,0 @@
-export declare const c: {
-    fg: (s: string) => string;
-    muted: (s: string) => string;
-    red: (s: string) => string;
-    green: (s: string) => string;
-    yellow: (s: string) => string;
-    blue: (s: string) => string;
-    cyan: (s: string) => string;
-    orange: (s: string) => string;
-    white: (s: string) => string;
-};

package/dist/lib/commands.d.ts

@@ -1,53 +0,0 @@
-export interface IcoaCommand {
-    /** The verb a user types. Must be reachable — a name here that dispatches
-     *  nowhere is a promise the CLI cannot keep. */
-    name: string;
-    /** Handled by an explicit `input === ...` branch ABOVE the dispatch gate
-     *  (nav verbs, screen control, background-task panels). Such a verb must
-     *  stay OUT of knownCommands: the gate never sees it. */
-    nav?: true;
-    /** Rewrites to a different argv, e.g. sb -> ctf scoreboard. */
-    mapsTo?: string[];
-    /** Append the user's remaining words to mapsTo. */
-    rest?: true;
-    /** Second-word Tab completion. Slightly stale entries are harmless — they
-     *  simply will not dispatch — but these track the real subcommand surface. */
-    subs?: string[];
-    /** The row this command gets on the `help` screen. Omit and it simply does
-     *  not appear — help is CURATED, not an index: 34 commands, ~27 rows, ordered
-     *  for a first-time reader rather than alphabetically. */
-    help?: {
-        /** Position on the help screen. The help screen is CURATED in a teaching
-         *  order (resume first, clear/exit last) which is NOT the registry's own
-         *  order — dropping this field silently reshuffled the System section, and
-         *  only the byte-for-byte baseline caught it. */
-        order: number;
-        section: 'Exam' | 'Competition' | 'AI Teammate' | 'Tools' | 'System';
-        /** Displayed form including the argument hint, e.g. 'submit <id> <flag>'.
-         *  Padded to 20 columns by the renderer. */
-        label: string;
-        text: string;
-        /** Per-mode wording. Only five commands need it — join / ref / setup /
-         *  lang / exit read differently in the short selection-mode screen than in
-         *  the full olympiad one, deliberately: the short screen trades detail for
-         *  density. A fully mode-indexed model would be machinery for five
-         *  exceptions, so the default lives in `text` and this overrides it. */
-        textByMode?: Record<string, string>;
-    };
-}
-export declare const REGISTRY: readonly IcoaCommand[];
-/** Everything typeable: Tab completion, the `/cmd` slash layer, typo suggestions. */
-export declare const surface: () => string[];
-/** The dispatch gate. Excludes nav verbs, which are consumed before the gate —
- *  listing them here would be harmless but misleading about who handles what. */
-export declare const dispatchable: () => string[];
-/** name -> argv rewrite, with the caller's trailing words appended when `rest`. */
-export declare function shortcutFor(name: string, rest: string[]): string[] | null;
-/** parent -> second-word completions. */
-export declare const subcommandsOf: (name: string) => readonly string[] | undefined;
-/** Help rows for one section, in registry order. Curated: a command without a
- *  `help` block simply does not appear on the help screen. */
-export declare const helpRows: (section: string) => Array<{
-    label: string;
-    text: string;
-}>;

package/dist/lib/comms.d.ts

@@ -1,40 +0,0 @@
-export declare function isCommsActive(): boolean;
-export declare function setCommsActive(active: boolean): void;
-export declare function isLeaderToken(s: string): boolean;
-export declare function isLeaderSession(): boolean;
-export declare function isLeaderAccount(name: string): boolean;
-export declare function sanitizeCommsLine(s: string): string;
-export declare function commsBaseUrl(): string;
-export declare function isCompetitionJoined(): boolean;
-export declare function isMelCompetition(): boolean;
-export declare function formatBroadcastBar(text: string): string;
-export declare function fetchBroadcast(): Promise<{
-    text: string;
-    ts: number | null;
-}>;
-export declare function postMemo(text: string): Promise<{
-    ok: boolean;
-    id?: number;
-    ts?: number;
-    status: number;
-    message?: string;
-}>;
-export declare function postJury(text: string): Promise<{
-    ok: boolean;
-    id?: number;
-    ts?: number;
-    status: number;
-    message?: string;
-}>;
-export declare function leaderAuth(baseUrl: string, token: string): Promise<{
-    account: string;
-    team: string;
-} | null>;
-export declare function fetchPublicScoreboard(): Promise<Array<{
-    pos: number;
-    name: string;
-    score: number;
-}>>;
-export declare function showBroadcast(): void;
-export declare function startBroadcastPoll(redraw: () => void): void;
-export declare function stopBroadcastPoll(): void;

package/dist/lib/config.d.ts

@@ -1,8 +0,0 @@
-import type { IcoaConfig, HintBudget } from '../types/index.js';
-export declare function getConfig(): IcoaConfig;
-export declare function saveConfig(config: Partial<IcoaConfig>): void;
-export declare function getBudget(): HintBudget;
-export declare function saveBudget(budget: HintBudget): void;
-export declare function getIcoaDir(): string;
-export declare function getInstallSalt(): string;
-export declare function isConnected(): boolean;

package/dist/lib/countdown.d.ts

@@ -1,4 +0,0 @@
-export declare function fetchWithCountdown<T>(fetchPromise: Promise<T>, opts?: {
-    from?: number;
-    waitText?: string;
-}): Promise<T>;

package/dist/lib/country-lang.d.ts

@@ -1 +0,0 @@
-export declare const COUNTRY_LANG: Record<string, string>;

package/dist/lib/ctfd-client.d.ts

@@ -1,33 +0,0 @@
-import type { CTFdChallenge, CTFdChallengeListItem, CTFdUser, CTFdTeam, CTFdScoreboardEntry, CTFdAttemptResponse } from '../types/index.js';
-export declare class CTFdClient {
-    private baseUrl;
-    private token;
-    private sessionCookie;
-    private csrfNonce;
-    constructor(baseUrl: string, token: string, sessionCookie?: string, csrfNonce?: string);
-    private getAuthHeaders;
-    fetchCsrfNonce(): Promise<string>;
-    private request;
-    testConnection(): Promise<CTFdUser>;
-    private testConnectionViaProfile;
-    getChallenges(): Promise<CTFdChallengeListItem[]>;
-    getChallenge(id: number): Promise<CTFdChallenge>;
-    submitFlag(challengeId: number, submission: string): Promise<CTFdAttemptResponse['data']>;
-    getScoreboard(): Promise<CTFdScoreboardEntry[]>;
-    getTeam(): Promise<CTFdTeam>;
-    getCompetitionMeta(): Promise<{
-        start: number | null;
-        end: number | null;
-        userMode: string;
-        csrfNonce: string;
-    }>;
-    getChallengeFiles(id: number): Promise<string[]>;
-    downloadFile(filePath: string, destDir: string): Promise<string>;
-    getTokenViaIcoaApi(username: string, password: string): Promise<string | null>;
-    private tokenAuthenticates;
-    loginWithCredentials(username: string, password: string): Promise<{
-        token: string;
-        session: string;
-        csrf: string;
-    }>;
-}

package/dist/lib/deck-cooldown.d.ts

@@ -1,7 +0,0 @@
-/**
- * Block until the sim cooldown clears, rendering a single-line countdown.
- * Returns immediately when no cooldown is pending (the common case).
- *
- * @param line in-fiction label, e.g. "watchdog cooling down"
- */
-export declare function awaitRenderWindow(line: string): Promise<void>;

package/dist/lib/demo-exam.d.ts

@@ -1,28 +0,0 @@
-import type { ExamQuestion, ExamSession } from '../types/index.js';
-export declare const DEMO_POOL_SIZE = 30;
-export declare const DEMO_PICK_SIZE = 10;
-export declare const DEMO_ANSWERS: Record<number, 'A' | 'B' | 'C' | 'D'>;
-export declare const DEMO_EXPLANATIONS: Record<number, string>;
-export declare const DEMO_QUESTIONS: ExamQuestion[];
-/**
- * Pick `n` random questions from the pool, shuffle each question's options,
- * renumber 1..n. Returns fully self-contained questions with answer + explanation
- * populated, so downstream code does not need to look up DEMO_ANSWERS by number.
- */
-export declare function pickDemoQuestions(n?: number): ExamQuestion[];
-/**
- * Get localized explanations for demo questions.
- * Reads from translations/<lang>/demo-explanations.json.
- * Falls back to English for any missing entries.
- */
-export declare function getLocalizedExplanations(): Record<number, string>;
-/**
- * Get demo questions translated to user's language.
- * Reads from translations/<lang>/demo.json (bundled static file).
- * Per-question fallback: missing entries use the English source.
- */
-export declare function getLocalizedDemoQuestions(): ExamQuestion[];
-/**
- * Get localized demo session name.
- */
-export declare function getLocalizedDemoSession(): ExamSession;

package/dist/lib/demo-flags.d.ts

@@ -1,8 +0,0 @@
-export declare const DEMO_AI4CTF_FLAG_B64 = "aWNvYXt3M2xjMG1lXzJfYWk0Y3RmfQ==";
-export declare const DEMO_AI4CTF_FLAG_DECODED = "icoa{w3lc0me_2_ai4ctf}";
-/**
- * Runtime verification that the b64 constant decodes to the expected plaintext.
- * Catches hand-edit drift between the two constants above.
- * Throws if they disagree. Safe to call at module load or from tests.
- */
-export declare function verifyDemoAi4ctfFlag(): void;

package/dist/lib/demo-stats.d.ts

@@ -1,17 +0,0 @@
-import type { ExamQuestion } from '../types/index.js';
-interface DemoStats {
-    best: number;
-    bestPercentage: number;
-    attempts: number;
-    lastFive: Array<{
-        score: number;
-        total: number;
-        at: string;
-    }>;
-}
-export declare function getDemoStats(): DemoStats;
-export declare function recordDemoAttempt(score: number, total: number): DemoStats;
-export declare function saveRetryQueue(questions: ExamQuestion[]): void;
-export declare function getRetryQueue(): ExamQuestion[] | null;
-export declare function clearRetryQueue(): void;
-export {};

package/dist/lib/docker-probe.d.ts

@@ -1,45 +0,0 @@
-/**
- * Detect whether the Docker daemon is running WITHOUT waking it.
- *
- * The `docker` CLI is the trigger: on macOS, running any `docker` command
- * (including `docker info`) can auto-launch Docker Desktop. The old probe
- * shelled out to `docker info`, so every REPL shell-out and every `shell`
- * invocation kept starting Docker on the user's Mac even though the sandbox is
- * OPTIONAL and the host-shell fallback is the norm (2026-07 feedback).
- *
- * This probes the daemon's listening SOCKET directly (Node `net`) and never
- * invokes the `docker` binary. Docker already up → the socket connects → we use
- * the sandbox. Docker down → connection refused → we silently use the host
- * shell, and Docker is never started.
- */
-export type DockerProbeKind = 'unix' | 'tcp' | 'npipe';
-export interface DockerProbeTarget {
-    kind: DockerProbeKind;
-    /** unix/npipe: a filesystem/pipe path. tcp: "host:port". */
-    target: string;
-}
-/**
- * Ordered daemon endpoints to probe. A `DOCKER_HOST` (unix://, tcp://, npipe://)
- * overrides everything — it's the user's explicit daemon. Otherwise fall back to
- * the well-known per-platform sockets, most-specific first. Pure + testable:
- * platform/env/home are all injected.
- */
-export declare function dockerProbeTargets(platform: NodeJS.Platform, env: NodeJS.ProcessEnv, home: string): DockerProbeTarget[];
-/**
- * True if ANY target accepts a connection, probing in order and stopping at the
- * first hit. `connect` is injected (returns whether a target is reachable) so
- * the ordering/short-circuit is unit-tested without real sockets.
- */
-export declare function anyReachable(targets: DockerProbeTarget[], connect: (t: DockerProbeTarget) => Promise<boolean>): Promise<boolean>;
-/**
- * True iff `raw` is a Docker Engine `/_ping` response from a LIVE daemon — an
- * HTTP 200. A bare connect isn't enough: after Docker Desktop quits, a lingering
- * helper can keep the socket connectable while the daemon is down, so we require
- * the daemon to actually answer the API. Pure + tested.
- */
-export declare function isDockerPingResponse(raw: string): boolean;
-/**
- * The public check: is a Docker daemon reachable right now, without starting it?
- * platform/env/home are injectable for tests; production uses process defaults.
- */
-export declare function isDockerRunning(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv, home?: string): Promise<boolean>;

package/dist/lib/drafts.d.ts

@@ -1,11 +0,0 @@
-export interface Draft {
-    id: number;
-    examId: string | null;
-    q: number | null;
-    text: string;
-    ts: string;
-}
-export declare function addDraft(text: string, examId: string | null, q: number | null): Draft;
-export declare function listDrafts(examId?: string | null): Draft[];
-export declare function removeDraft(id: number): boolean;
-export declare function clearDrafts(): number;

package/dist/lib/editor-spawn.d.ts

@@ -1,28 +0,0 @@
-/**
- * editor-spawn — hand the terminal to the user's $EDITOR for one text
- * fragment, then take it back. The `git commit` / `crontab -e` idiom: write a
- * temp file, block on the editor, read the file back.
- *
- * BUG-008 note: this must NOT create any readline. `spawnSync` blocks the
- * event loop, so the main REPL's readline cannot fire while the editor owns
- * the TTY; we only save/drop/restore raw mode around the child (editors expect
- * a cooked terminal and manage their own termios).
- */
-export interface EditorCommand {
-    cmd: string;
-    args: string[];
-}
-/** Full argv for the editor child: the user's own args, then the vim
- *  compat fix when applicable, then the file. Pure given `probe`. */
-export declare function buildEditorArgv(ed: EditorCommand, file: string, probe?: (cmd: string) => boolean): string[];
-/** $VISUAL → $EDITOR → vi (notepad on native Windows). vi is the POSIX
- *  floor — present on every baseline terminal, and what the coretools track
- *  teaches — whereas nano isn't guaranteed installed. Values like "code -w"
- *  split on whitespace into cmd + args. Pure for testability. */
-export declare function resolveEditor(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): EditorCommand;
-/**
- * Open `initial` in the user's editor; return the edited text, or null if the
- * editor failed to launch or exited non-zero (a deliberate cancel, vi `:cq`).
- * Caller is expected to `rl.pause()` before and `rl.resume()` after.
- */
-export declare function editTextInEditor(initial: string, suffix?: string): string | null;

package/dist/lib/exam-client.d.ts

@@ -1,15 +0,0 @@
-import type { ExamListItem, ExamQuestion, ExamSession, ExamResult } from '../types/index.js';
-export declare class ExamClient {
-    private baseUrl;
-    private token;
-    constructor(baseUrl: string, token: string);
-    private request;
-    private _fetch;
-    getExams(): Promise<ExamListItem[]>;
-    startExam(examId: string): Promise<{
-        session: ExamSession;
-        questions: ExamQuestion[];
-    }>;
-    submitExam(examId: string, answers: Record<number, string>): Promise<ExamResult>;
-    getResult(examId: string): Promise<ExamResult>;
-}

package/dist/lib/exam-sandbox.d.ts

@@ -1,15 +0,0 @@
-export declare function scanForAIBinaries(): string[];
-export declare function checkShellRisk(input: string): string[];
-export declare function auditIdentity(): {
-    account?: string;
-    examToken?: string;
-    deviceFingerprint?: string;
-};
-export declare function logShellAudit(entry: {
-    cwd: string;
-    input: string;
-    riskFlags: string[];
-}): void;
-export declare function reportAIBinaryDetection(binaries: string[]): void;
-export declare function createExamWorkspace(examId: string): string;
-export declare function getActiveCwd(): string;

package/dist/lib/exam-setup.d.ts

@@ -1,19 +0,0 @@
-interface ExamSetupState {
-    completedAt: string;
-    pythonVersion: string;
-    installedPackages: string[];
-    failedPackages: string[];
-}
-export declare function getExamSetup(): ExamSetupState | null;
-export declare function saveExamSetup(state: ExamSetupState): void;
-export declare function isExamSetupComplete(): boolean;
-/**
- * Papers that are MCQ / short-answer only (no Python, no Unix tooling, no
- * practical/CTF questions) skip the `exam setup` gate entirely — running it
- * would be pointless and could block a valid token.
- *
- *  - Paper C:        exam_id ends in `-c`  (e.g. `zz-2026-c`)
- *  - SIMOC / Paper M: exam_id starts `simoc-` (e.g. `simoc-2026-g6`)
- */
-export declare function examIdSkipsSetupGate(examId: string): boolean;
-export {};

package/dist/lib/exam-state.d.ts

@@ -1,42 +0,0 @@
-import type { ExamState } from '../types/index.js';
-/**
- * Write a practical question's attachedData blob to the contestant's
- * workspace so they can use shell / python / editor tooling on it without
- * pasting the whole base64 back in on the command line.
- *
- * Because `!shell` / `!python3` inside the REPL runs in the sandbox
- * container (which only mounts its own challenges volume, not the host's
- * workspace), we also mirror the file into the sandbox at
- * /home/competitor/challenges/q<n>.txt via `docker cp` when the sandbox
- * is running. Returns the path students should reference —
- * sandbox-visible when the sandbox is up, else host — so the
- * "Ways to solve" block points at a file that actually exists wherever
- * `!command` executes.
- *
- * Silent on failure: null means no workspace file was materialized, and
- * callers skip the solve-paths guidance.
- */
-/**
- * Map a practical question's TYPE to the AI chat command a contestant should
- * enter for it. The practical section is interleaved (standard paper:
- * Q38 ctf4ai, Q39 ai4ctf, Q40 ctf4ai; Paper E: Q37-46 ai4ctf, Q47-48 ctf4ai),
- * so routing by question NUMBER misroutes questions to the wrong engine — the
- * root cause behind both the old printSectionIntro bug and the practical
- * answer-nudge in repl.ts. Always route by type.
- *
- * Returns null for MCQ / short-answer / unknown types, and (when not a real
- * exam, i.e. the demo) since the demo has no live AI chat sections.
- */
-export declare function practicalChatCommand(qType: string | undefined, isReal: boolean): 'ai4ctf' | 'ctf4ai' | 'ctf4eai' | null;
-export declare function materializeAttachedData(qNum: number, data: string | undefined): string | null;
-export declare function getRealExamState(): ExamState | null;
-export declare function getDemoState(): ExamState | null;
-export declare function getExamState(): ExamState | null;
-export declare function saveExamState(state: ExamState): void;
-export declare function clearExamState(examId?: string): void;
-export declare function getExamDeadline(): Date | null;
-/** Deadline read from the real-exam state file specifically, bypassing
- *  getExamState()'s real-over-demo priority. Used by `exam demo` to
- *  detect a parked expired real exam that would otherwise block demo. */
-export declare function getRealExamDeadline(): Date | null;
-export declare function refetchQuestionDataIfStale(): Promise<ExamState | null>;

package/dist/lib/gemini.d.ts

@@ -1,16 +0,0 @@
-import type { ChallengeContext } from '../types/index.js';
-/**
- * @deprecated Runtime translation is disabled. Translations are pre-baked
- * at build time via `panda/translate-*.js` scripts and shipped in
- * `translations/<lang>/` — CLI never translates at runtime.
- */
-export declare function translateText(_text: string, _targetLang: string): Promise<string>;
-export declare function setApiKey(key: string): void;
-export declare function createChatSession(context?: ChallengeContext, customSystemPrompt?: string): Promise<{
-    sendMessage: (msg: string) => Promise<{
-        text: string;
-        tokensUsed: number;
-        accountSpent?: number;
-        accountCap?: number;
-    }>;
-}>;

package/dist/lib/gpu.d.ts

@@ -1,51 +0,0 @@
-/**
- * gpu — pure core of the M2 GPU-lease client (Kaggle practice arena).
- *
- * The control plane is server-authoritative (design §5): the CLI POSTs
- * lease/status/release and renders what it gets back; quota, max-1 and
- * timeout-kill all live server-side (panda/kaggle/gpu_api.py). This module is
- * the pure part — response parsing, connect-field validation, ssh arg
- * building — so the trust boundary is unit-tested: a lease response can NEVER
- * smuggle shell into the ssh command (every field is format-whitelisted and
- * the remote command string is built by buildRemoteBridgeCommand's quoting).
- *
- * Transports: 'ssh' (real GPU box) and 'local' (dev loop — spawns the bridge
- * under a local shell; the command layer only honours it when the student
- * explicitly pointed ICOA_GPU_SERVER at a dev broker, so a hostile prod
- * response cannot make the CLI spawn local processes).
- */
-export interface GpuLease {
-    state: 'ready' | 'queued' | 'none' | 'error';
-    transport?: 'ssh' | 'local';
-    host?: string;
-    port?: number;
-    user?: string;
-    /** Remote venv python that runs the kernel bridge. */
-    python?: string;
-    /** Fixed dataset mount root on the box (design §4: /data/kaggle). */
-    dataRoot?: string;
-    /** Per-session workspace on the box (submission.csv lands here). */
-    outDir?: string;
-    /** SSH private key for this lease (PEM, from the broker). */
-    keyPem?: string;
-    timeLeftSec?: number;
-    queuePosition?: number;
-    estimatedWaitSec?: number;
-    message?: string;
-}
-/** Parse a broker response ({success,data:{...}} or bare) into a GpuLease. */
-export declare function parseLeaseResponse(resp: unknown): GpuLease;
-/**
- * Trust boundary: a ready lease's connect fields must be plainly-shaped
- * before they go anywhere near a spawn. Returns the list of problems
- * (empty = safe to connect).
- */
-export declare function leaseConnectProblems(l: GpuLease): string[];
-/**
- * ssh argv for a validated lease (spawn-array — no local shell ever parses
- * any of this). `remoteCommand` is the single bridge command from
- * buildRemoteBridgeCommand; `keyPath` is where the caller wrote keyPem (0600).
- */
-export declare function buildSshArgs(l: GpuLease, keyPath: string, remoteCommand: string): string[];
-/** `⏳ GPU queue: #3 · ~6 min` — the student-facing queue line (design §5). */
-export declare function queueLine(l: GpuLease): string;

package/dist/lib/http.d.ts

@@ -1,35 +0,0 @@
-export interface HttpOptions extends RequestInit {
-    /** Abort after this long. Default 15s — long enough for a slow exam upload,
-     *  short enough that a student notices something is wrong. */
-    timeoutMs?: number;
-    /** Extra attempts after the first. Default 2 for GET/HEAD, 0 otherwise. */
-    retries?: number;
-    /** Declare a non-GET request safe to replay (pure reads, pings, idempotent
-     *  upserts keyed by the caller). Without this, writes are sent exactly once. */
-    idempotent?: boolean;
-}
-interface Deps {
-    fetch: typeof globalThis.fetch;
-    sleep: (ms: number) => Promise<void>;
-}
-export declare function isOwnTimeout(err: unknown): boolean;
-/**
- * 429 = the server explicitly refused to process this request, so replaying is
- * safe by definition. 502/503/504 come from a proxy that could not reach the
- * origin or get an answer from it, so the request most likely never applied.
- *
- * 500 is deliberately absent: it means the origin DID receive the request and
- * blew up somewhere unknown — possibly after committing. Retrying a 500 is the
- * classic way to double-charge, double-submit, or double-score.
- */
-export declare function isRetryableStatus(status: number): boolean;
-/**
- * How long to wait before attempt N+1 (0-indexed). A `Retry-After` header wins
- * outright — the server knows its own recovery window better than we do.
- * Otherwise exponential backoff with ±30% jitter so a roomful of clients that
- * all failed on the same server blip does not come back in lockstep.
- */
-export declare function retryDelayMs(attempt: number, response?: Response): number;
-export declare function isCheapTransportFailure(err: unknown): boolean;
-export declare function httpFetch(url: string, opts?: HttpOptions, deps?: Deps): Promise<Response>;
-export {};