@jinn-network/client 0.1.0-canary.adfd078d

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

@@ -0,0 +1,92 @@
+/**
+ * Pure assembly for GET /v1/status JSON (testable without RPC or filesystem).
+ */
+import type { FleetState } from '../earning/types.js';
+export type StatusHintsScope = 'full' | 'sqlite_only';
+export interface GatheredStatusRaw {
+    /** sqlite_only: only SQLite-backed fields (e2e / API without fleet context). */
+    hintsScope?: StatusHintsScope;
+    shutdownState: string | null;
+    dbPath: string;
+    activityCounts: Record<string, number>;
+    recentActivity: Array<{
+        requestId: string;
+        role: string;
+    }>;
+    lastRewardClaimTickAt: string | null;
+    rewardClaimIntervalMs: number;
+    fleet: FleetState | null;
+    rpc: {
+        ok: boolean;
+        chainId?: number;
+        blockNumber?: string;
+        error?: string;
+    };
+    master: {
+        address: string | null;
+        balanceWei?: string;
+        error?: string;
+    };
+    pendingStakingRewardsWei?: string;
+    pendingRewardsError?: string;
+    pollIntervalMs: number;
+    /** Resolved daily burn estimate for runway (wei string). */
+    masterDailyEstimateWei: string;
+    minMasterEthWei?: string;
+}
+export interface StatusV1Response {
+    statusMode: 'full' | 'sqlite_only';
+    daemon: {
+        shutdownState: string | null;
+        dbPath: string;
+        timestamp: string;
+    };
+    rpc: GatheredStatusRaw['rpc'];
+    fleet: {
+        loaded: boolean;
+        chain?: string;
+        stakingMode?: string;
+        masterAddress?: string | null;
+        services: Array<{
+            index: number;
+            step: string;
+            serviceId: number | null;
+            safeAddress: string | null;
+            mechAddress: string | null;
+            stakingAddress: string | null;
+        }>;
+        stakedLikeCount: number;
+        completeCount: number;
+    };
+    activity: {
+        counts: Record<string, number>;
+        recent: Array<{
+            requestId: string;
+            role: string;
+        }>;
+    };
+    rewards: {
+        claimLoopIntervalMs: number;
+        lastClaimTickAt: string | null;
+        pendingStakingRewardsWei?: string;
+        pendingRewardsError?: string;
+    };
+    masterGas: {
+        address: string | null;
+        balanceWei?: string;
+        dailyEstimateWei: string;
+        /** Approximate days of excess ETH above minimum at daily estimate (if computable). */
+        runwayDaysExcess?: string;
+        minEthWei?: string;
+        error?: string;
+    };
+    earnings: {
+        hint: string;
+    };
+    nextActions: string[];
+}
+/**
+ * Match bootstrap heuristic for master daily gas when config omits JINN_MASTER_ETH_DAILY_WEI.
+ */
+export declare function resolveMasterDailyEstimateWei(explicit: string | undefined, pollIntervalMs: number): bigint;
+export declare function assembleStatusV1(raw: GatheredStatusRaw): StatusV1Response;

package/dist/api/status-build.js

