icoa-cli 2.19.458 → 2.19.460

package/dist/commands/arena-eai.d.ts

@@ -1,37 +0,0 @@
-/** Accept the forms a first-time user instinctively types: `eai-p1`, `p1`,
- *  `eai-01`, `01`, `1`. Practice = `p<n>`; official = zero-padded `eai-NN`. */
-export declare function normalizeTaskId(arg: string): string;
-/** The published `protocol` of a policy task — the shape its `query`/`submit`
- *  payloads must take. The placeholder arrays/objects (`q:["f0","f1",…]`,
- *  `a:["d0",…]` or `a:{x:["lo","hi"],y:["lo","hi"]}`) drive BOTH the shorthand
- *  parser and the on-screen usage hints, so every policy shape works — not just
- *  the 2-feature region game. */
-export interface PolicyProtocol {
-    query?: {
-        q?: unknown;
-    };
-    submit?: {
-        a?: unknown;
-    };
-}
-/** Build the JSON `instruction` a POLICY task expects from a friendly shorthand,
- *  driven by the task's published `protocol` so EVERY policy shape works:
- *    region  q:[x,y]      a:{x:[lo,hi],y:[lo,hi]}   eai-20/22/30/p4/p5
- *    patch   q:[f0…f3]    a:[d0…d3]                 eai-15/16/17/18/31
- *    ranking q:[itemA,…]  a:[ranked,items,"…"]      eai-21/23/33
- *  `op` is 'query' (recon) or 'submit' (claim). Forms accepted:
- *    probe 0.8 0.3 0.1 0.4        → {"op":"query","q":[0.8,0.3,0.1,0.4]}  (len from protocol)
- *    submit -0.6 0 0.5 0.1        → {"op":"submit","a":[-0.6,0,0.5,0.1]}  (patch) — OR a:{x,y} (region)
- *    <raw JSON>                   → passed through, op backfilled (always available)
- *  Without a protocol (legacy callers / unit tests) it preserves the original
- *  region behavior: query = first 2 numbers, submit = 4 numbers → rectangle.
- *  Returns the JSON string, or null if the shorthand can't be parsed. */
-export declare function buildPolicyInstruction(op: 'query' | 'submit', rest: string, protocol?: PolicyProtocol): string | null;
-export declare function taskDir(task: string): string;
-/** A per-task self_check.py that DELEGATES to a parent-dir self_check (a server
- *  packaging mistake — `runpy.run_path(dirname(dirname(__file__))/self_check.py)`)
- *  cannot run standalone on the client: that parent file is never downloaded. If
- *  we spawn it anyway Python dumps a `FileNotFoundError: .../self_check.py` at the
- *  player (reads as "no self_check.py"). Detect it so `roll` degrades cleanly. */
-export declare function selfCheckRunnable(src: string): boolean;
-export declare function runArenaEai(taskArg?: string): Promise<void>;

package/dist/commands/arena.d.ts

@@ -1,8 +0,0 @@
-import type { Command } from 'commander';
-/** Resolve the (track, task) pair from up to two positional args. */
-export declare function resolveTrackAndTask(arg1?: string, arg2?: string): {
-    track: string;
-    task?: string;
-};
-export declare function runArena(track: string, taskId?: string): Promise<void>;
-export declare function registerArenaCommand(program: Command): void;

package/dist/commands/board.d.ts

@@ -1,2 +0,0 @@
-import type { Command } from 'commander';
-export declare function registerBoardCommand(program: Command): void;

package/dist/commands/challenge.d.ts

@@ -1,9 +0,0 @@
-import type { Command } from 'commander';
-interface ApiEnvelope {
-    success?: boolean;
-    data?: Record<string, unknown>;
-}
-export declare function computeStart(id: string, replace: boolean): Promise<ApiEnvelope | null>;
-export declare function renderStart(id: string, resp: ApiEnvelope | null): void;
-export declare function registerChallengeCommand(program: Command): void;
-export {};

package/dist/commands/comms.d.ts

@@ -1,2 +0,0 @@
-export declare function enterMemoScreen(): Promise<void>;
-export declare function enterJuryScreen(): Promise<void>;

package/dist/commands/connect.d.ts

