@jinn-network/client 0.1.2 → 0.1.3-canary.12cf8b76

package/dist/agent/auto-mode-detect.d.ts

@@ -0,0 +1,6 @@
+export interface AutoModeAvailability {
+    available: boolean;
+    reason: string;
+    version?: string;
+}
+export declare function detectAutoModeAvailable(claudePath: string): Promise<AutoModeAvailability>;

package/dist/agent/auto-mode-detect.js

@@ -0,0 +1,44 @@
+/**
+ * Detects whether the local `claude` binary supports Auto Mode.
+ *
+ * Auto Mode requires Claude Code v2.1.83+. Available on Max/Team/Enterprise/API
+ * plans (NOT Pro). Plan-detection is out of band — we just check the version.
+ * If the user's plan doesn't allow Auto Mode, the binary itself rejects the flag
+ * at runtime; the embedded session will fall back to the default permission
+ * mode automatically.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileP = promisify(execFile);
+const MIN_VERSION = { major: 2, minor: 1, patch: 83 };
+export async function detectAutoModeAvailable(claudePath) {
+    try {
+        const { stdout } = await execFileP(claudePath, ['--version'], { timeout: 4000 });
+        const versionMatch = /(\d+)\.(\d+)\.(\d+)/.exec(stdout);
+        if (!versionMatch) {
+            return { available: false, reason: 'could not parse claude --version output' };
+        }
+        const major = Number(versionMatch[1]);
+        const minor = Number(versionMatch[2]);
+        const patch = Number(versionMatch[3]);
+        const versionStr = `${major}.${minor}.${patch}`;
+        const isOld = major < MIN_VERSION.major ||
+            (major === MIN_VERSION.major && minor < MIN_VERSION.minor) ||
+            (major === MIN_VERSION.major && minor === MIN_VERSION.minor && patch < MIN_VERSION.patch);
+        if (isOld) {
+            return {
+                available: false,
+                reason: `Claude Code ${versionStr} is older than required ${MIN_VERSION.major}.${MIN_VERSION.minor}.${MIN_VERSION.patch} for Auto Mode`,
+                version: versionStr,
+            };
+        }
+        return { available: true, reason: 'ok', version: versionStr };
+    }
+    catch (err) {
+        return {
+            available: false,
+            reason: `claude --version failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=auto-mode-detect.js.map

package/dist/agent/auto-mode-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-mode-detect.js","sourceRoot":"","sources":["../../src/agent/auto-mode-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEtC,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAQtD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,UAAkB;IAC9D,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,yCAAyC,EAAE,CAAC;QACjF,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QAChD,MAAM,KAAK,GACT,KAAK,GAAG,WAAW,CAAC,KAAK;YACzB,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,IAAI,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;YAC1D,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,IAAI,KAAK,KAAK,WAAW,CAAC,KAAK,IAAI,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5F,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,eAAe,UAAU,2BAA2B,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,gBAAgB;gBACvI,OAAO,EAAE,UAAU;aACpB,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SACvF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/agent/operator-claude.d.ts

@@ -0,0 +1,22 @@
+export interface OperatorClaudeConfig {
+    claudePath: string;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    /** When true, spawn with --enable-auto-mode (Claude Code v2.1.83+). */
+    autoMode: boolean;
+    /** MCP config path so the embedded session reaches the operator MCP server. */
+    mcpConfigPath?: string;
+}
+export interface OperatorClaude {
+    write(data: string): void;
+    resize?(cols: number, rows: number): void;
+    onData(cb: (chunk: string) => void): void;
+    onExit(cb: (code: number | null) => void): void;
+    kill(): void;
+}
+export declare class OperatorClaudeSpawnError extends Error {
+    readonly remediation: string;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, remediation: string, cause?: unknown | undefined);
+}
+export declare function spawnOperatorClaude(cfg: OperatorClaudeConfig): Promise<OperatorClaude>;

package/dist/agent/operator-claude.js