@@ -0,0 +1,175 @@
+/**
+ * Pure assembly for GET /v1/status JSON (testable without RPC or filesystem).
+ */
+const DEFAULT_MASTER_ETH_DAILY_WEI = 1000000000000000n;
+const STAKED_LIKE_STEPS = new Set([
+    'staked',
+    'mech_deployed',
+    'complete',
+    'service_staked',
+]);
+/**
+ * Match bootstrap heuristic for master daily gas when config omits JINN_MASTER_ETH_DAILY_WEI.
+ */
+export function resolveMasterDailyEstimateWei(explicit, pollIntervalMs) {
+    if (explicit !== undefined && /^\d+$/.test(explicit.trim())) {
+        return BigInt(explicit.trim());
+    }
+    const interval = Math.max(pollIntervalMs, 1000);
+    const pollsPerDay = 86400000 / interval;
+    const txsPerDay = Math.min(Math.ceil(pollsPerDay / 600), 12);
+    const txCostWei = 150000n * 2000000000n;
+    const fromPoll = BigInt(txsPerDay) * txCostWei;
+    return fromPoll > DEFAULT_MASTER_ETH_DAILY_WEI ? fromPoll : DEFAULT_MASTER_ETH_DAILY_WEI;
+}
+function fleetSummary(fleet) {
+    if (!fleet) {
+        return {
+            loaded: false,
+            services: [],
+            stakedLikeCount: 0,
+            completeCount: 0,
+        };
+    }
+    const services = fleet.services.map(s => ({
+        index: s.index,
+        step: s.step,
+        serviceId: s.service_id,
+        safeAddress: s.safe_address,
+        mechAddress: s.mech_address,
+        stakingAddress: s.staking_address,
+    }));
+    const stakedLikeCount = fleet.services.filter(s => STAKED_LIKE_STEPS.has(s.step)).length;
+    const completeCount = fleet.services.filter(s => s.step === 'complete').length;
+    return {
+        loaded: true,
+        chain: fleet.chain,
+        stakingMode: fleet.staking_mode,
+        masterAddress: fleet.master_address,
+        services,
+        stakedLikeCount,
+        completeCount,
+    };
+}
+function computeRunwayDaysExcess(balanceWei, minWei, daily) {
+    if (daily === 0n)
+        return undefined;
+    if (minWei !== undefined) {
+        if (balanceWei <= minWei)
+            return '0';
+        const excess = balanceWei - minWei;
+        if (excess <= 0n)
+            return '0';
+        return (excess / daily).toString();
+    }
+    if (balanceWei <= 0n)
+        return '0';
+    return (balanceWei / daily).toString();
+}
+function buildEarningsHint(raw, fleetSum) {
+    if (raw.hintsScope === 'sqlite_only') {
+        return 'Fleet and on-chain earnings hints omitted in API-only mode.';
+    }
+    if (raw.pendingRewardsError) {
+        return `Could not read pending staking rewards: ${raw.pendingRewardsError}`;
+    }
+    if (raw.pendingStakingRewardsWei !== undefined) {
+        const n = fleetSum.stakedLikeCount;
+        return `Sum of on-chain calculateStakingReward (wei) across eligible services: ${raw.pendingStakingRewardsWei} (${n} staked-like service(s) in local state).`;
+    }
+    if (!fleetSum.loaded || fleetSum.services.length === 0) {
+        return 'No fleet services in local state — earnings accrue after staking completes.';
+    }
+    return 'Pending reward sum not available (no RPC or no staking proxies on services).';
+}
+function buildNextActions(raw, fleetSum) {
+    const actions = [];
+    if (raw.hintsScope === 'sqlite_only') {
+        return [
+            'Full operations status requires daemon start with status context, or run `npm run status` while the daemon is up.',
+        ];
+    }
+    if (!raw.rpc.ok) {
+        actions.push('Restore RPC access (check rpcUrl / network) for live balances and rewards.');
+    }
+    if (!fleetSum.loaded) {
+        actions.push('Run bootstrap (`jinn run` with JINN_PASSWORD) to create fleet and staking state.');
+    }
+    else {
+        if (!raw.fleet?.master_address) {
+            actions.push('Complete earning bootstrap so master_address is recorded.');
+        }
+        for (const s of raw.fleet?.services ?? []) {
+            if (s.step !== 'complete') {
+                actions.push(`Resume service ${s.index}: local step "${s.step}" — re-run jinn run.`);
+            }
+        }
+    }
+    if (raw.master.address && raw.minMasterEthWei && raw.master.balanceWei !== undefined) {
+        const bal = BigInt(raw.master.balanceWei);
+        const min = BigInt(raw.minMasterEthWei);
+        if (bal < min) {
+            actions.push('Fund master EOA with more ETH for gas (below configured minimum).');
+        }
+    }
+    const daily = BigInt(raw.masterDailyEstimateWei);
+    if (daily > 0n &&
+        raw.master.balanceWei !== undefined &&
+        raw.minMasterEthWei !== undefined) {
+        const bal = BigInt(raw.master.balanceWei);
+        const min = BigInt(raw.minMasterEthWei);
+        const excess = bal > min ? bal - min : 0n;
+        const days = excess / daily;
+        if (days < 3n && raw.rpc.ok) {
+            actions.push('Master ETH runway is low — consider topping up the master wallet.');
+        }
+    }
+    if (raw.rewardClaimIntervalMs > 0 && !raw.lastRewardClaimTickAt && fleetSum.stakedLikeCount > 0) {
+        actions.push('Reward claim loop is enabled; last tick time will appear after the first distributor pass.');
+    }
+    const dedup = [...new Set(actions)];
+    if (dedup.length === 0) {
+        dedup.push('No urgent actions — daemon loops and reward claims run on schedule.');
+    }
+    return dedup;
+}
+export function assembleStatusV1(raw) {
+    const fleetSum = fleetSummary(raw.fleet);
+    const mode = raw.hintsScope === 'sqlite_only' ? 'sqlite_only' : 'full';
+    const runway = raw.master.balanceWei !== undefined
+        ? computeRunwayDaysExcess(BigInt(raw.master.balanceWei), raw.minMasterEthWei !== undefined ? BigInt(raw.minMasterEthWei) : undefined, BigInt(raw.masterDailyEstimateWei))
+        : undefined;
+    return {
+        statusMode: mode,
+        daemon: {
+            shutdownState: raw.shutdownState,
+            dbPath: raw.dbPath,
+            timestamp: new Date().toISOString(),
+        },
+        rpc: raw.rpc,
+        fleet: fleetSum,
+        activity: {
+            counts: raw.activityCounts,
+            recent: raw.recentActivity,
+        },
+        rewards: {
+            claimLoopIntervalMs: raw.rewardClaimIntervalMs,
+            lastClaimTickAt: raw.lastRewardClaimTickAt,
+            pendingStakingRewardsWei: raw.pendingStakingRewardsWei,
+            pendingRewardsError: raw.pendingRewardsError,
+        },
+        masterGas: {
+            address: raw.master.address,
+            balanceWei: raw.master.balanceWei,
+            dailyEstimateWei: raw.masterDailyEstimateWei,
+            runwayDaysExcess: raw.master.balanceWei !== undefined && runway !== undefined ? runway : undefined,
+            minEthWei: raw.minMasterEthWei,
+            error: raw.master.error,
+        },
+        earnings: {
+            hint: buildEarningsHint(raw, fleetSum),
+        },
+        nextActions: buildNextActions(raw, fleetSum),
+    };
+}
+//# sourceMappingURL=status-build.js.map