@@ -1,15 +0,0 @@
-import { Command } from 'commander';
-export declare function registerConnectCommand(program: Command): void;
-export declare function printHttpTargetGuide(id: string, url: string, challenge: {
-    name?: string;
-    category?: string;
-}): void;
-export declare function parseTargetContract(base: string, meta: Record<string, unknown>): {
-    endpoint: string;
-    field: string;
-} | null;
-export declare function eaiArenaTask(challenge: {
-    name?: string;
-    category?: string;
-}): string | null;
-export declare function printEaiArenaGuide(id: string, task: string): void;

package/dist/commands/ctf.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function detectFlagFormat(desc: string | undefined): string | null;
-export declare function registerCtfCommands(program: Command): void;

package/dist/commands/ctf4ai-demo.d.ts

@@ -1,4 +0,0 @@
-import { Command } from 'commander';
-export declare function isCtf4aiActive(): boolean;
-export declare function handleCtf4aiMessage(input: string): Promise<'continue' | 'exit' | 'solved'>;
-export declare function registerCtf4aiDemoCommand(program: Command): void;

package/dist/commands/ctf4vla.d.ts

@@ -1,34 +0,0 @@
-/**
- * ctf4eai — Embodied AI security challenge (Paper D, Q41-Q45).
- *
- * NOTE: public command + all user-facing copy say `ctf4eai` / "Embodied AI"
- * since 2026-06-06. The file, internal identifiers (isCtf4VlaActive, etc.) and
- * the `ctf4vla` command alias keep the old name for back-compat — renaming
- * internals is churn with no user benefit. q.type === 'vla' is server data.
- *
- * Like ai4ctf and ctf4ai, this is a sub-REPL inside the exam REPL: student
- * enters to interrogate a Vision-Language-Action target with text
- * instructions and (later) image uploads. The model returns an action
- * description; flag is revealed when the action matches the win condition.
- *
- * Naming sits in the ai4ctf / ctf4ai / ctf4vla series — "ctf4X = attack X".
- * Renamed from `vla4ctf` 2026-05-22 to fix the pattern; never typed by
- * students directly (entered via exam q 41-45 routing), so the rename is
- * a zero-impact rebrand.
- *
- * Phase 0 backend: mock (server returns deterministic responses based on
- *   instruction heuristics).
- * Phase 2 backend: real ICOA-VLA inference.
- *
- * Commands inside ctf4vla chat:
- *   probe "<instruction>"   send a custom instruction to the VLA
- *   image <path>            upload a modified image (for adversarial-patch Qs)
- *   baseline                show the default-instruction action
- *   submit ICOA{...}        submit flag for the question
- *   exit / back             return to exam REPL
- */
-import { Command } from 'commander';
-export declare function isCtf4VlaActive(): boolean;
-export declare function enterCtf4Vla(qNum: number): boolean;
-export declare function handleCtf4VlaMessage(input: string): Promise<'continue' | 'exit'>;
-export declare function registerCtf4VlaCommand(program: Command): void;

package/dist/commands/demo2.d.ts

@@ -1,31 +0,0 @@
-/**
- * demo2 — Embodied AI Security entry-level walkthrough.
- *
- * Free, no-token, ~5-minute interactive intro. Three-act structure:
- *   Act 1: eight cards that nudge the student toward discovery
- *           (embodied AI / MuJoCo / Franka Panda / generalization gap /
- *            VLA intro / VLA-vs-LLM / "is VLA right?" open / attack surface)
- *   Act 2: two story cards (ICOA's ImageNet-moment bet + three-tier curriculum)
- *   Act 3: live MuJoCo render of real ICOA-VLA on ICOA servers — the
- *           "you didn't install anything but ran a research VLA" reveal
- *
- * MCQs are unscored toward gating. Open-ended cards accept any non-empty
- * text — they exist to seed reflection, not to test.
- * No state file. No server tokens. No audit log.
- */
-import { Command } from 'commander';
-/** 'menu' = jump to the boot menu · 'abort' = leave demo2 only · null = not a leave verb. */
-export type LeaveIntent = 'menu' | 'abort' | null;
-/**
- * Classify a leave verb. The four words used to mean the same thing (relaunch
- * the whole CLI), which contradicted both CLAUDE.md "Command Keyword & 防呆
- * Design" §4 — quit/exit unwind exactly ONE level, `menu` is the ONLY
- * jump-to-root verb — and repl.ts (~line 859), which documents demo2 as
- * running IN-PROCESS and returning to `icoa>`.
- */
-export declare function classifyLeaveWord(input: string): LeaveIntent;
-/** True while demo2 is owning input — main REPL's prompt wrapper checks this
- *  to avoid overwriting demo2's setPrompt() back to "icoa> ". */
-export declare function isDemo2Active(): boolean;
-export declare function runDemo2(): Promise<void>;
-export declare function registerDemo2Command(program: Command): void;