@@ -0,0 +1,134 @@
+/**
+ * Operator-facing Claude Code subprocess.
+ *
+ * Distinct from the per-restoration claude subprocess (client/src/runner/claude.ts).
+ * This one is a long-lived session attached to the operator panel via WebSocket.
+ *
+ * Requires node-pty for a real TTY (colors, cursor, ^C, claude's interactive
+ * mode). If node-pty fails to load or spawn — typically a prebuilt-binary ABI
+ * mismatch with the host Node version — we throw a `OperatorClaudeSpawnError`
+ * with diagnostic detail rather than fall back to a plain pipe spawn. Claude
+ * detects pipe stdin and exits immediately with a "no stdin data" error,
+ * producing broken-looking UX. Better to surface the install issue clearly so
+ * the operator can `npm rebuild node-pty` (which the client's postinstall
+ * hook does automatically on a normal install).
+ *
+ * Pre-flight: we mark claude's first-run wizard as already-completed so the
+ * embedded session doesn't drop the operator into a theme picker / "let's
+ * get started" flow they don't need. Claude persists onboarding state in
+ * ~/.claude.json. If the file is missing (fresh operator) we write a minimal
+ * stub with hasCompletedOnboarding:true. If the file already exists (returning
+ * operator who has used claude before) we leave it alone — the operator's
+ * actual settings are theirs.
+ */
+import { existsSync, writeFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export class OperatorClaudeSpawnError extends Error {
+    remediation;
+    cause;
+    constructor(message, remediation, cause) {
+        super(message);
+        this.remediation = remediation;
+        this.cause = cause;
+        this.name = 'OperatorClaudeSpawnError';
+    }
+}
+/**
+ * Pre-mark claude's first-run wizard as complete when the operator's claude
+ * config doesn't exist yet. Claude reads ~/.claude.json on startup; setting
+ * hasCompletedOnboarding:true skips the theme picker / "let's get started"
+ * wizard. If the file exists we don't touch it — the operator's own
+ * preferences are authoritative.
+ *
+ * Important: claude runs a migration step on a file it considers stale. If
+ * migrationVersion is missing or older than the current schema, claude
+ * rewrites the file from scratch and our hasCompletedOnboarding gets dropped.
+ * The stub below sets migrationVersion to 13 (the current value at the time
+ * of writing) plus the per-model migration markers, which prevents the
+ * migration from firing and preserves our flags.
+ */
+function ensureClaudeOnboarded() {
+    const home = process.env['HOME'] ?? homedir();
+    const claudeJsonPath = join(home, '.claude.json');
+    if (existsSync(claudeJsonPath))
+        return;
+    try {
+        mkdirSync(dirname(claudeJsonPath), { recursive: true });
+        const stub = {
+            migrationVersion: 13,
+            hasCompletedOnboarding: true,
+            lastOnboardingVersion: '999.999.999',
+            firstStartTime: new Date().toISOString(),
+            opusProMigrationComplete: true,
+            sonnet1m45MigrationComplete: true,
+            sonnet45MigrationComplete: true,
+            opus45MigrationComplete: true,
+            thinkingMigrationComplete: true,
+            seenNotifications: {},
+        };
+        writeFileSync(claudeJsonPath, JSON.stringify(stub, null, 2) + '\n', { mode: 0o600 });
+    }
+    catch {
+        // Non-fatal — claude will just show its first-run wizard. Don't crash
+        // the agent panel over a config-write failure.
+    }
+}
+export async function spawnOperatorClaude(cfg) {
+    ensureClaudeOnboarded();
+    const args = [];
+    if (cfg.autoMode)
+        args.push('--enable-auto-mode');
+    if (cfg.mcpConfigPath)
+        args.push('--mcp-config', cfg.mcpConfigPath);
+    let ptyModule;
+    try {
+        ptyModule = await import('node-pty');
+    }
+    catch (err) {
+        throw new OperatorClaudeSpawnError(`Failed to load node-pty: ${err instanceof Error ? err.message : String(err)}`, 'Run `npm rebuild node-pty` in the jinn-client install directory and restart the daemon.', err);
+    }
+    try {
+        // Pass through the env vars that get claude's TUI rendering right. Without
+        // COLORTERM + FORCE_COLOR, claude falls back to a degraded glyph set that
+        // renders as solid blocks instead of box-drawing chars in xterm.js.
+        // Pattern from siteboon/claudecodeui's shell-websocket bridge.
+        const pty = ptyModule.spawn(cfg.claudePath, args, {
+            name: 'xterm-256color',
+            cols: 100,
+            rows: 30,
+            cwd: cfg.cwd,
+            env: {
+                ...process.env,
+                ...cfg.env,
+                TERM: 'xterm-256color',
+                COLORTERM: 'truecolor',
+                FORCE_COLOR: '3',
+            },
+        });
+        const dataHandlers = [];
+        const exitHandlers = [];
+        pty.onData((d) => dataHandlers.forEach((h) => h(d)));
+        pty.onExit(({ exitCode }) => exitHandlers.forEach((h) => h(exitCode ?? null)));
+        return {
+            write: (d) => pty.write(d),
+            resize: (c, r) => pty.resize(c, r),
+            onData: (cb) => { dataHandlers.push(cb); },
+            onExit: (cb) => { exitHandlers.push(cb); },
+            kill: () => pty.kill(),
+        };
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 'ENOENT') {
+            throw new OperatorClaudeSpawnError(`Claude Code CLI not found: ${cfg.claudePath}`, 'Install Claude Code from the operator panel, then sign in with Claude.', err);
+        }
+        // node-pty's prebuilt binary loaded but posix_spawnp / fork failed at runtime.
+        // This is the ABI-mismatch case — the JS wrapper resolves but the native
+        // module's internals can't actually spawn. Falling back to plain spawn
+        // would silently produce a broken claude session.
+        throw new OperatorClaudeSpawnError(`node-pty failed to spawn: ${err instanceof Error ? err.message : String(err)}`, 'Run `npm rebuild node-pty` in the jinn-client install directory and restart the daemon. ' +
+            'If the rebuild fails, ensure your system has a C++ toolchain (Xcode CLT on macOS, build-essential on Linux).', err);
+    }
+}
+//# sourceMappingURL=operator-claude.js.map