package/dist/api/status-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-build.js","sourceRoot":"","sources":["../../src/api/status-build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,4BAA4B,GAAG,iBAAsB,CAAC;AA6E5D,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,QAAQ;IACR,eAAe;IACf,UAAU;IACV,gBAAgB;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAA4B,EAC5B,cAAsB;IAEtB,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,OAAQ,GAAG,WAAc,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAC/C,OAAO,QAAQ,GAAG,4BAA4B,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,4BAA4B,CAAC;AAC3F,CAAC;AAED,SAAS,YAAY,CAAC,KAAwB;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,EAAE;YACZ,eAAe,EAAE,CAAC;YAClB,aAAa,EAAE,CAAC;SACjB,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,WAAW,EAAE,CAAC,CAAC,YAAY;QAC3B,WAAW,EAAE,CAAC,CAAC,YAAY;QAC3B,cAAc,EAAE,CAAC,CAAC,eAAe;KAClC,CAAC,CAAC,CAAC;IACJ,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACzF,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;IAC/E,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,YAAY;QAC/B,aAAa,EAAE,KAAK,CAAC,cAAc;QACnC,QAAQ;QACR,eAAe;QACf,aAAa;KACd,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,UAAkB,EAClB,MAA0B,EAC1B,KAAa;IAEb,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,UAAU,IAAI,MAAM;YAAE,OAAO,GAAG,CAAC;QACrC,MAAM,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;QACnC,IAAI,MAAM,IAAI,EAAE;YAAE,OAAO,GAAG,CAAC;QAC7B,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IACjC,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAsB,EAAE,QAAmC;IACpF,IAAI,GAAG,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;QACrC,OAAO,6DAA6D,CAAC;IACvE,CAAC;IACD,IAAI,GAAG,CAAC,mBAAmB,EAAE,CAAC;QAC5B,OAAO,2CAA2C,GAAG,CAAC,mBAAmB,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,GAAG,CAAC,wBAAwB,KAAK,SAAS,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC;QACnC,OAAO,0EAA0E,GAAG,CAAC,wBAAwB,KAAK,CAAC,0CAA0C,CAAC;IAChK,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,6EAA6E,CAAC;IACvF,CAAC;IACD,OAAO,8EAA8E,CAAC;AACxF,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAsB,EAAE,QAAmC;IACnF,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,GAAG,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;QACrC,OAAO;YACL,mHAAmH;SACpH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;IACnG,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,IAAI,sBAAsB,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrF,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACxC,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACjD,IACE,KAAK,GAAG,EAAE;QACV,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS;QACnC,GAAG,CAAC,eAAe,KAAK,SAAS,EACjC,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC;QAC5B,IAAI,IAAI,GAAG,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,qBAAqB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,QAAQ,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QAChG,OAAO,CAAC,IAAI,CAAC,4FAA4F,CAAC,CAAC;IAC7G,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAsB;IACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,IAAI,GAA2B,GAAG,CAAC,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/F,MAAM,MAAM,GACV,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS;QACjC,CAAC,CAAC,uBAAuB,CACrB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAC7B,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,EAC3E,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CACnC;QACH,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE;YACN,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;QACD,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACR,MAAM,EAAE,GAAG,CAAC,cAAc;YAC1B,MAAM,EAAE,GAAG,CAAC,cAAc;SAC3B;QACD,OAAO,EAAE;YACP,mBAAmB,EAAE,GAAG,CAAC,qBAAqB;YAC9C,eAAe,EAAE,GAAG,CAAC,qBAAqB;YAC1C,wBAAwB,EAAE,GAAG,CAAC,wBAAwB;YACtD,mBAAmB,EAAE,GAAG,CAAC,mBAAmB;SAC7C;QACD,SAAS,EAAE;YACT,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO;YAC3B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU;YACjC,gBAAgB,EAAE,GAAG,CAAC,sBAAsB;YAC5C,gBAAgB,EACd,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAClF,SAAS,EAAE,GAAG,CAAC,eAAe;YAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK;SACxB;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC;SACvC;QACD,WAAW,EAAE,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/api/status-rollup-build.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Slim `jinn status` roll-up from GatheredStatusRaw.
+ *
+ * Contract: spec/2026-04-14-client-surface.md §4.1.
+ */
+import type { GatheredStatusRaw } from './status-build.js';
+export interface StatusRollupV1Response {
+    schemaVersion: 1;
+    generatedAt: string;
+    daemon: {
+        state: 'running' | 'stopped' | 'starting';
+        startedAt: string | null;
+        phase: string;
+        network: 'testnet' | 'mainnet';
+    };
+    rpc: {
+        ok: boolean;
+        chainId: number;
+        blockNumber: number;
+        error?: string;
+    };
+    fleet: {
+        size: number;
+        complete: number;
+        needsAttention: number;
+    };
+    earnings: {
+        pendingTotal: string;
+        asset: 'reward';
+    };
+    exit: {
+        blocking: boolean;
+        hint: string | null;
+    };
+}
+export declare function assembleStatusRollupV1(raw: GatheredStatusRaw): StatusRollupV1Response;

