@jinn-network/client 0.1.5 → 0.1.6-canary.0b4ff7f9

package/dist/harnesses/names.js

@@ -1,5 +1,6 @@
 export const CLAUDE_CODE_HARNESS = 'claude-code';
 export const CODEX_HARNESS = 'codex';
+export const HERMES_AGENT_HARNESS = 'hermes-agent';
 const HARNESS_ALIASES = {
     'claude-code-learner': CLAUDE_CODE_HARNESS,
     'codex-code-learner': CODEX_HARNESS,
@@ -19,6 +20,8 @@ export function harnessStateDirName(name) {
         return 'claude-code-learner';
     if (canonical === CODEX_HARNESS)
         return 'codex-code-learner';
+    if (canonical === HERMES_AGENT_HARNESS)
+        return 'hermes-agent';
     return canonical;
 }
 //# sourceMappingURL=names.js.map

package/dist/harnesses/names.js.map

@@ -1 +1 @@
-{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/harnesses/names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,MAAM,eAAe,GAA2B;IAC9C,qBAAqB,EAAE,mBAAmB;IAC1C,oBAAoB,EAAE,aAAa;CACpC,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,SAAiB;IACrE,OAAO,oBAAoB,CAAC,SAAS,CAAC,KAAK,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC9D,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,SAAS,KAAK,mBAAmB;QAAE,OAAO,qBAAqB,CAAC;IACpE,IAAI,SAAS,KAAK,aAAa;QAAE,OAAO,oBAAoB,CAAC;IAC7D,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/harnesses/names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAEnD,MAAM,eAAe,GAA2B;IAC9C,qBAAqB,EAAE,mBAAmB;IAC1C,oBAAoB,EAAE,aAAa;CACpC,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,SAAiB;IACrE,OAAO,oBAAoB,CAAC,SAAS,CAAC,KAAK,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC9D,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,SAAS,KAAK,mBAAmB;QAAE,OAAO,qBAAqB,CAAC;IACpE,IAAI,SAAS,KAAK,aAAa;QAAE,OAAO,oBAAoB,CAAC;IAC7D,IAAI,SAAS,KAAK,oBAAoB;QAAE,OAAO,cAAc,CAAC;IAC9D,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/harnesses/readiness-registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * HarnessReadinessRegistry — per-harness Harness.isReady() composition for the
+ * daemon's claim loops and the SPA's per-harness setup cards.
+ *
+ * See docs/superpowers/specs/2026-05-15-per-harness-auth-design.md.
+ *
+ * Single writer: the background refresh tick. Readers (claim loops + the
+ * /v1/harnesses/readiness endpoint) read the cached snapshot lock-free.
+ * Bounded staleness = tickIntervalMs.
+ */
+import type { Harness, ReadyStatus } from './types.js';
+export interface JoinedHarnessSpec {
+    harnessName: string;
+    roles: Array<'solver' | 'evaluator'>;
+}
+export interface HarnessReadinessSnapshot {
+    lastRefreshedAt: string;
+    harnesses: Array<{
+        harnessName: string;
+        manifestCids: string[];
+        ready: boolean;
+        reason?: string;
+        nextStep?: ReadyStatus['nextStep'];
+    }>;
+}
+export interface HarnessReadinessRegistryOptions {
+    /** Harness instances indexed by Harness.name. */
+    harnessesByName: Record<string, Harness>;
+    /** joinedSolverNets shape, narrowed to harness lookup. */
+    joinedHarnessesByCid: Record<string, JoinedHarnessSpec>;
+    /** Background refresh interval (ms). Default 4000 (matches existing Claude auth poll cadence). */
+    tickIntervalMs?: number;
+    /** Per-isReady() timeout (ms). Default 5000. */
+    isReadyTimeoutMs?: number;
+}
+export declare class HarnessReadinessRegistry {
+    private readonly opts;
+    private snapshot;
+    private timer;
+    private refreshInFlight;
+    constructor(opts: HarnessReadinessRegistryOptions);
+    start(): void;
+    stop(): void;
+    getSnapshot(): HarnessReadinessSnapshot;
+    isReadyForClaim(manifestCid: string): ReadyStatus;
+    refreshNow(): Promise<void>;
+    private _doRefresh;
+}

package/dist/harnesses/readiness-registry.js

@@ -0,0 +1,136 @@
+/**
+ * HarnessReadinessRegistry — per-harness Harness.isReady() composition for the
+ * daemon's claim loops and the SPA's per-harness setup cards.
+ *
+ * See docs/superpowers/specs/2026-05-15-per-harness-auth-design.md.
+ *
+ * Single writer: the background refresh tick. Readers (claim loops + the
+ * /v1/harnesses/readiness endpoint) read the cached snapshot lock-free.
+ * Bounded staleness = tickIntervalMs.
+ */
+const DEFAULT_TICK_INTERVAL_MS = 4_000;
+const DEFAULT_IS_READY_TIMEOUT_MS = 5_000;
+export class HarnessReadinessRegistry {
+    opts;
+    snapshot = {
+        lastRefreshedAt: new Date(0).toISOString(),
+        harnesses: [],
+    };
+    timer = null;
+    refreshInFlight = false;
+    constructor(opts) {
+        this.opts = {
+            tickIntervalMs: opts.tickIntervalMs ?? DEFAULT_TICK_INTERVAL_MS,
+            isReadyTimeoutMs: opts.isReadyTimeoutMs ?? DEFAULT_IS_READY_TIMEOUT_MS,
+            harnessesByName: opts.harnessesByName,
+            joinedHarnessesByCid: opts.joinedHarnessesByCid,
+        };
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => { void this.refreshNow(); }, this.opts.tickIntervalMs);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    getSnapshot() {
+        return this.snapshot;
+    }
+    isReadyForClaim(manifestCid) {
+        const joined = this.opts.joinedHarnessesByCid[manifestCid];
+        if (!joined) {
+            return {
+                ready: false,
+                reason: `manifestCid ${manifestCid} not in joinedSolverNets`,
+            };
+        }
+        const entry = this.snapshot.harnesses.find((h) => h.harnessName === joined.harnessName);
+        if (!entry) {
+            return { ready: false, reason: 'readiness snapshot not yet populated' };
+        }
+        return {
+            ready: entry.ready,
+            reason: entry.reason,
+            nextStep: entry.nextStep,
+        };
+    }
+    async refreshNow() {
+        if (this.refreshInFlight)
+            return;
+        this.refreshInFlight = true;
+        try {
+            await this._doRefresh();
+        }
+        finally {
+            this.refreshInFlight = false;
+        }
+    }
+    async _doRefresh() {
+        // Group joined entries by harnessName so we only call isReady() once per harness.
+        const harnessToCids = new Map();
+        for (const [cid, joined] of Object.entries(this.opts.joinedHarnessesByCid)) {
+            const list = harnessToCids.get(joined.harnessName) ?? [];
+            list.push(cid);
+            harnessToCids.set(joined.harnessName, list);
+        }
+        const results = await Promise.all(Array.from(harnessToCids.entries()).map(async ([name, cids]) => {
+            const harness = this.opts.harnessesByName[name];
+            if (!harness) {
+                return {
+                    harnessName: name,
+                    manifestCids: cids,
+                    ready: false,
+                    reason: `harness ${name} not registered in this daemon build`,
+                    nextStep: {
+                        description: 'Upgrade daemon or change SolverNet harness selection',
+                    },
+                };
+            }
+            if (!harness.isReady) {
+                // No isReady → treat as always-ready (matches existing default).
+                return {
+                    harnessName: name,
+                    manifestCids: cids,
+                    ready: true,
+                };
+            }
+            try {
+                let timeoutHandle;
+                const status = await Promise.race([
+                    harness.isReady({ solverType: '*' }),
+                    new Promise((_, reject) => {
+                        timeoutHandle = setTimeout(() => reject(new Error('isReady timed out')), this.opts.isReadyTimeoutMs);
+                    }),
+                ]).finally(() => {
+                    if (timeoutHandle !== undefined)
+                        clearTimeout(timeoutHandle);
+                });
+                return {
+                    harnessName: name,
+                    manifestCids: cids,
+                    ready: status.ready,
+                    reason: status.reason,
+                    nextStep: status.nextStep,
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    harnessName: name,
+                    manifestCids: cids,
+                    ready: false,
+                    reason: `isReady threw: ${msg}`,
+                };
+            }
+        }));
+        this.snapshot = {
+            lastRefreshedAt: new Date().toISOString(),
+            harnesses: results,
+        };
+    }
+}
+//# sourceMappingURL=readiness-registry.js.map

package/dist/harnesses/readiness-registry.js.map

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

package/dist/harnesses/types.d.ts

@@ -210,6 +210,13 @@ export interface Harness {
     name: string;
     /** semver */
     version: string;
+    /**
+     * Optional implStateDir paths that are runtime-only and should not contribute
+     * to the frozen-mode state digest. Use this for generated credentials,
+     * binaries, or per-task config that a harness needs in ctx.implStateDir but
+     * that is not part of its learning/code surface.
+     */
+    freezeStateHashIgnore?: readonly string[];
     /**
      * Return true if this Harness should handle the given (solverType, role) pair.
      *

package/dist/main.d.ts

@@ -19,6 +19,9 @@
  *   jinn run
  */
 import { type ErrorEnvelope } from './errors/envelope.js';
+import type { Harness } from './harnesses/types.js';
+import { HarnessReadinessRegistry } from './harnesses/readiness-registry.js';
+import type { JinnConfig } from './config.js';
 export interface DaemonStartupInfo {
     schemaVersion: 1;
     generatedAt: string;
@@ -45,3 +48,14 @@ export interface SetupHaltedInfo {
     error: ErrorEnvelope;
 }
 export declare function main(): Promise<DaemonStartupInfo | SetupHaltedInfo | void>;
+/**
+ * Builds a HarnessReadinessRegistry from the harness list returned by
+ * buildHarnesses() and the operator's joinedSolverNets config block.
+ *
+ * Per A2 carry-over: start() only schedules the background tick; callers that
+ * need the snapshot populated immediately must call refreshNow() after start().
+ */
+export declare function buildHarnessReadinessRegistry(args: {
+    harnesses: Harness[];
+    config: Pick<JinnConfig, 'joinedSolverNets'>;
+}): HarnessReadinessRegistry;

package/dist/main.js

@@ -27,6 +27,7 @@ import { fileURLToPath } from 'node:url';
 import { loadConfig, getConfigPathFromArgs, DEFAULT_CONFIG_PATH } from './config.js';
 import { Store } from './store/store.js';
 import { startApiServer } from './api/server.js';
+import { addHarnessReadinessRoutes } from './api/harness-readiness-endpoint.js';
 import { CapturePublishUnavailableError } from './api/captures.js';
 import { invalidatePredictionOperatorStatusCache } from './api/gather-status.js';
 import { ensureUiToken } from './api/ui-token.js';
@@ -37,10 +38,6 @@ import { createSetupModeController } from './setup-mode.js';
 import { buildEnvelope, emitEnvelope } from './errors/envelope.js';
 import { clearBootstrapError, persistBootstrapError, } from './errors/persisted-bootstrap-error.js';
 import { emitStructured } from './events/emitter.js';
-import { checkClaudeBinary } from './preflight/claude-binary.js';
-import { emitClaudeBinaryPreflightFailure } from './preflight/claude-invocation-envelope.js';
-import { detectAuthContext, probeClaudeAuth } from './preflight/claude-auth.js';
-import { configRequiresClaudeAuth } from './preflight/claude-required.js';
 import { FleetBootstrapper } from './earning/bootstrap.js';
 import { DEFAULT_TESTNET_ARTIFACTS, applyChainGasOverrides, getChainConfig, loadJinnMviConfig } from './earning/contracts.js';
 import { runLegacyAgentIdMigration } from './earning/migrate-agent-id.js';
@@ -57,7 +54,8 @@ import { DEFAULT_DISABLED_HARNESSES, DEFAULT_HARNESS, HarnessRegistry, } from '.
 import { joinedSolverNetsViewFromConfig } from './harnesses/engine/engine.js';
 import { buildHarnesses } from './harnesses/impls/index.js';
 import { loadExternalImpl } from './harnesses/external-impls/index.js';
-import { CLAUDE_CODE_HARNESS, CODEX_HARNESS, harnessStateDirName } from './harnesses/names.js';
+import { CLAUDE_CODE_HARNESS, CODEX_HARNESS, HERMES_AGENT_HARNESS, harnessStateDirName } from './harnesses/names.js';
+import { HarnessReadinessRegistry } from './harnesses/readiness-registry.js';
 import { createClients } from './adapters/mech/safe.js';
 import { loadSolverNets } from './solver-nets/registry.js';
 import { createCorpus } from './corpus/index.js';
@@ -442,7 +440,7 @@ async function bootstrap() {
     };
     // eslint-disable-next-line no-constant-condition
     while (true) {
-        result = await bootstrapper.bootstrap(PASSWORD);
+        result = await bootstrapper.ensureStage1And2(PASSWORD);
         if (!result.funding) {
             clearFundingGate();
             break;
@@ -753,6 +751,10 @@ export async function main() {
             bindHost: apiBindHost,
             corpus: () => corpusForApi,
             ui: { token: uiToken, handshakeKey },
+            hermesDoctor: {
+                hermesPath: config.hermesPath,
+                hermesDoctorTimeoutMs: config.hermesDoctorTimeoutMs,
+            },
             admin: {
                 onRestartRequested: () => {
                     console.log('[main] Restart requested via operator MCP. Exiting...');
@@ -840,7 +842,12 @@ export async function main() {
                             contract: { id: 'swe-rebench-v2', version: 'v1' },
                             state: 'live',
                             supportedRoles: ['solving', 'evaluating'],
+                            // Order matters: the dashboard pre-selects compatibleHarnesses[0]
+                            // as the default solver harness. Hermes Agent is the SWE-rebench v2
+                            // default per the 2026-05-12 decision (jinn-mono-8psp.2 / spec §10);
+                            // operators may switch to Claude Code or Codex.
                             compatibleHarnesses: [
+                                { name: HERMES_AGENT_HARNESS, version: '0.1.0', supportsRoles: ['solving'] },
                                 { name: CLAUDE_CODE_HARNESS, version: '0.1.0', supportsRoles: ['solving'] },
                                 { name: CODEX_HARNESS, version: '0.1.0', supportsRoles: ['solving'] },
                                 { name: 'swe-rebench-v2-evaluator', version: '0.1.0', supportsRoles: ['evaluating'] },
@@ -1207,35 +1214,6 @@ export async function main() {
             },
         });
     }
-    const claudeAuthRequired = configRequiresClaudeAuth(config);
-    if (claudeAuthRequired) {
-        const preflight = await checkClaudeBinary(activeClaudePath);
-        if (!preflight.ok) {
-            emitClaudeBinaryPreflightFailure(preflight.detail, activeClaudePath);
-        }
-        const authContext = detectAuthContext({ cwd: process.cwd(), configuredMode: config.runtimeMode });
-        const authProbe = probeClaudeAuth({
-            context: authContext,
-            cwd: process.cwd(),
-            claudePath: activeClaudePath,
-        });
-        if (!authProbe.authenticated) {
-            emitEnvelope({
-                code: 'invalid_invocation',
-                message: 'Claude is not authenticated. Complete Claude setup in the operator app, then restart the daemon.',
-                hint: `Detected context: ${authContext}. Run \`jinn run\` to open the app-guided setup flow.`,
-                exampleCli: 'jinn run',
-                details: {
-                    field: 'claude_auth',
-                    context: authContext,
-                    authenticated: false,
-                },
-            });
-        }
-    }
-    else {
-        console.log('[main] Claude auth preflight skipped; Claude-backed harnesses are disabled.');
-    }
     const runner = new ClaudeRunner({
         claudePath: activeClaudePath,
         model: config.claudeModel,
@@ -1440,10 +1418,37 @@ export async function main() {
         externalImpls,
         disabledNames: config.harnesses?.disabled,
         corpusEnv,
+        hermesPath: config.hermesPath,
+        hermesModel: config.hermesModel,
+        hermesProvider: config.hermesProvider,
     })) {
         implRegistry.register(impl);
     }
     console.log(`[main] HarnessRegistry: ${implRegistry.list().map(i => i.name).join(', ')}`);
+    // ── Harness readiness registry ─────────────────────────────────────────────
+    // Composes per-harness isReady() probes into a cached snapshot consumed by
+    // claim loops (A5) and /v1/harnesses/readiness (A3).
+    //
+    // The registry is constructed here, after buildHarnesses() has run, which
+    // is necessarily after bootstrap (bootstrap needs the keystore). The HTTP
+    // server was started before bootstrap so it could show setup progress — we
+    // mount the readiness routes on the already-running app via setupApiServer.app
+    // (same pattern used by registerSolverNetsEndpoints). Routes are registered
+    // before the first operator request that cares about harness readiness.
+    //
+    // A2 carry-over: start() only schedules the 4s tick; refreshNow() is called
+    // immediately so the snapshot is populated before the first claim-loop tick.
+    const harnessReadinessRegistry = buildHarnessReadinessRegistry({
+        harnesses: implRegistry.list(),
+        config,
+    });
+    harnessReadinessRegistry.start();
+    await harnessReadinessRegistry.refreshNow();
+    // Mount /v1/harnesses/readiness and /v1/harnesses/:name/readiness on the
+    // already-running HTTP server. Hono matches eagerly on first request; these
+    // routes are registered before the daemon's first claim-loop tick.
+    addHarnessReadinessRoutes(setupApiServer.app, { registry: harnessReadinessRegistry });
+    console.log('[main] HarnessReadinessRegistry started; /v1/harnesses/readiness routes active.');
     // ── Engine deps ───────────────────────────────────────────────────────────────
     // Packaging deps: artifacts are always written to served_artifacts
     // (operator-local SQLite). In public-testnet donation mode, scrubbed artifact
@@ -1812,6 +1817,7 @@ export async function main() {
         nodeEndpoint: config.nodeEndpoint,
         creatorSafeAddress: safeAddress,
         corpusFactory,
+        harnessReadinessRegistry,
         status: {
             earningDir: config.earningDir,
             rpcUrl: config.rpcUrl,
@@ -1928,6 +1934,7 @@ export async function main() {
             let exitCode = 0;
             console.log(`\n[main] Received ${signal}, shutting down...`);
             try {
+                harnessReadinessRegistry.stop();
                 await daemon.stop();
                 await setupApiServer.close().catch(() => undefined);
                 await closeCaptureReceiver();
@@ -1994,4 +2001,32 @@ export async function main() {
         serviceId,
     };
 }
+// ── Harness readiness registry factory ───────────────────────────────────────
+// Exported so tests can construct a registry without booting the full daemon.
+/**
+ * Builds a HarnessReadinessRegistry from the harness list returned by
+ * buildHarnesses() and the operator's joinedSolverNets config block.
+ *
+ * Per A2 carry-over: start() only schedules the background tick; callers that
+ * need the snapshot populated immediately must call refreshNow() after start().
+ */
+export function buildHarnessReadinessRegistry(args) {
+    const harnessesByName = {};
+    for (const h of args.harnesses) {
+        harnessesByName[h.name] = h;
+    }
+    const joinedHarnessesByCid = {};
+    for (const [cid, entry] of Object.entries(args.config.joinedSolverNets ?? {})) {
+        if (entry.harness) {
+            joinedHarnessesByCid[cid] = {
+                harnessName: entry.harness,
+                roles: entry.roles,
+            };
+        }
+    }
+    return new HarnessReadinessRegistry({
+        harnessesByName,
+        joinedHarnessesByCid,
+    });
+}
 //# sourceMappingURL=main.js.map