package/dist/agent/operator-claude.js.map

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

package/dist/api/admin-endpoint.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Admin endpoints for operator MCP write tools.
+ *
+ * Mounted only when ui auth is configured (so they're token-gated). Currently
+ * supports: daemon_restart (real, exits the process gracefully), manual reward
+ * claims, and loop pause/resume (stubbed — returns not_implemented).
+ */
+import type { Hono } from 'hono';
+export interface AdminEndpointConfig {
+    onRestartRequested: () => void;
+}
+export declare function addAdminRoutes(app: Hono, cfg: AdminEndpointConfig): void;

package/dist/api/admin-endpoint.js

@@ -0,0 +1,71 @@
+import claimRewardsCommand from '../cli/commands/claim-rewards.js';
+async function runCommandJson(command, argv, env) {
+    const chunks = [];
+    let exitCode = null;
+    const writer = {
+        write(s) {
+            chunks.push(s);
+            return true;
+        },
+    };
+    const ctx = {
+        argv,
+        stdoutIsTty: false,
+        writer,
+        exit: (code) => { exitCode = code; },
+        env,
+    };
+    await command.run(ctx);
+    const raw = chunks.join('');
+    let body;
+    try {
+        body = JSON.parse(raw);
+    }
+    catch {
+        body = { ok: false, error: 'invalid_command_json', raw };
+    }
+    return { body, exitCode, raw };
+}
+export function addAdminRoutes(app, cfg) {
+    app.post('/api/admin/restart', (c) => {
+        // Defer the actual exit so the response can flush first.
+        setTimeout(() => {
+            try {
+                cfg.onRestartRequested();
+            }
+            catch (err) {
+                console.error('[admin] restart hook threw:', err);
+            }
+        }, 50);
+        return c.json({ ok: true, scheduled: true });
+    });
+    app.post('/api/admin/claim-rewards', async (c) => {
+        try {
+            const result = await runCommandJson(claimRewardsCommand, ['--yes', '--json'], process.env);
+            const ok = result.exitCode === null || result.exitCode === 0;
+            return c.json({
+                ok,
+                result: result.body,
+                exitCode: result.exitCode,
+            }, ok ? 200 : 500);
+        }
+        catch (err) {
+            return c.json({
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            }, 500);
+        }
+    });
+    app.post('/api/admin/loop/:loop/:action', (c) => {
+        const loop = c.req.param('loop');
+        const action = c.req.param('action');
+        return c.json({
+            schemaVersion: 1,
+            ok: false,
+            reason: 'not_implemented',
+            loop,
+            action,
+        });
+    });
+}
+//# sourceMappingURL=admin-endpoint.js.map

package/dist/api/admin-endpoint.js.map

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

package/dist/api/agent-binding-endpoint.d.ts

@@ -0,0 +1,26 @@
+/**
+ * POST /v1/setup/agent-binding/retry — re-runs the ERC-1271 bind step
+ * for any service whose Safe is not yet bound to its agent NFT.
+ *
+ * The bootstrap correctly continues with `safe_bound_to_agent=false` when
+ * the bind reverts (jinn-mono-aev), so onboarding doesn't halt — but the
+ * binding silently goes missing. This endpoint exists so the operator app
+ * can offer a one-click retry without forcing a full daemon restart.
+ *
+ * Filed alongside the contract-side investigation of *why* the bind reverts
+ * against fresh 1/1 Safes on Base Sepolia (`bd jinn-mono-h74p`).
+ */
+import type { Hono } from 'hono';
+export interface BindAttemptResult {
+    serviceIndex: number;
+    status: 'success' | 'reverted' | 'queued';
+    txHash?: string;
+    detail?: string;
+}
+export interface AgentBindingRoutesConfig {
+    retryBind(serviceIndex: number): Promise<BindAttemptResult>;
+    listUnbound(): Promise<Array<{
+        serviceIndex: number;
+    }>>;
+}
+export declare function addAgentBindingRoutes(app: Hono, config: AgentBindingRoutesConfig): void;

package/dist/api/agent-binding-endpoint.js

@@ -0,0 +1,28 @@
+export function addAgentBindingRoutes(app, config) {
+    app.post('/v1/setup/agent-binding/retry', async (c) => {
+        let body = {};
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            // empty body is allowed — defaults to "all unbound services"
+        }
+        let targets;
+        if (body.serviceIndex !== undefined) {
+            if (typeof body.serviceIndex !== 'number' || !Number.isInteger(body.serviceIndex)) {
+                return c.json({ error: 'invalid_body', detail: '`serviceIndex` must be an integer' }, 400);
+            }
+            targets = [{ serviceIndex: body.serviceIndex }];
+        }
+        else {
+            targets = await config.listUnbound();
+        }
+        const attempts = [];
+        for (const target of targets) {
+            const result = await config.retryBind(target.serviceIndex);
+            attempts.push(result);
+        }
+        return c.json({ ok: true, attempts });
+    });
+}
+//# sourceMappingURL=agent-binding-endpoint.js.map