package/dist/api/status-rollup-build.js

@@ -0,0 +1,69 @@
+/**
+ * Slim `jinn status` roll-up from GatheredStatusRaw.
+ *
+ * Contract: spec/2026-04-14-client-surface.md §4.1.
+ */
+function daemonState(shutdown) {
+    if (shutdown === 'running')
+        return 'running';
+    return 'stopped';
+}
+function buildExitRollup(raw, needsAttention) {
+    if (!raw.rpc.ok) {
+        return { blocking: true, hint: raw.rpc.error ?? 'RPC unhealthy.' };
+    }
+    if (needsAttention > 0) {
+        return { blocking: true, hint: 'Run `jinn fleet` for per-service detail.' };
+    }
+    if (raw.minMasterEthWei && raw.master.balanceWei) {
+        try {
+            if (BigInt(raw.master.balanceWei) < BigInt(raw.minMasterEthWei)) {
+                return {
+                    blocking: true,
+                    hint: 'Master ETH is below the configured minimum runway threshold.',
+                };
+            }
+        }
+        catch {
+            /* ignore parse errors */
+        }
+    }
+    return { blocking: false, hint: null };
+}
+export function assembleStatusRollupV1(raw) {
+    const services = raw.fleet?.services ?? [];
+    const complete = services.filter(s => s.step === 'complete').length;
+    const needsAttention = services.length - complete;
+    const network = raw.fleet?.chain === 'base' ? 'mainnet' : 'testnet';
+    const phase = network === 'testnet' ? 'phase-1b' : 'phase-2';
+    const blockStr = raw.rpc.blockNumber ?? '0';
+    const blockNumber = Number(blockStr);
+    const exit = buildExitRollup(raw, needsAttention);
+    return {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        daemon: {
+            state: daemonState(raw.shutdownState),
+            startedAt: null,
+            phase,
+            network,
+        },
+        rpc: {
+            ok: raw.rpc.ok,
+            chainId: raw.rpc.chainId ?? 0,
+            blockNumber: Number.isFinite(blockNumber) ? blockNumber : 0,
+            ...(raw.rpc.error ? { error: raw.rpc.error } : {}),
+        },
+        fleet: {
+            size: services.length,
+            complete,
+            needsAttention,
+        },
+        earnings: {
+            pendingTotal: raw.pendingStakingRewardsWei ?? '0',
+            asset: 'reward',
+        },
+        exit,
+    };
+}
+//# sourceMappingURL=status-rollup-build.js.map