package/dist/commands/demo4.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from 'commander';
-export declare function runDemo4(lang?: string): Promise<void>;
-export declare function registerDemo4Command(program: Command): void;

package/dist/commands/demo5.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from 'commander';
-export declare function runDemo5(lang?: string): Promise<void>;
-export declare function registerDemo5Command(program: Command): void;

package/dist/commands/doctor.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerDoctorCommand(program: Command): void;

package/dist/commands/env.d.ts

@@ -1,5 +0,0 @@
-import { Command } from 'commander';
-export declare function probeEnv(): NodeJS.ProcessEnv;
-export declare function ensureLocalBinOnPath(): string[];
-export declare function resetPyBin(): void;
-export declare function registerEnvCommand(program: Command): void;

package/dist/commands/exam.d.ts

@@ -1,13 +0,0 @@
-import { Command } from 'commander';
-export declare function presentOptions(q: any): Array<'A' | 'B' | 'C' | 'D' | 'E'>;
-export declare function optionText(key: string, q: any): string;
-export declare function isShortAnswerQ(q: any): boolean;
-export declare function describeComposition(questions: any[], total: number): string;
-export declare function isPracticalQ(q: any): boolean;
-export declare function extractExamStart(json: any): {
-    session: any;
-    questions: any[];
-    languages: any;
-} | null;
-export declare function isValidEliminate(toRemove: unknown, q: any, eliminated: string[]): boolean;
-export declare function registerExamCommand(program: Command): void;

package/dist/commands/files.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerFilesCommand(program: Command): void;

package/dist/commands/ioailab.d.ts

@@ -1 +0,0 @@
-export declare function runIoailabStandalone(): Promise<void>;

package/dist/commands/ipynb.d.ts

@@ -1,20 +0,0 @@
-/**
- * `icoa ipynb [file]` — an in-terminal Python notebook (Phase 1 UI of the CLI
- * notebook arena, see `project_cli_notebook_arena_plan`). The free, ungraded
- * engine — "a free Colab in your terminal" — and the cell surface the scored
- * `arena` will later wrap.
- *
- * Cell-stepper: the session is a real document. Typed blocks append as cells;
- * `cells / show / edit / add / del / run / save` step through them, `edit N`
- * hands the terminal to $EDITOR (default vi) for that one cell, `save` writes a
- * Jupyter-openable .ipynb. Opening a `.py` splits it on `# %%` markers (the
- * arena starter ships with them). Markdown cells are first-class: `add md`
- * writes one, `md N`/`py N` convert, and `run`/`show` render them in-terminal
- * via md-term (Jupyter semantics — running a markdown cell = rendering it).
- *
- * Runs against the aienv venv kernel via NotebookKernel (Node ↔ Python bridge).
- * Lives in the main REPL using the BUG-008 listener-swap (no second readline).
- */
-import type { Command } from 'commander';
-export declare function registerIpynbCommand(program: Command): void;
-export declare function runIpynb(file?: string): Promise<void>;

package/dist/commands/kaggle.d.ts