package/dist/api/agent-binding-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-binding-endpoint.js","sourceRoot":"","sources":["../../src/api/agent-binding-endpoint.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,qBAAqB,CAAC,GAAS,EAAE,MAAgC;IAC/E,GAAG,CAAC,IAAI,CAAC,+BAA+B,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACpD,IAAI,IAAI,GAA+B,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;QAED,IAAI,OAAwC,CAAC;QAC7C,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClF,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,mCAAmC,EAAE,EAAE,GAAG,CAAC,CAAC;YAC7F,CAAC;YACD,OAAO,GAAG,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;QACvC,CAAC;QAED,MAAM,QAAQ,GAAwB,EAAE,CAAC;QACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC3D,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api/bootstrap-endpoint.d.ts

@@ -0,0 +1,24 @@
+/**
+ * GET /v1/bootstrap — exposes the fleet bootstrap state machine to the SPA.
+ *
+ * Reads the persisted fleet state file at `<earningDir>/earning_state.json`
+ * (the same file FleetStateStore writes) and returns:
+ * - mode: 'uninitialized' | 'setup' | 'running'
+ * - currentStep: the lowest-progress step across all services
+ * - per-service step status
+ *
+ * No external chain reads — state file is the source of truth for this endpoint.
+ */
+import type { Hono } from 'hono';
+export interface BootstrapEndpointConfig {
+    earningDir: string;
+    /** Reads operator-tunable runtime fields (rpcUrl, defaultRpcUrl,
+     *  solverNets) and merges them into the response so the SPA's
+     *  Configuration page can render them without a separate fetch. */
+    configReader?: () => {
+        rpcUrl?: string;
+        defaultRpcUrl?: string;
+        solverNets?: Record<string, unknown>;
+    };
+}
+export declare function addBootstrapRoutes(app: Hono, config: BootstrapEndpointConfig): void;