package/dist/api/status-rollup-build.js.map

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

package/dist/auth/erc8128.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ERC-8128 HTTP Message Signatures for jinn-client.
+ *
+ * Ported from jinn-gemini-3/packages/crypto/src/erc8128.ts.
+ * Uses @slicekit/erc8128 (RFC 9421 + Ethereum signatures).
+ *
+ * Usage:
+ *   const signer = createPrivateKeyHttpSigner(privateKey, 8453);
+ *   const signed = await signRequestWithErc8128({ signer, input: url, init: { method: 'POST', body } });
+ *   // signed Request has signature, signature-input, content-digest headers
+ *
+ *   const result = await verifyRequestWithErc8128({ request: signed, nonceStore });
+ *   // result.address is the verified signer
+ */
+import { type EthHttpSigner, type NonceStore, type VerifyMessageFn, type VerifyResult, type VerifyPolicy, type SignOptions } from '@slicekit/erc8128';
+type Hex = `0x${string}`;
+/**
+ * In-memory nonce store with TTL-based expiration.
+ * Tracks seen nonces and garbage-collects expired entries on access.
+ */
+export declare class InMemoryNonceStore implements NonceStore {
+    private seen;
+    consume(key: string, ttlSeconds: number): Promise<boolean>;
+    private gc;
+}
+/**
+ * Verify an ERC-191 personal_sign message using viem.
+ * Matches the VerifyMessageFn shape expected by @slicekit/erc8128.
+ */
+export declare const ethVerifyMessage: VerifyMessageFn;
+export declare function createPrivateKeyHttpSigner(privateKey: Hex, chainId: number): EthHttpSigner;
+export declare function signRequestWithErc8128(args: {
+    signer: EthHttpSigner;
+    input: RequestInfo;
+    init?: RequestInit;
+    signOptions?: SignOptions;
+}): Promise<Request>;
+export declare function verifyRequestWithErc8128(args: {
+    request: Request;
+    nonceStore: NonceStore;
+    policy?: Partial<VerifyPolicy>;
+}): Promise<VerifyResult>;
+export type { EthHttpSigner, NonceStore, VerifyResult, VerifyPolicy, SignOptions, };

package/dist/auth/erc8128.js

