@jinn-network/client 0.1.7 → 0.1.8

package/dist/api/codex-doctor-endpoint.d.ts

@@ -1,9 +1,15 @@
 /**
  * GET /api/codex/doctor
  *
- * Runs `codex --version` via spawnSync and inspects the auth configuration so
- * the operator dashboard can show an install-required / sign-in-required panel
- * before the operator saves a Codex harness selection.
+ * Runs `codex --version` via async execFile and inspects the auth configuration
+ * so the operator dashboard can show an install-required / sign-in-required
+ * panel before the operator saves a Codex harness selection.
+ *
+ * Async (#778 follow-up): the readiness registry refreshes the learner
+ * harness's `isReady()` periodically; that path calls `probeCodexDoctor`. The
+ * original `spawnSync` blocked the daemon main event loop on every refresh,
+ * same wedge class as the Hermes endpoint (see hermes-doctor-endpoint.ts file
+ * header). Converted to `promisify(execFile)` with a 10s timeout.
  *
  * Response shape:
  *   { installed: boolean, authenticated: boolean,
@@ -40,12 +46,18 @@
 import type { Hono } from 'hono';
 /** Classification of Codex credentials. */
 export type CodexAuthStatus = 'ok' | 'expired' | 'not_configured';
+/** Classification of the installed codex CLI version against the tested range. */
+export type CodexVersionStatus = 'ok' | 'unknown' | 'untested';
 export interface CodexDoctorResponse {
     installed: boolean;
     /** Convenience alias — true iff `authStatus === 'ok'`. */
     authenticated: boolean;
     /** Live/expired/absent classification of Codex credentials. */
     authStatus: CodexAuthStatus;
+    /** Parsed semver string from `codex --version`, or null when unparseable. */
+    cliVersion: string | null;
+    /** ok = within tested range; untested = outside it; unknown = unparseable (#675). */
+    versionStatus: CodexVersionStatus;
     exitCode: number | null;
     stdout: string;
     stderr: string;
@@ -65,9 +77,14 @@ export interface CodexDoctorConfig {
     now?: number;
 }
 /**
- * Synchronously runs `codex --version` and classifies install + auth state.
+ * Asynchronously runs `codex --version` and classifies install + auth state.
  * Pure (no Hono dependency) so the harness layer can call it without pulling
  * the API server in.
+ *
+ * Async (#778 follow-up): see file header — `execFile` failures (non-zero
+ * exit OR kill-by-timeout) throw with `{stdout, stderr, code, signal}`
+ * attached; we unwrap that into the same classification surface the old
+ * sync code produced.
  */
-export declare function probeCodexDoctor(config?: CodexDoctorConfig): CodexDoctorResponse;
+export declare function probeCodexDoctor(config?: CodexDoctorConfig): Promise<CodexDoctorResponse>;
 export declare function addCodexDoctorRoutes(app: Hono, config?: CodexDoctorConfig): void;

package/dist/api/codex-doctor-endpoint.js

@@ -1,7 +1,25 @@
-import { spawnSync } from 'node:child_process';
+import { execFile } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Tested @openai/codex CLI version window (#675). Below MIN or above MAX, the
+ * harness may break — codex 0.133.0 introduced a stdin contract change that
+ * silently broke the previous positional-prompt invocation. Bumping these
+ * bounds is a deliberate compatibility statement, made with a green run of
+ * `yarn test test/harnesses/impls/learner/codex-code-adapter.test.ts` against
+ * the new CLI version.
+ *
+ * The upper bound is compared on major+minor only: patch releases within the
+ * same minor as `MAX_TESTED_CODEX_VERSION` are treated as `'ok'`, since codex
+ * patch bumps almost never break the CLI contract and warning on every patch
+ * would produce alarm fatigue. Bump `MAX_TESTED_CODEX_VERSION` when codex
+ * bumps its minor or major; patch bumps stay `'ok'` automatically.
+ */
+const MIN_TESTED_CODEX_VERSION = '0.50.0';
+const MAX_TESTED_CODEX_VERSION = '0.133.0';
 /**
  * Decodes a JWT's payload and returns its `exp` claim (epoch seconds), or
  * `undefined` when the token is absent, malformed, or carries no `exp`.
@@ -134,44 +152,145 @@ function hasApiKey(config) {
     return Boolean(env['OPENAI_API_KEY']?.trim());
 }
 /**
- * Synchronously runs `codex --version` and classifies install + auth state.
+ * Extracts the first `MAJOR.MINOR.PATCH` semver-looking triple from `codex
+ * --version` output. Returns null when no such triple is present.
+ */
+function parseCodexVersion(stdout) {
+    const match = stdout.match(/\d+\.\d+\.\d+/);
+    return match ? match[0] : null;
+}
+/**
+ * Compares two `MAJOR.MINOR.PATCH` strings segment-by-segment as integers.
+ * Returns -1 if `a < b`, 0 if equal, 1 if `a > b`. Non-numeric / missing
+ * segments fall back to 0 so a partial input never throws.
+ */
+function compareSemver(a, b) {
+    const av = a.split('.').map((s) => Number.parseInt(s, 10) || 0);
+    const bv = b.split('.').map((s) => Number.parseInt(s, 10) || 0);
+    for (let i = 0; i < 3; i++) {
+        const ai = av[i] ?? 0;
+        const bi = bv[i] ?? 0;
+        if (ai < bi)
+            return -1;
+        if (ai > bi)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Returns true when `a`'s `MAJOR.MINOR` is strictly greater than `b`'s. Patch
+ * differences within the same minor are ignored, so 0.133.5 is NOT above
+ * 0.133.0, but 0.134.0 and 1.0.0 are. Used for the upper-bound check (#675)
+ * so codex patch releases don't trip the untested-version warning.
+ */
+function isAboveMinor(a, b) {
+    const av = a.split('.').map((s) => Number.parseInt(s, 10) || 0);
+    const bv = b.split('.').map((s) => Number.parseInt(s, 10) || 0);
+    const [aMajor, aMinor] = [av[0] ?? 0, av[1] ?? 0];
+    const [bMajor, bMinor] = [bv[0] ?? 0, bv[1] ?? 0];
+    if (aMajor !== bMajor)
+        return aMajor > bMajor;
+    return aMinor > bMinor;
+}
+/**
+ * Classifies a parsed semver against the tested range.
+ *   - null → 'unknown'
+ *   - below MIN (full semver compare) → 'untested'
+ *   - above MAX on major+minor → 'untested' (patch bumps within the tested
+ *     minor stay 'ok'; bump MAX_TESTED_CODEX_VERSION on minor/major bumps)
+ *   - otherwise → 'ok'
+ */
+function classifyVersion(cliVersion) {
+    if (cliVersion === null)
+        return 'unknown';
+    if (compareSemver(cliVersion, MIN_TESTED_CODEX_VERSION) < 0
+        || isAboveMinor(cliVersion, MAX_TESTED_CODEX_VERSION)) {
+        return 'untested';
+    }
+    return 'ok';
+}
+// Module-scoped so the warning fires once per process even though
+// `probeCodexDoctor` is called every readiness tick.
+let untestedVersionWarningEmitted = false;
+/**
+ * Asynchronously runs `codex --version` and classifies install + auth state.
  * Pure (no Hono dependency) so the harness layer can call it without pulling
  * the API server in.
+ *
+ * Async (#778 follow-up): see file header — `execFile` failures (non-zero
+ * exit OR kill-by-timeout) throw with `{stdout, stderr, code, signal}`
+ * attached; we unwrap that into the same classification surface the old
+ * sync code produced.
  */
-export function probeCodexDoctor(config = {}) {
+export async function probeCodexDoctor(config = {}) {
     const codexBin = config.codexPath ?? 'codex';
-    const timeoutMs = config.codexDoctorTimeoutMs ?? 30_000;
-    const result = spawnSync(codexBin, ['--version'], {
-        timeout: timeoutMs,
-        encoding: 'utf8',
-    });
-    const errorCode = result.error?.code;
+    // Defaults to 10s here (vs 30s on the sync path) because this fires on the
+    // readiness-registry refresh tick — a hung shell-out must not snowball into
+    // an outstanding 30s timer per tick.
+    const timeoutMs = config.codexDoctorTimeoutMs ?? 10_000;
+    let status = 0;
+    let signal = null;
+    let stdout = '';
+    let stderr = '';
+    let errorCode;
+    try {
+        const ok = await execFileAsync(codexBin, ['--version'], {
+            timeout: timeoutMs,
+            encoding: 'utf8',
+        });
+        stdout = ok.stdout;
+        stderr = ok.stderr;
+    }
+    catch (err) {
+        const errno = err;
+        const codeIsString = typeof errno.code === 'string';
+        status = !codeIsString && typeof errno.code === 'number' ? errno.code : null;
+        errorCode = codeIsString ? errno.code : undefined;
+        signal = errno.signal ?? null;
+        stdout = typeof errno.stdout === 'string' ? errno.stdout : errno.stdout?.toString() ?? '';
+        stderr = typeof errno.stderr === 'string' ? errno.stderr : errno.stderr?.toString() ?? '';
+    }
     // installed=true means we found the binary on disk. ENOENT is the only
     // definitive not-installed signal. Other errors (EACCES = wrong
     // permissions; ETIMEDOUT = ran but didn't finish in time) indicate the
     // binary exists but couldn't be exercised cleanly — surface those as
     // config-issue, not missing.
     const notFound = errorCode === 'ENOENT';
-    const installed = !notFound && (result.status !== null
-        || result.signal !== null
+    const installed = !notFound && (status !== null
+        || signal !== null
         || (errorCode != null && errorCode !== 'ENOENT'));
     // Auth is only meaningful once the binary is present and runnable.
-    const runnable = installed && result.status === 0;
+    const runnable = installed && status === 0;
     const authStatus = runnable
         ? detectCodexAuthStatus(config)
         : 'not_configured';
+    // Version surfacing (#675). Parse only when we have a runnable binary;
+    // otherwise the stdout is meaningless.
+    const cliVersion = runnable ? parseCodexVersion(stdout) : null;
+    const versionStatus = runnable
+        ? classifyVersion(cliVersion)
+        : 'unknown';
+    if (versionStatus === 'untested' && !untestedVersionWarningEmitted) {
+        untestedVersionWarningEmitted = true;
+        // eslint-disable-next-line no-console
+        console.warn(`codex CLI version ${cliVersion} is outside the tested range `
+            + `${MIN_TESTED_CODEX_VERSION}–${MAX_TESTED_CODEX_VERSION}; the harness `
+            + `may break — see issue #675`);
+    }
     return {
         installed,
         authenticated: authStatus === 'ok',
         authStatus,
-        exitCode: result.status,
-        stdout: (result.stdout ?? '').slice(0, 4000),
-        stderr: (result.stderr ?? '').slice(0, 4000),
+        cliVersion,
+        versionStatus,
+        exitCode: status,
+        stdout: stdout.slice(0, 4000),
+        stderr: stderr.slice(0, 4000),
     };
 }
 export function addCodexDoctorRoutes(app, config = {}) {
-    app.get('/api/codex/doctor', (c) => {
-        return c.json(probeCodexDoctor(config));
+    app.get('/api/codex/doctor', async (c) => {
+        return c.json(await probeCodexDoctor(config));
     });
 }
 //# sourceMappingURL=codex-doctor-endpoint.js.map

package/dist/api/codex-doctor-endpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex-doctor-endpoint.js","sourceRoot":"","sources":["../../src/api/codex-doctor-endpoint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codex-doctor-endpoint.js","sourceRoot":"","sources":["../../src/api/codex-doctor-endpoint.ts"],"names":[],"mappings":"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"}

package/dist/api/debug-report-endpoint.d.ts

@@ -0,0 +1,27 @@
+/**
+ * One-click operator debug-report endpoints (issue #420 §2).
+ *
+ * `GET /v1/debug-report/manifest` — describes what the bundle will contain
+ *   (file list + redaction summary) so the SPA can show the operator before
+ *   they download. No screenshot needed.
+ *
+ * `POST /v1/debug-report` — gathers the daemon status, resolved config,
+ *   config provenance, recent activity events and rotated log files,
+ *   assembles a redacted `.tar.gz`, and streams it as an attachment. The
+ *   request body may carry a client-captured dashboard screenshot.
+ *
+ * Both routes are gated by the UI token via the `app.use('/v1/debug-report*')`
+ * block in `startApiServer`. They register eagerly (no holder needed — the
+ * Store and config are available at server-start time).
+ */
+import type { Hono } from 'hono';
+import type { Store } from '../store/store.js';
+import type { JinnConfig } from '../config.js';
+export interface DebugReportRoutesConfig {
+    store: Store;
+    /** The live resolved config object held by `main.ts`. */
+    config: JinnConfig;
+    /** Explicit config path passed to `loadConfig`, if any. */
+    configPath?: string;
+}
+export declare function addDebugReportRoutes(app: Hono, config: DebugReportRoutesConfig): void;

package/dist/api/debug-report-endpoint.js

@@ -0,0 +1,157 @@
+/**
+ * One-click operator debug-report endpoints (issue #420 §2).
+ *
+ * `GET /v1/debug-report/manifest` — describes what the bundle will contain
+ *   (file list + redaction summary) so the SPA can show the operator before
+ *   they download. No screenshot needed.
+ *
+ * `POST /v1/debug-report` — gathers the daemon status, resolved config,
+ *   config provenance, recent activity events and rotated log files,
+ *   assembles a redacted `.tar.gz`, and streams it as an attachment. The
+ *   request body may carry a client-captured dashboard screenshot.
+ *
+ * Both routes are gated by the UI token via the `app.use('/v1/debug-report*')`
+ * block in `startApiServer`. They register eagerly (no holder needed — the
+ * Store and config are available at server-start time).
+ */
+import { basename } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { buildConfigProvenance } from '../config.js';
+import { gatherStatusForApi } from './gather-status.js';
+import { buildInfo } from '../build-info.js';
+import { getFileLogger } from '../observability/file-logger.js';
+import { assembleDebugReport, DEBUG_REPORT_FILES, } from '../observability/debug-report-assemble.js';
+import { REDACTION_VERSION } from '../observability/redact-secrets.js';
+/** Number of recent lifecycle events to include in the bundle. */
+const ACTIVITY_EVENT_LIMIT = 1000;
+/** Decode a base64 dashboard screenshot from the request body. */
+function decodeScreenshot(value) {
+    if (typeof value !== 'string' || value.length === 0)
+        return undefined;
+    // Tolerate a `data:image/png;base64,` prefix even though the SPA strips it.
+    const stripped = value.replace(/^data:image\/png;base64,/, '');
+    try {
+        const buf = Buffer.from(stripped, 'base64');
+        return buf.length > 0 ? buf : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The rotated log files' on-disk paths, in bundle order. Never throws. */
+function logFilePaths() {
+    try {
+        return getFileLogger().listLogFiles();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read the rotated log files for the bundle. Best-effort — never throws.
+ * Async (`fs/promises.readFile`) so reading up to ~25 MiB of rotated logs
+ * does not block the daemon event loop on the request path.
+ */
+async function readLogFiles() {
+    const out = [];
+    for (const path of logFilePaths()) {
+        try {
+            out.push({ name: basename(path), content: await readFile(path) });
+        }
+        catch {
+            // Skip an unreadable log file rather than failing the whole bundle.
+        }
+    }
+    return out;
+}
+export function addDebugReportRoutes(app, config) {
+    // GET /v1/debug-report/manifest — describe the bundle before download.
+    app.get('/v1/debug-report/manifest', (c) => {
+        const logNames = logFilePaths().map((p) => `logs/${basename(p)}`);
+        return c.json({
+            files: [...DEBUG_REPORT_FILES, ...logNames, 'dashboard-screenshot.png'],
+            redaction: {
+                version: REDACTION_VERSION,
+                redacted: [
+                    'keystore password / JINN_PASSWORD',
+                    'private keys, mnemonics and seed phrases',
+                    'daemon API token, UI token, handshake key',
+                    'harness / provider API keys',
+                    'RPC URL credential segments',
+                ],
+                kept: [
+                    'wallet addresses (public on-chain)',
+                    'RPC hostnames and path shape (needed to reproduce network issues)',
+                    'contract and deployment addresses',
+                    'file paths',
+                ],
+                notRedacted: [
+                    'dashboard-screenshot.png — a pixel capture of the screen; text '
+                        + 'redaction does not apply, so anything visible at capture time '
+                        + 'appears in it. Review before sharing.',
+                ],
+            },
+        });
+    });
+    // POST /v1/debug-report — assemble and stream the redacted .tar.gz.
+    app.post('/v1/debug-report', async (c) => {
+        let body = {};
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            // Empty / missing body is allowed — the screenshot is optional.
+        }
+        const screenshotPng = decodeScreenshot(body['screenshotPngBase64']);
+        let status;
+        try {
+            status = await gatherStatusForApi(config.store, undefined);
+        }
+        catch (err) {
+            status = {
+                error: 'status_gather_failed',
+                message: err instanceof Error ? err.message : String(err),
+            };
+        }
+        let configProvenance;
+        try {
+            configProvenance = buildConfigProvenance(config.configPath, config.config);
+        }
+        catch (err) {
+            configProvenance = {
+                error: 'provenance_failed',
+                message: err instanceof Error ? err.message : String(err),
+            };
+        }
+        let activityEvents;
+        try {
+            activityEvents = config.store.getRecentActivityEvents(ACTIVITY_EVENT_LIMIT);
+        }
+        catch (err) {
+            activityEvents = {
+                error: 'activity_events_failed',
+                message: err instanceof Error ? err.message : String(err),
+            };
+        }
+        const generatedAt = new Date().toISOString();
+        const bundle = await assembleDebugReport({
+            status,
+            config: config.config,
+            configProvenance,
+            activityEvents,
+            logFiles: await readLogFiles(),
+            daemonVersion: buildInfo.implVersion,
+            screenshotPng,
+            generatedAt,
+        });
+        const filename = `jinn-debug-report-${generatedAt.slice(0, 10)}.tar.gz`;
+        return new Response(new Uint8Array(bundle), {
+            headers: {
+                'content-type': 'application/gzip',
+                'content-disposition': `attachment; filename="${filename}"`,
+                'content-length': String(bundle.length),
+            },
+        });
+    });
+}
+//# sourceMappingURL=debug-report-endpoint.js.map

package/dist/api/debug-report-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-report-endpoint.js","sourceRoot":"","sources":["../../src/api/debug-report-endpoint.ts"],"names":[],"mappings":"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"}

package/dist/api/gather-status.d.ts

@@ -3,7 +3,12 @@
  */
 import type { Store } from '../store/store.js';
 import type { JinnConfig } from '../config.js';
+import type { CredentialId } from '../spend/credential.js';
+import type { AiUnitsDaemonConfig } from '../spend/ai-units-config.js';
 import { type GatheredStatusRaw, type StatusV1Response } from './status-build.js';
+import type { HarnessReadinessSnapshot, JoinedHarnessSpec } from '../harnesses/readiness-registry.js';
+/** Test-only: clear the first-seen-evicted tracker. Do not call from production code. */
+export declare function __resetEvictionFirstSeenForTests(): void;
 /**
  * Drop any cached prediction operator status for `config`.
  *
@@ -30,6 +35,14 @@ export interface StatusGatherConfig {
     tjinnChainId?: number;
     /** JinnDistributor address used for real operator lifetime claimed totals. */
     tjinnDistributorAddress?: string;
+    /**
+     * stOLAS L2 distributor address (`CHAIN_CONFIG.distributorAddress`). Used
+     * solely to mirror `main.ts`'s `evictionCheck` predicate (issue #651). The
+     * tJINN distributor on L1 is a different contract — do not substitute one
+     * for the other even though they happen to bundle together in our current
+     * testnet deployment.
+     */
+    stOlasDistributorAddress?: string;
     network: 'mainnet' | 'testnet';
     pollIntervalMs: number;
     masterEthDailyEstimateWei?: string;
@@ -46,6 +59,26 @@ export interface StatusGatherConfig {
     /** Full config enables SolverNet/plugin/Harness diagnostics in /v1/status. */
     config?: JinnConfig;
     configPath?: string;
+    /** Per-credential daily caps; when present, /v1/status carries a `spend` block. */
+    spendCaps?: Record<CredentialId, number>;
+    /**
+     * AI-units gate config (issue #815). When present, /v1/status carries an
+     * `aiUnits` block keyed per credential — surfaces unitsThisBlock /
+     * unitsThisWeek vs caps + paused flag + reset instants.
+     */
+    aiUnits?: AiUnitsDaemonConfig;
+    /**
+     * Optional getter that returns the live HarnessReadinessRegistry snapshot
+     * + joinedHarnessesByCid map. Threaded by `server.ts` for the `/v1/status`
+     * handler so the response carries a `harness` rollup. Returning `null`
+     * means "registry not ready yet" — gather-status leaves `raw.harnessRollup`
+     * unset and the assembler defaults to ready. Mirrors the holder pattern
+     * already used for `harnessReadinessRegistry` in main.ts.
+     */
+    harnessReadiness?: () => {
+        snapshot: HarnessReadinessSnapshot;
+        joinedHarnessesByCid: Record<string, JoinedHarnessSpec>;
+    } | null;
 }
 /** Collect status inputs without assembling the legacy mega-response. */
 export declare function gatherGatheredStatusRaw(store: Store, status: StatusGatherConfig | undefined): Promise<GatheredStatusRaw>;