@@ -1,12 +0,0 @@
-import type { Command } from 'commander';
-export declare function runKaggle(compArg?: string): Promise<void>;
-/** `guide` at the REPL level (also `kaggle guide [comp]`) — reprint the
- * competition walkthrough for the downloaded comp. Layer 2 of the two-layer
- * guide: `icoa> guide` = competition loop · `icoa ipynb> guide` = notebook. */
-export declare function runKaggleGuide(compArg?: string): Promise<void>;
-export declare function runKaggleCheck(compArg?: string): Promise<void>;
-/** `icoa kaggle submit [comp]` — M2.5: ICOA-judged comps only. Validates
- * locally first (fail fast), then the server scores submission.csv against the
- * secret test labels and the result lands on the live board. */
-export declare function runKaggleSubmit(compArg?: string): Promise<void>;
-export declare function registerKaggleCommand(program: Command): void;

package/dist/commands/lang.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerLangCommand(program: Command): void;

package/dist/commands/learn.d.ts

@@ -1,16 +0,0 @@
-/**
- * `icoa learn <token>` — learn-mode REPL.
- *
- * Phase 0 scope:
- *   · LEARNDEMO01 only (10-card free demo, local data)
- *   · State persisted to ~/.icoa/learn-state.json
- *   · No server sync, no real VLA backend, no MuJoCo
- *
- * Phase 1+ adds:
- *   · EAxxxxxxxx tokens (load curriculum from server)
- *   · Cross-device progress sync
- *   · Real ICOA-VLA backend for sim_demo cards
- *   · MuJoCo viewer launch
- */
-import { Command } from 'commander';
-export declare function registerLearnCommand(program: Command): void;

package/dist/commands/log.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerLogCommand(program: Command): void;

package/dist/commands/note.d.ts

@@ -1,25 +0,0 @@
-import { Command } from 'commander';
-/**
- * `note` (verb) + `logbook` (noun) — context-aware contestant solve log.
- *
- * Inside an active exam (real-exam token present, not demo):
- *   note text...        → adds entry to your contestant logbook, auto-tagged with current question
- *   note q5 text...     → tag explicitly to Q5
- *   note 5 text...      → same
- *   logbook             → view your full logbook
- *   logbook 5           → filter to Q5
- *   notes               → alias for `logbook`
- *
- * Outside exam:
- *   note text...        → append timestamped entry to ~/icoa-notes.txt
- *
- * Naming: `note` is the verb (adding a single entry); `logbook` is the noun
- * (the cumulative submission-bound record). Both terms coexist on purpose —
- * one is action-oriented, the other is artefact-oriented.
- *
- * v2.19.189 / v2.19.190: ICO 2026 rulebook §11.2 requires "documentation of
- * methodology"; we capture it natively in the CLI so it submits with answers
- * and lands in `exam_sessions.notes` server-side. v2.19.190 added the
- * `logbook` alias and reworded UX copy.
- */
-export declare function registerNoteCommand(program: Command): void;

package/dist/commands/ref.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerRefCommand(program: Command): void;

package/dist/commands/setup.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerSetupCommand(program: Command): void;

package/dist/commands/shell.d.ts

@@ -1,35 +0,0 @@
-import { Command } from 'commander';
-/**
- * Decide which shell to launch. The Docker sandbox is the PREFERRED path (extra
- * isolation), but it is OPTIONAL: the 110 CTF tools are installed on the HOST by
- * `env setup`, and the `env` doctor explicitly marks docker "optional — not
- * needed". So when Docker is absent we must NOT dead-end the user with an
- * "install Docker" wall — we drop them into a host shell where every tool they
- * need already lives. Pure + testable so the no-docker → host fallback is locked
- * by a regression test.
- */
-export declare function resolveShellLaunch(opts: {
-    dockerAvailable: boolean;
-    platform: NodeJS.Platform;
-    shellEnv?: string;
-    comspecEnv?: string;
-}): {
-    mode: 'docker' | 'host';
-    command: string;
-};
-export { SANDBOX_IMAGES, resolveSandboxImage } from '../lib/sandbox.js';
-/**
- * docker-run args as an ARRAY (spawnSync — no shell, so a cwd with spaces
- * survives untouched). The two mounts are the aienv × docker interlock:
- *  - cwd → /work: challenge files flow both ways instead of being invisible
- *    from inside the container (and work done in /work outlives --rm).
- *  - icoa-aienv named volume → /root/.icoa: docker's copy-up seeds it from the
- *    image-baked venv on first use, then in-container pip installs survive
- *    --rm across sessions. Reset anytime: `docker volume rm icoa-aienv`.
- */
-export declare function buildSandboxRunArgs(opts: {
-    cwd: string;
-    image: string;
-    containerName: string;
-}): string[];
-export declare function registerShellCommand(program: Command): void;