@@ -0,0 +1,88 @@
+/**
+ * ERC-8128 HTTP Message Signatures for jinn-client.
+ *
+ * Ported from jinn-gemini-3/packages/crypto/src/erc8128.ts.
+ * Uses @slicekit/erc8128 (RFC 9421 + Ethereum signatures).
+ *
+ * Usage:
+ *   const signer = createPrivateKeyHttpSigner(privateKey, 8453);
+ *   const signed = await signRequestWithErc8128({ signer, input: url, init: { method: 'POST', body } });
+ *   // signed Request has signature, signature-input, content-digest headers
+ *
+ *   const result = await verifyRequestWithErc8128({ request: signed, nonceStore });
+ *   // result.address is the verified signer
+ */
+import { signRequest, verifyRequest as erc8128VerifyRequest, } from '@slicekit/erc8128';
+import { privateKeyToAccount } from 'viem/accounts';
+import { verifyMessage } from 'viem';
+// ── Nonce store ──────────────────────────────────────────────────────────────
+/**
+ * In-memory nonce store with TTL-based expiration.
+ * Tracks seen nonces and garbage-collects expired entries on access.
+ */
+export class InMemoryNonceStore {
+    seen = new Map();
+    async consume(key, ttlSeconds) {
+        this.gc();
+        if (this.seen.has(key))
+            return false;
+        this.seen.set(key, Date.now() + ttlSeconds * 1000);
+        return true;
+    }
+    gc() {
+        const now = Date.now();
+        for (const [key, expiresAt] of this.seen) {
+            if (expiresAt <= now) {
+                this.seen.delete(key);
+            }
+        }
+    }
+}
+// ── Verification helper ──────────────────────────────────────────────────────
+/**
+ * Verify an ERC-191 personal_sign message using viem.
+ * Matches the VerifyMessageFn shape expected by @slicekit/erc8128.
+ */
+export const ethVerifyMessage = async (args) => {
+    try {
+        return await verifyMessage({
+            address: args.address,
+            message: { raw: args.message.raw },
+            signature: args.signature,
+        });
+    }
+    catch {
+        return false;
+    }
+};
+// ── Signer construction ─────────────────────────────────────────────────────
+export function createPrivateKeyHttpSigner(privateKey, chainId) {
+    const account = privateKeyToAccount(privateKey);
+    return {
+        address: account.address,
+        chainId,
+        signMessage: (msg) => account.signMessage({ message: { raw: msg } }),
+    };
+}
+// ── Request signing & verification ───────────────────────────────────────────
+export async function signRequestWithErc8128(args) {
+    return signRequest(args.input, args.init, args.signer, {
+        binding: 'request-bound',
+        replay: 'non-replayable',
+        ttlSeconds: 60,
+        ...(args.signOptions ?? {}),
+    });
+}
+export async function verifyRequestWithErc8128(args) {
+    return erc8128VerifyRequest({
+        request: args.request,
+        verifyMessage: ethVerifyMessage,
+        nonceStore: args.nonceStore,
+        policy: {
+            maxValiditySec: 300,
+            clockSkewSec: 5,
+            ...args.policy,
+        },
+    });
+}
+//# sourceMappingURL=erc8128.js.map

package/dist/auth/erc8128.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc8128.js","sourceRoot":"","sources":["../../src/auth/erc8128.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,IAAI,oBAAoB,GAOtC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAIrC,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACrB,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,UAAkB;QAC3C,IAAI,CAAC,EAAE,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,EAAE;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoB,KAAK,EAAE,IAAI,EAAE,EAAE;IAC9D,IAAI,CAAC;QACH,OAAO,MAAM,aAAa,CAAC;YACzB,OAAO,EAAE,IAAI,CAAC,OAAc;YAC5B,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAU,EAAE;YACzC,SAAS,EAAE,IAAI,CAAC,SAAgB;SACjC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,+EAA+E;AAE/E,MAAM,UAAU,0BAA0B,CAAC,UAAe,EAAE,OAAe;IACzE,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAChD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAc;QAC/B,OAAO;QACP,WAAW,EAAE,CAAC,GAAe,EAAE,EAAE,CAC/B,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAK5C;IACC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;QACrD,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,gBAAgB;QACxB,UAAU,EAAE,EAAE;QACd,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAI9C;IACC,OAAO,oBAAoB,CAAC;QAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,aAAa,EAAE,gBAAgB;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE;YACN,cAAc,EAAE,GAAG;YACnB,YAAY,EAAE,CAAC;YACf,GAAG,IAAI,CAAC,MAAM;SACf;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/bin/jinn.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * jinn CLI entry. Delegates to cli/index.ts.
+ *
+ * This file lives under src/bin/ so that `tsc` compiles it to dist/bin/jinn.js.
+ * The package.json `bin` field points at the compiled output, making `jinn`
+ * available on PATH when the package is installed globally.
+ *
+ * Contract: spec/2026-04-14-client-surface.md
+ */
+export {};

package/dist/bin/jinn.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * jinn CLI entry. Delegates to cli/index.ts.
+ *
+ * This file lives under src/bin/ so that `tsc` compiles it to dist/bin/jinn.js.
+ * The package.json `bin` field points at the compiled output, making `jinn`
+ * available on PATH when the package is installed globally.
+ *
+ * Contract: spec/2026-04-14-client-surface.md
+ */
+import { runCli } from '../cli/index.js';
+runCli(process.argv.slice(2)).catch((err) => {
+    // Top-level safety net. runCli is expected to catch its own errors
+    // and emit an envelope, so reaching here is itself a defect.
+    // Log to stderr; the envelope contract requires stdout.
+    console.error('[jinn] internal error: runCli threw instead of emitting an envelope');
+    console.error(err);
+    process.exit(50);
+});
+//# sourceMappingURL=jinn.js.map

