@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/agent/operator-claude.js

@@ -0,0 +1,176 @@
+/**
+ * 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 { spawnSync } from 'node:child_process';
+import { existsSync, writeFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+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.
+    }
+}
+function findNodePtyFixScript() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(here, '..', 'scripts', 'fix-node-pty.mjs'),
+        join(here, '..', '..', 'scripts', 'fix-node-pty.mjs'),
+    ];
+    return candidates.find((candidate) => existsSync(candidate)) ?? null;
+}
+function runNodePtyRepair() {
+    const script = findNodePtyFixScript();
+    if (!script)
+        return 'node-pty repair script was not found in this install.';
+    const result = spawnSync(process.execPath, [script, '--verify'], {
+        encoding: 'utf8',
+        stdio: 'pipe',
+        timeout: 15000,
+    });
+    if (result.status === 0)
+        return null;
+    const detail = (result.stderr || result.stdout || `exit status ${result.status ?? 'unknown'}`).trim();
+    return detail || 'node-pty repair did not complete successfully.';
+}
+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);
+    }
+    const spawnPty = () => {
+        // 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(),
+        };
+    };
+    try {
+        return spawnPty();
+    }
+    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);
+        }
+        let finalError = err;
+        const repairError = runNodePtyRepair();
+        if (!repairError) {
+            try {
+                return spawnPty();
+            }
+            catch (retryErr) {
+                const retryCode = retryErr?.code;
+                if (retryCode === 'ENOENT') {
+                    throw new OperatorClaudeSpawnError(`Claude Code CLI not found: ${cfg.claudePath}`, 'Install Claude Code from the operator panel, then sign in with Claude.', retryErr);
+                }
+                finalError = retryErr;
+            }
+        }
+        // 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: ${finalError instanceof Error ? finalError.message : String(finalError)}`, '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).' +
+            (repairError ? ` Automatic repair failed: ${repairError}` : ''), finalError);
+    }
+}
+//# 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,25 @@
+/**
+ * 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, joinedSolverNets) 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>;
+        joinedSolverNets?: Record<string, unknown>;
+    };
+}
+export declare function addBootstrapRoutes(app: Hono, config: BootstrapEndpointConfig): void;

package/dist/api/bootstrap-endpoint.js

@@ -0,0 +1,104 @@
+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 } : {}),
+            ...(cfg.joinedSolverNets !== undefined ? { joinedSolverNets: cfg.joinedSolverNets } : {}),
+            ...(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":"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"}

package/dist/api/captures.d.ts

@@ -0,0 +1,22 @@
+import type { Hono } from 'hono';
+import type { CapturesStore, PendingCaptureRow, SpanRow } from '../store/captures.js';
+export interface CaptureDetail {
+    capture: PendingCaptureRow;
+    spans: SpanRow[];
+}
+export interface CapturesRoutesDeps {
+    captures: CapturesStore;
+    publishCapture?: (sessionId: string) => Promise<{
+        envelopeCid: string;
+    }>;
+    setTrustedRepo?: (repoRemoteUrl: string, trusted: boolean) => Promise<void> | void;
+}
+export declare class CapturePublishUnavailableError extends Error {
+    constructor(message?: string);
+}
+export declare class CapturePublishRateLimitError extends Error {
+    readonly retryAfterMs?: number;
+    readonly reason: string;
+    constructor(reason: string, retryAfterMs?: number);
+}
+export declare function addCapturesRoutes(app: Hono, deps: CapturesRoutesDeps): void;

package/dist/api/captures.js

@@ -0,0 +1,88 @@
+export class CapturePublishUnavailableError extends Error {
+    constructor(message = 'Capture publishing is not available yet') {
+        super(message);
+        this.name = 'CapturePublishUnavailableError';
+    }
+}
+export class CapturePublishRateLimitError extends Error {
+    retryAfterMs;
+    reason;
+    constructor(reason, retryAfterMs) {
+        super(`Capture publish rate limit exceeded: ${reason}`);
+        this.name = 'CapturePublishRateLimitError';
+        this.reason = reason;
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export function addCapturesRoutes(app, deps) {
+    app.get('/api/captures/pending', (c) => {
+        return c.json({ captures: deps.captures.listPending() });
+    });
+    app.get('/api/captures/:sessionId', (c) => {
+        const sessionId = c.req.param('sessionId');
+        const capture = deps.captures.getBySession(sessionId);
+        if (!capture)
+            return c.json({ error: 'capture_not_found' }, 404);
+        return c.json({
+            capture,
+            spans: deps.captures.getSpansBySession(sessionId),
+        });
+    });
+    app.post('/api/captures/:sessionId/approve', async (c) => {
+        const sessionId = c.req.param('sessionId');
+        const capture = deps.captures.getBySession(sessionId);
+        if (!capture || capture.status !== 'pending') {
+            return c.json({ error: 'capture_not_found' }, 404);
+        }
+        if (!deps.publishCapture) {
+            return c.json({ error: 'capture_publish_unavailable' }, 503);
+        }
+        let published;
+        try {
+            published = await deps.publishCapture(sessionId);
+        }
+        catch (err) {
+            if (err instanceof CapturePublishRateLimitError) {
+                return c.json({
+                    error: 'capture_publish_rate_limited',
+                    reason: err.reason,
+                    retryAfterMs: err.retryAfterMs,
+                }, 429);
+            }
+            if (err instanceof CapturePublishUnavailableError) {
+                return c.json({ error: 'capture_publish_unavailable', message: err.message }, 503);
+            }
+            throw err;
+        }
+        const publishedAt = new Date().toISOString();
+        deps.captures.markApproved(sessionId, {
+            envelopeCid: published.envelopeCid,
+            publishedAt,
+        });
+        return c.json({ ok: true, sessionId, envelopeCid: published.envelopeCid, publishedAt });
+    });
+    app.post('/api/captures/:sessionId/skip', (c) => {
+        const sessionId = c.req.param('sessionId');
+        const capture = deps.captures.getBySession(sessionId);
+        if (!capture || capture.status !== 'pending') {
+            return c.json({ error: 'capture_not_found' }, 404);
+        }
+        const skippedAt = new Date().toISOString();
+        deps.captures.markSkipped(sessionId, { skippedAt });
+        return c.json({ ok: true, sessionId, skippedAt });
+    });
+    app.post('/api/captures/trust-repos', async (c) => {
+        const body = await c.req.json().catch(() => null);
+        if (typeof body !== 'object' ||
+            body === null ||
+            typeof body['repoRemoteUrl'] !== 'string') {
+            return c.json({ error: 'invalid_trust_repo_payload' }, 400);
+        }
+        const repoRemoteUrl = body.repoRemoteUrl;
+        const trustedRaw = body['trusted'];
+        const trusted = typeof trustedRaw === 'boolean' ? trustedRaw : true;
+        await deps.setTrustedRepo?.(repoRemoteUrl, trusted);
+        return c.json({ ok: true, repoRemoteUrl, trusted });
+    });
+}
+//# sourceMappingURL=captures.js.map

package/dist/api/captures.js.map

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

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