package/dist/api/bootstrap-endpoint.js

@@ -0,0 +1,103 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { readBootstrapError } from '../errors/persisted-bootstrap-error.js';
+const STEPS = [
+    'wallet',
+    'safe_predicted',
+    'awaiting_funding',
+    'safe_deployed',
+    'service_created',
+    'service_activated',
+    'agents_registered',
+    'service_deployed',
+    'service_staked',
+    'staked',
+    'mech_deployed',
+    'agent_registered',
+    'safe_binding_pending',
+    'complete',
+];
+const STEP_INDEX = new Map(STEPS.map((s, i) => [s, i]));
+const RUNNING_STEPS = new Set(['safe_binding_pending', 'complete']);
+function fundingTargetWei(fundingGate) {
+    const required = fundingGate.eth_required;
+    const balance = fundingGate.eth_balance;
+    if (required === undefined || balance === undefined)
+        return undefined;
+    if (!/^\d+$/.test(required) || !/^\d+$/.test(balance))
+        return undefined;
+    return (BigInt(required) + BigInt(balance)).toString();
+}
+export function addBootstrapRoutes(app, config) {
+    app.get('/v1/bootstrap', (c) => {
+        const path = join(config.earningDir, 'earning_state.json');
+        if (!existsSync(path)) {
+            return c.json({
+                schemaVersion: 1,
+                mode: 'uninitialized',
+                steps: STEPS,
+                currentStep: STEPS[0],
+                services: [],
+            });
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch {
+            return c.json({ error: 'unreadable_state_file' }, 500);
+        }
+        const services = parsed.services ?? [];
+        let fundingGate = null;
+        const fundingGatePath = join(config.earningDir, 'bootstrap-funding.json');
+        if (existsSync(fundingGatePath)) {
+            try {
+                fundingGate = JSON.parse(readFileSync(fundingGatePath, 'utf-8'));
+            }
+            catch {
+                fundingGate = null;
+            }
+        }
+        // `[].every(...)` returns true vacuously, so a fresh fleet (no services
+        // yet) was previously treated as "all services running" and the funding
+        // gate was suppressed even when bootstrap-funding.json existed. Compute
+        // allRunning explicitly and gate funding on it instead.
+        const allRunning = services.length > 0 && services.every((s) => RUNNING_STEPS.has(s.step));
+        const fundingGateActive = Boolean(parsed.master_address) &&
+            fundingGate?.master_address?.toLowerCase() === parsed.master_address?.toLowerCase() &&
+            !allRunning;
+        const currentStepIdx = fundingGateActive
+            ? STEP_INDEX.get('awaiting_funding')
+            : services.length === 0
+                ? (parsed.master_address ? STEP_INDEX.get('awaiting_funding') : 0)
+                : Math.min(...services.map((s) => STEP_INDEX.get(s.step) ?? 0));
+        const currentStep = STEPS[currentStepIdx];
+        // Surface the most recent persisted bootstrap-error envelope so the panel
+        // can render a "Bootstrap failed at X" state instead of staying frozen on
+        // the last persisted step. Cleared at the start of each bootstrap attempt.
+        const error = readBootstrapError(config.earningDir);
+        const cfg = config.configReader?.() ?? {};
+        return c.json({
+            schemaVersion: 1,
+            mode: allRunning ? 'running' : 'setup',
+            steps: STEPS,
+            currentStep,
+            services,
+            master_address: parsed.master_address,
+            chain: parsed.chain,
+            ...(cfg.rpcUrl !== undefined ? { rpcUrl: cfg.rpcUrl } : {}),
+            ...(cfg.defaultRpcUrl !== undefined ? { defaultRpcUrl: cfg.defaultRpcUrl } : {}),
+            ...(cfg.solverNets !== undefined ? { solverNets: cfg.solverNets } : {}),
+            ...(fundingGateActive && fundingGate ? {
+                funding: {
+                    master_address: fundingGate.master_address,
+                    eth_required: fundingGate.eth_required,
+                    eth_balance: fundingGate.eth_balance,
+                    targetWei: fundingTargetWei(fundingGate),
+                },
+            } : {}),
+            ...(error ? { error } : {}),
+        });
+    });
+}
+//# sourceMappingURL=bootstrap-endpoint.js.map

package/dist/api/bootstrap-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-endpoint.js","sourceRoot":"","sources":["../../src/api/bootstrap-endpoint.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAc5E,MAAM,KAAK,GAAG;IACZ,QAAQ;IACR,gBAAgB;IAChB,kBAAkB;IAClB,eAAe;IACf,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,gBAAgB;IAChB,QAAQ;IACR,eAAe;IACf,kBAAkB;IAClB,sBAAsB;IACtB,UAAU;CACF,CAAC;AAGX,MAAM,UAAU,GAAG,IAAI,GAAG,CAAe,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAO,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC,CAAC;AAqB1E,SAAS,gBAAgB,CAAC,WAA8B;IACtD,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC;IAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACxE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAS,EAAE,MAA+B;IAC3E,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,aAAa,EAAE,CAAC;gBAChB,IAAI,EAAE,eAAe;gBACrB,KAAK,EAAE,KAAK;gBACZ,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;gBACrB,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAqB,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QACvC,IAAI,WAAW,GAA6B,IAAI,CAAC;QACjD,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;QAC1E,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAsB,CAAC;YACxF,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;QACD,wEAAwE;QACxE,wEAAwE;QACxE,wEAAwE;QACxE,wDAAwD;QACxD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3F,MAAM,iBAAiB,GACrB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;YAC9B,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE;YACnF,CAAC,UAAU,CAAC;QACd,MAAM,cAAc,GAAG,iBAAiB;YACtC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAE;YACrC,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBACvB,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;QAE1C,0EAA0E;QAC1E,0EAA0E;QAC1E,2EAA2E;QAC3E,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAEpD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC;QAE1C,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,aAAa,EAAE,CAAC;YAChB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;YACtC,KAAK,EAAE,KAAK;YACZ,WAAW;YACX,QAAQ;YACR,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,iBAAiB,IAAI,WAAW,CAAC,CAAC,CAAC;gBACrC,OAAO,EAAE;oBACP,cAAc,EAAE,WAAW,CAAC,cAAc;oBAC1C,YAAY,EAAE,WAAW,CAAC,YAAY;oBACtC,WAAW,EAAE,WAAW,CAAC,WAAW;oBACpC,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC;iBACzC;aACF,CAAC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api/events-endpoint.d.ts

@@ -0,0 +1,9 @@
+/**
+ * /v1/events SSE stream + /v1/events/recent JSON endpoint.
+ *
+ * Backed by the singleton EventRingBuffer in src/events/emitter.ts. The SSE
+ * channel sends a small backfill (last 50 events) then streams new events
+ * pushed to the buffer until the client disconnects.
+ */
+import type { Hono } from 'hono';
+export declare function addEventsRoutes(app: Hono): void;

package/dist/api/events-endpoint.js

@@ -0,0 +1,46 @@
+import { streamSSE } from 'hono/streaming';
+import { getEventBuffer } from '../events/emitter.js';
+const ALLOWED_KINDS = ['intent', 'reward', 'fleet', 'system', 'error', 'log'];
+function parseKinds(s) {
+    if (!s)
+        return undefined;
+    const parts = s.split(',').map((k) => k.trim()).filter(Boolean);
+    const out = parts.filter((p) => ALLOWED_KINDS.includes(p));
+    return out.length > 0 ? out : undefined;
+}
+export function addEventsRoutes(app) {
+    app.get('/v1/events/recent', (c) => {
+        const kinds = parseKinds(c.req.query('kinds'));
+        const sinceId = c.req.query('sinceId') ?? undefined;
+        const limitRaw = c.req.query('limit');
+        const limit = limitRaw ? Math.max(1, Math.min(1000, parseInt(limitRaw, 10) || 100)) : 100;
+        const events = getEventBuffer().snapshot({ kinds, sinceId, limit });
+        return c.json({ events });
+    });
+    app.get('/v1/events', (c) => {
+        const kinds = parseKinds(c.req.query('kinds'));
+        return streamSSE(c, async (stream) => {
+            const buf = getEventBuffer();
+            // Backfill the last 50 events on connect so the SPA has immediate context.
+            const backfill = buf.snapshot({ kinds, limit: 50 });
+            for (const e of backfill) {
+                await stream.writeSSE({ data: JSON.stringify(e), event: e.kind, id: e.id });
+            }
+            const unsub = buf.subscribe(async (e) => {
+                if (kinds && !kinds.includes(e.kind))
+                    return;
+                try {
+                    await stream.writeSSE({ data: JSON.stringify(e), event: e.kind, id: e.id });
+                }
+                catch {
+                    // client dropped; the close handler will run unsub
+                }
+            });
+            // Block until the client disconnects.
+            await new Promise((resolve) => {
+                c.req.raw.signal.addEventListener('abort', () => { unsub(); resolve(); });
+            });
+        });
+    });
+}
+//# sourceMappingURL=events-endpoint.js.map

package/dist/api/events-endpoint.js.map

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

package/dist/api/fleet-build.d.ts

@@ -5,7 +5,7 @@
  * Slices GatheredStatusRaw (same source as /v1/status) into per-service detail.
  */
 import type { GatheredStatusRaw } from './status-build.js';
-type AttentionKind = 'none' | 'low_gas' | 'evicted' | 'stake_missing' | 'bond_insufficient' | 'reconcile_needed';
+type AttentionKind = 'none' | 'low_gas' | 'identity_binding_pending' | 'evicted' | 'stake_missing' | 'bond_insufficient' | 'reconcile_needed';
 export interface FleetV1Service {
     index: number;
     step: string;

package/dist/api/fleet-build.js

@@ -4,13 +4,8 @@
  * Contract: spec/2026-04-14-client-surface.md §4.2.
  * Slices GatheredStatusRaw (same source as /v1/status) into per-service detail.
  */
+import { isOperationalServiceStep, isStakedLikeServiceStep } from '../earning/types.js';
 import { displayFleetServiceIndex } from '../earning/fleet-display-index.js';
-const STAKED_LIKE_STEPS = new Set([
-    'staked',
-    'mech_deployed',
-    'complete',
-    'service_staked',
-]);
 function computeAttention(svc, raw, isFirstService) {
     if (isFirstService &&
         raw.minMasterEthWei &&
@@ -22,7 +17,21 @@ function computeAttention(svc, raw, isFirstService) {
             exampleCli: 'jinn fund-requirements --json',
         };
     }
-    if (svc.step !== 'complete') {
+    if (svc.error) {
+        return {
+            kind: 'reconcile_needed',
+            hint: svc.error,
+            exampleCli: 'jinn status --detail',
+        };
+    }
+    if (svc.step === 'safe_binding_pending') {
+        return {
+            kind: 'identity_binding_pending',
+            hint: 'Service is running; ERC-8004 Safe-to-agent binding is pending retry.',
+            exampleCli: 'jinn bootstrap --json',
+        };
+    }
+    if (!isOperationalServiceStep(svc.step)) {
         return {
             kind: 'reconcile_needed',
             hint: `Service ${displayFleetServiceIndex(svc)} is at step ${svc.step}. Run jinn bootstrap to advance.`,
@@ -57,7 +66,7 @@ export function assembleFleetV1(raw) {
                 },
             },
             staking: {
-                staked: STAKED_LIKE_STEPS.has(svc.step),
+                staked: isStakedLikeServiceStep(svc.step),
                 evicted: false,
                 sinceBlock: null,
             },