package/dist/bin/jinn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jinn.js","sourceRoot":"","sources":["../../src/bin/jinn.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC1C,mEAAmE;IACnE,6DAA6D;IAC7D,wDAAwD;IACxD,OAAO,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACrF,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnB,CAAC,CAAC,CAAC"}

package/dist/build-meta.json

@@ -0,0 +1,3 @@
+{
+  "commit": "adfd078d44be1de409f2f0cdd06c35274866a400"
+}

package/dist/chain-read-errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Classify ethers/json-rpc read failures so bootstrap reconciliation does not
+ * treat flaky RPC as "service missing on-chain".
+ */
+/**
+ * True when a static call / eth_call likely failed due to transport/RPC, not an
+ * authoritative on-chain revert. In this case fleet reconcile must not clear state.
+ */
+export declare function isTransientEthReadError(error: unknown): boolean;

package/dist/chain-read-errors.js

@@ -0,0 +1,43 @@
+/**
+ * Classify ethers/json-rpc read failures so bootstrap reconciliation does not
+ * treat flaky RPC as "service missing on-chain".
+ */
+import { flattenErrorMessage } from './tx-retry.js';
+/**
+ * True when a static call / eth_call likely failed due to transport/RPC, not an
+ * authoritative on-chain revert. In this case fleet reconcile must not clear state.
+ */
+export function isTransientEthReadError(error) {
+    const err = error;
+    if (err?.code === 'SERVER_ERROR' || err?.code === 'TIMEOUT' || err?.code === 'NETWORK_ERROR') {
+        return true;
+    }
+    const msg = flattenErrorMessage(error).toLowerCase();
+    if (msg.includes('429') || msg.includes('rate limit') || msg.includes('too many requests')) {
+        return true;
+    }
+    if (msg.includes('-32603') ||
+        msg.includes('internal json-rpc error') ||
+        msg.includes('-32005') ||
+        msg.includes('request timed out') ||
+        msg.includes('timeout')) {
+        return true;
+    }
+    if (msg.includes('econnreset') ||
+        msg.includes('etimedout') ||
+        msg.includes('socket hang up') ||
+        msg.includes('fetch failed') ||
+        msg.includes('network error') ||
+        msg.includes('connection refused') ||
+        msg.includes('connect timeout')) {
+        return true;
+    }
+    if (msg.includes('bad gateway') ||
+        msg.includes('service unavailable') ||
+        msg.includes('502') ||
+        msg.includes('503')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=chain-read-errors.js.map

package/dist/chain-read-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-read-errors.js","sourceRoot":"","sources":["../src/chain-read-errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,GAAG,GAAG,KAA0B,CAAC;IACvC,IAAI,GAAG,EAAE,IAAI,KAAK,cAAc,IAAI,GAAG,EAAE,IAAI,KAAK,SAAS,IAAI,GAAG,EAAE,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAErD,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC3F,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACtB,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACvC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACtB,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACjC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EACvB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC1B,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;QACzB,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC9B,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC5B,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC7B,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAClC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACnC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EACnB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/action.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared helpers for action verbs (verbs that emit transactions).
+ *
+ * Contract: spec/2026-04-14-client-surface.md §7.3 (dry-run / yes).
+ */
+import type { CommandContext } from './command.js';
+export interface ConfirmFlags {
+    yes: boolean;
+    dryRun: boolean;
+}
+/**
+ * Ensure an action is confirmed before proceeding.
+ *
+ * - Dry run → always permitted, returns true without any check.
+ * - `--yes` → permitted regardless of TTY state.
+ * - Non-TTY without `--yes` → emits invalid_invocation (exit 11) and returns false.
+ * - TTY without `--yes` → v1 never prompts; emits invalid_invocation and returns false.
+ */
+export declare function ensureConfirmed(ctx: CommandContext, flags: ConfirmFlags): boolean;
+export interface DryRunPayload {
+    verb: string;
+    description: string;
+    plan: unknown[];
+}
+/** Emit a dry-run JSON response (success path; no process exit). */
+export declare function emitDryRun(ctx: CommandContext, payload: DryRunPayload): void;