package/dist/commands/sim.d.ts

@@ -1,32 +0,0 @@
-/**
- * `icoa sim` family — quick-experience entry to the embodied AI track.
- *
- *   icoa sim                  → pre-baked group dance (no network, no cooldown)
- *   icoa sim ensemble         → alias for the above (group dance)
- *   icoa sim arm              → INTERACTIVE companion-arm joint-test mode:
- *                                user types 6 joint amplitudes (or picks a
- *                                preset), server renders, video opens, repeat.
- *                                Each render uses the 15s countdown + 60s cooldown.
- *   icoa sim baseline | release | patch | confused
- *                              → original attack-vector demos (server-rendered)
- *
- * The competition itself is `ctf4vla` (combined attack/defense). The `sim`
- * family is the on-ramp: zero-friction wow + a single interactive loop so
- * contestants understand "joint vector in → motion out" before they touch
- * the real thing.
- */
-import { Command } from 'commander';
-declare const SCENARIOS: Record<string, {
-    action: Record<string, unknown> | null;
-    label: string;
-    hint: string;
-    hidden?: boolean;
-    frames?: number;
-    narrative?: boolean;
-    bundled?: string;
-    panda2_pose?: number[];
-}>;
-export declare function registerSimCommand(program: Command): void;
-export { SCENARIOS };
-/** Render one scenario, tail-free. Entry point for the hidden card decks. */
-export declare function runSimQuiet(scenarioName: string): Promise<void>;

package/dist/commands/sprint.d.ts

@@ -1,7 +0,0 @@
-import type { Command } from 'commander';
-export declare function isSprintActive(): boolean;
-/**
- * Entry point. Hidden keyword → manifesto (first time) → CTF-style list loop.
- */
-export declare function runSprint(): Promise<void>;
-export declare function registerSprintCommand(program: Command): void;

package/dist/commands/teleload.d.ts

@@ -1,8 +0,0 @@
-import type { Command } from 'commander';
-/**
- * Entry point. `teleload` lists; `teleload <n>` pulls.
- * Accepts the number bare, with a `#`, or the pack id itself — a student who
- * types what they see on screen should always land somewhere sensible.
- */
-export declare function runTeleload(arg?: string): Promise<void>;
-export declare function registerTeleloadCommand(program: Command): void;

package/dist/commands/theme.d.ts

@@ -1,13 +0,0 @@
-/**
- * `theme` command — toggle terminal color scheme.
- *
- * Two variants:
- *  - `dark` (default): Darcula — #2B2B2B bg + #A9B7C6 fg, easy on the eyes.
- *  - `high-contrast`: pure black bg + pure white fg for low-vision users,
- *    projectors, and cheap LCDs where Darcula's grays disappear.
- *
- * Change applies on next `icoa` launch (the current session keeps its paint
- * to avoid flicker while students are mid-question).
- */
-import { Command } from 'commander';
-export declare function registerThemeCommand(program: Command): void;

package/dist/commands/view.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerViewCommand(program: Command): void;

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/lib/access.d.ts

@@ -1,14 +0,0 @@
-export declare function isFirstRunOrUpgrade(currentVersion: string): boolean;
-export declare function markVersionSeen(version: string): void;
-export declare function isActivated(): boolean;
-export declare function getDeviceFingerprint(): string;
-type ActivateResult = 'ok' | 'invalid' | 'already_bound';
-export declare function activateToken(token: string): ActivateResult;
-export declare function isDeviceMatch(): boolean;
-export declare function isFreeCommand(cmd: string): boolean;
-export declare function recordExit(): void;
-export declare function recordResume(): {
-    awaySeconds: number;
-    exitCount: number;
-} | null;
-export {};

package/dist/lib/aienv.d.ts

@@ -1,118 +0,0 @@
-/**
- * aienv — the AI/ML notebook-arena environment (Phase 0 of the CLI notebook
- * arena, see `project_cli_notebook_arena_plan`).
- *
- * This is the PURE, testable core. The orchestration (venv creation, pip
- * installs, status rendering) lives in `src/commands/aienv.ts`.
- *
- * Hard rule (BUG3 / Team Indonesia): aienv provisions its OWN venv under
- * ~/.icoa/aienv and NEVER repoints the system python3. It also stays fully
- * independent of `env.ts` so the heavy ML stack (jupyter/numpy/torch...) can
- * never drag down the lightweight exam-only `env setup` path, and so a broken
- * ML install is fault-isolated from the competition toolkit.
- */
-export type AiGroup = 'core' | 'data' | 'deep' | 'physics';
-export interface AiPkg {
-    /** Display name + the name `pip show` uses. */
-    name: string;
-    /** Module name for the `import x` readiness probe. */
-    import: string;
-    /** pip install spec (floor-pinned — see note below). */
-    spec: string;
-    group: AiGroup;
-    note?: string;
-    /**
-     * Optional override for the readiness-probe statement. For packages whose
-     * bare `import x` can succeed while the part you actually use is broken — most
-     * notably Pillow, where `import PIL` passes even if the `_imaging` C extension
-     * is unusable (the env.ts ABI-shadow lesson, reference_pil_imaging_abi_mismatch)
-     * — give the real usable import here (e.g. `from PIL import Image`) so the probe
-     * exercises the C extension and cannot false-positive a broken install.
-     */
-    probe?: string;
-}
-export interface PyVersion {
-    major: number;
-    minor: number;
-}
-export interface AienvPaths {
-    /** The venv root: <home>/.icoa/aienv */
-    root: string;
-    /** Directory holding the venv executables (bin on posix, Scripts on win). */
-    binDir: string;
-    /** Absolute path to the venv's python interpreter. */
-    python: string;
-    /** Absolute path to the venv's pip. */
-    pip: string;
-    /** Manifest written after a successful setup — records python version + groups. */
-    marker: string;
-}
-export declare const REQUIRED_PY: PyVersion;
-export declare const AIENV_MARKER_VERSION = 2;
-/**
- * ML stack for the notebook arena.
- *
- * Versions are FLOOR-pinned (`>=`), not exact-pinned like the CTF toolkit in
- * env.ts. The scientific/ML stack ships platform- and arch-specific wheels that
- * churn fast; exact pins across macOS/Linux/WSL × x64/arm64 routinely fail wheel
- * resolution. Phase 0 only provisions — fairness-critical determinism lives
- * server-side on the (fixed-model) GPU box, not in the student's local venv.
- *
- *  - core: the Jupyter kernel-protocol foundation Phase 1's cell loop talks to.
- *  - data: the everyday data-science stack students compute with on CPU.
- *  - deep: multi-GB DL stack — OPT-IN via `aienv setup --deep` only. Under the
- *    fixed-model GPU design, most students call the server's inference API and
- *    never need torch locally, so it must not be in the default footprint.
- */
-export declare const AIENV_PACKAGES: AiPkg[];
-export declare function packagesForGroups(groups: AiGroup[]): AiPkg[];
-/** Compute the venv paths for a given home directory + platform. */
-export declare function aienvPaths(home: string, plat?: NodeJS.Platform): AienvPaths;
-/**
- * Absolute path to the icoa-provisioned standalone CPython 3.12. `env setup`
- * installs a relocatable python-build-standalone build here ONLY on Linux
- * distros where neither apt nor the Ubuntu deadsnakes PPA can deliver 3.12
- * (e.g. Kali / non-Ubuntu Debian). Side-by-side: the system python3 is never
- * touched. On the four already-supported platforms this path simply never
- * exists, so probing it is a no-op.
- */
-export declare function icoaStandalonePython(home: string, plat?: NodeJS.Platform): string;
-/**
- * Ordered host-python candidates to build the venv from. We probe a versioned
- * 3.12 BEFORE the bare `python3` so we don't accidentally seed the venv with a
- * distro 3.10 when a 3.12 is present. We never touch the system python3 beyond
- * reading its --version.
- *
- * When `home` is given, the icoa-provisioned standalone 3.12 (Kali / non-Ubuntu
- * Debian — see icoaStandalonePython) is probed right after the on-PATH
- * `python3.12` and before the distro `python3`. Omitting `home` (the default,
- * and what the unit tests use) leaves the candidate list byte-identical to
- * before, so the four working platforms are unaffected.
- */
-export declare function hostPythonCandidates(plat?: NodeJS.Platform, home?: string): string[];
-/** Parse `Python 3.12.13` → {major:3, minor:12}. Tolerant of trailing newline. */
-export declare function parsePyVersion(out: string | null | undefined): PyVersion | null;
-/** True if `v` is at least `min` (major-then-minor comparison). */
-export declare function meetsMinPy(v: PyVersion, min: PyVersion): boolean;
-export interface HostPython {
-    cmd: string;
-    version: PyVersion;
-}
-/**
- * Resolve the best host python to create the venv from.
- *
- * `probe(cmd)` runs `cmd --version` and returns its stdout (or null if the
- * command is absent / errored) — injected so this stays pure + testable.
- *
- * Returns the first interpreter on the locked 3.12 line (any patch); otherwise
- * null. We deliberately do NOT fall back to 3.10 / 3.11 / 3.13 — a uniform 3.12
- * cohort is the whole point (see REQUIRED_PY). The caller surfaces an actionable
- * "install Python 3.12" message when this is null.
- */
-export declare function resolveHostPython(probe: (cmd: string) => string | null, plat?: NodeJS.Platform, home?: string): HostPython | null;
-/**
- * Build the readiness probe for one package, run via the VENV python (absolute
- * path) — never the system python3. Mirrors env.ts's `python3 -c "import x"`
- * convention but always targets the venv interpreter.
- */
-export declare function importCheckCmd(venvPython: string, pkg: AiPkg): string;

package/dist/lib/arena-edit-dynamics.d.ts

@@ -1,55 +0,0 @@
-/**
- * How a contest solution came to exist — typed, or pasted in.
- *
- * The existing input-dynamics observer watches the readline prompt, which is
- * the WRONG surface here: contest code is written inside vi, so at `/submit 3`
- * it would only report how the five characters "submit 3" were typed. The
- * signal that actually answers the question lives in the editor session —
- * how long the editor was open against how much the file grew.
- *
- * A person types on the order of 5–10 bytes/second sustained. A paste lands
- * thousands of bytes in the time it takes to release the key. That ratio is
- * the whole measurement, and it needs no keystroke content at all: this module
- * records byte counts and durations, never a single character of what was
- * written. Same discipline as input-dynamics.ts — aggregate counters only.
- *
- * Detective, never preventive: a high ratio is a reason for a human to look,
- * not a verdict, and nothing here gates a submission.
- */
-export type EditDynamics = {
-    /** How many times the editor was opened for this problem. */
-    editSessions: number;
-    /** Total milliseconds the editor was open. */
-    editMs: number;
-    /** Size of the solution file when last seen, in bytes. */
-    bytesFinal: number;
-    /** Net growth across all sessions (can be negative if they deleted). */
-    bytesAdded: number;
-    /**
-     * Fastest sustained growth seen in any single session, bytes/second.
-     * The paste fingerprint: sustained human typing sits in single digits.
-     */
-    maxBytesPerSec: number;
-    /** Self-checks (`/run`) before submitting — pasted answers often get none. */
-    runs: number;
-};
-export declare function emptyDynamics(): EditDynamics;
-/**
- * Fold one finished editor session into the accumulator.
- *
- * `ms` under a second is treated as one second for the rate, so opening and
- * closing the editor instantly cannot manufacture an infinite rate — and a
- * session that added nothing never moves the maximum.
- */
-export declare function foldEditSession(prev: EditDynamics, session: {
-    ms: number;
-    bytesBefore: number;
-    bytesAfter: number;
-}): EditDynamics;
-export declare function noteRun(prev: EditDynamics): EditDynamics;
-/**
- * Nothing observed at all — a solution that appeared without the editor ever
- * being opened (written by an external editor, or dropped in as a file). Worth
- * distinguishing from "typed fast", so the server stores the difference.
- */
-export declare function isEmpty(d: EditDynamics): boolean;

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[];