@jinn-network/client 0.1.0-canary.adfd078d

package/dist/cli/commands/withdraw.js

@@ -0,0 +1,181 @@
+import { emitResult } from '../output.js';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { ensureConfirmed, emitDryRun } from '../action.js';
+import { gatherIntrospectionRaw } from '../introspection-context.js';
+import { resolveCliPassword } from '../password.js';
+import { loadConfig, getConfigPathFromArgs } from '../../config.js';
+import { parseWithdrawArgv, validateWithdrawArgs, } from '../../withdraw/args.js';
+import { computeSweepWouldSend, runWithdrawPlan, withdrawNeedsInteractiveConfirm, } from '../../withdraw/run-withdraw-plan.js';
+import { decryptMnemonic } from '../../earning/wallet.js';
+import { FleetStateStore } from '../../earning/store.js';
+import { createJinnPublicClient } from '../../earning/viem-clients.js';
+function displayServiceIndex(chainIndex) {
+    return Math.max(0, chainIndex - 1);
+}
+async function run(ctx) {
+    let parsed;
+    try {
+        parsed = parseWithdrawArgv(ctx.argv);
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: err instanceof Error ? err.message : String(err),
+            exampleCli: 'jinn withdraw --to 0xDEST --dry-run',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    if (parsed.help) {
+        ctx.writer.write(`See \`jinn withdraw --help\` in the command module helpText, or \`jinn withdraw --human\` for the readable terminal form.\n`);
+        return;
+    }
+    try {
+        validateWithdrawArgs(parsed);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const details = message.includes('--to') && message.includes('required')
+            ? { field: '--to', expected: 'Ethereum address' }
+            : { field: 'flags', expected: message };
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message,
+            exampleCli: 'jinn withdraw --to 0xDEST --drain-eth --yes',
+            details,
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const raw = await gatherIntrospectionRaw({ argv: ctx.argv });
+    const sweep = [];
+    const masterAddr = raw.fleet?.master_address ?? raw.master.address;
+    if (masterAddr) {
+        sweep.push({
+            from: masterAddr,
+            role: 'master',
+            asset: 'native',
+            amountWei: raw.master.balanceWei ?? '0',
+        });
+    }
+    for (const svc of raw.fleet?.services ?? []) {
+        const di = displayServiceIndex(svc.index);
+        if (svc.agent_address) {
+            sweep.push({
+                from: svc.agent_address,
+                role: `service.${di}.agent`,
+                asset: 'native',
+                amountWei: '0',
+            });
+        }
+        if (svc.safe_address) {
+            sweep.push({
+                from: svc.safe_address,
+                role: `service.${di}.multisig`,
+                asset: 'native',
+                amountWei: '0',
+            });
+        }
+    }
+    const dryRun = parsed.dryRun;
+    const yes = parsed.yes;
+    if (dryRun) {
+        emitDryRun(ctx, {
+            verb: 'withdraw',
+            description: `Would run withdraw plan (${sweep.length} wallet hint rows) to ${parsed.to}`,
+            plan: sweep.map(s => ({ ...s, to: parsed.to })),
+        });
+        return;
+    }
+    if (!ensureConfirmed(ctx, { yes, dryRun: false }))
+        return;
+    const pw = resolveCliPassword(ctx.argv, ctx.env);
+    if (!pw.ok) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: pw.message,
+            exampleCli: 'jinn withdraw --to 0xDEST --yes',
+            details: { field: 'keystore password' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const configPath = getConfigPathFromArgs(ctx.argv ?? []) ?? getConfigPathFromArgs(process.argv.slice(2));
+    const config = loadConfig(configPath);
+    const networkChain = config.network === 'testnet' ? 'base-sepolia' : 'base';
+    const publicClient = createJinnPublicClient(config.rpcUrl, networkChain);
+    const store = new FleetStateStore(config.earningDir);
+    let sweepWouldSend = false;
+    try {
+        const mnemonic = await decryptMnemonic(await store.loadMnemonicKeystore(), pw.password);
+        const fleet = await store.tryLoadExisting();
+        const to = parsed.to;
+        sweepWouldSend = await computeSweepWouldSend(publicClient, mnemonic, fleet, to, parsed.minSweepWei);
+    }
+    catch {
+        // best-effort; withdraw will surface decrypt errors
+    }
+    if (withdrawNeedsInteractiveConfirm(parsed, { sweepWouldSend }) && !parsed.yes) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: 'Large or drain-style withdraw requires explicit --yes (non-interactive CLI has no confirmation prompt).',
+            exampleCli: 'jinn withdraw --to 0xDEST --drain-eth --yes',
+            details: { field: 'confirmation' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    try {
+        await runWithdrawPlan({
+            password: pw.password,
+            config,
+            parsed,
+            log: () => { },
+            warn: (s) => {
+                process.stderr.write(s + '\n');
+            },
+        });
+        emitResult({
+            schemaVersion: 1,
+            generatedAt: new Date().toISOString(),
+            verb: 'withdraw',
+            to: parsed.to,
+            dryRun: false,
+            status: 'complete',
+        }, (v) => {
+            const value = v;
+            return `Withdraw plan complete.\nDestination: ${value.to}`;
+        }, {
+            json: parsed.json,
+            human: parsed.human,
+            writer: ctx.writer,
+            stdoutIsTty: ctx.stdoutIsTty,
+            noColor: Boolean(ctx.env['NO_COLOR']),
+        });
+    }
+    catch (e) {
+        emitEnvelope({
+            code: 'fatal',
+            message: e instanceof Error ? e.message : String(e),
+            details: { cause: e instanceof Error ? e.message : String(e) },
+        }, { writer: ctx.writer, exit: ctx.exit });
+    }
+}
+const command = {
+    name: 'withdraw',
+    summary: 'Sweep master / agents per withdraw flags',
+    helpText: `Usage: jinn withdraw --to <address> [amount flags] [--dry-run | --yes] [--human]
+
+Supports the same amount flags as the standalone withdraw helper:
+  --jinn-amount / --amount / --jinn-wei / --drain-jinn
+  --eth-amount / --eth-wei / --drain-eth
+  --sweep-agents / --min-sweep-wei / --master-gas-reserve-wei
+  --password-fd N
+
+Large or drain operations require --yes (no TTY prompt).
+
+Examples:
+  jinn withdraw --to 0xDEST --dry-run
+  jinn withdraw --to 0xDEST --eth-amount 0.01 --yes
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=withdraw.js.map

package/dist/cli/commands/withdraw.js.map

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

package/dist/cli/deployment-digest.d.ts

@@ -0,0 +1,10 @@
+import type { JinnConfig } from '../config.js';
+export interface DeploymentArtifactRow {
+    name: string;
+    path: string;
+    sha256: string;
+}
+export declare function computeDeploymentDigest(config: JinnConfig): {
+    digest: string;
+    artifacts: DeploymentArtifactRow[];
+};

package/dist/cli/deployment-digest.js

@@ -0,0 +1,25 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+export function computeDeploymentDigest(config) {
+    const candidates = [
+        { name: 'testnetL2', path: config.testnetL2DeploymentPath },
+        { name: 'testnetL2Token', path: config.testnetL2TokenDeploymentPath },
+        { name: 'testnetMech', path: config.testnetMechDeploymentPath },
+        { name: 'testnetStolas', path: config.testnetStolasDeploymentPath },
+    ];
+    const artifacts = [];
+    const pieces = [];
+    for (const { name, path } of candidates) {
+        if (!path || !existsSync(path))
+            continue;
+        const raw = readFileSync(path, 'utf8');
+        const sha256 = createHash('sha256').update(raw).digest('hex');
+        artifacts.push({ name, path, sha256 });
+        pieces.push(`${name}:${sha256}`);
+    }
+    const digest = pieces.length > 0
+        ? createHash('sha256').update([...pieces].sort().join('|')).digest('hex')
+        : 'unknown';
+    return { digest, artifacts };
+}
+//# sourceMappingURL=deployment-digest.js.map

package/dist/cli/deployment-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-digest.js","sourceRoot":"","sources":["../../src/cli/deployment-digest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AASnD,MAAM,UAAU,uBAAuB,CAAC,MAAkB;IAIxD,MAAM,UAAU,GAAsD;QACpE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,uBAAuB,EAAE;QAC3D,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,4BAA4B,EAAE;QACrE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,yBAAyB,EAAE;QAC/D,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,2BAA2B,EAAE;KACpE,CAAC;IAEF,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACzC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9D,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC"}

package/dist/cli/execution-context.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Shared stack for jinn CLI verbs that need config + keystore + chain + signers (+ optional MechAdapter).
+ * Mirrors {@link ../main.ts} bootstrap assumptions.
+ */
+import type { PublicClient } from 'viem';
+import type { WalletClient } from 'viem';
+import { type JinnConfig } from '../config.js';
+import { type ChainConfig } from '../earning/contracts.js';
+import { FleetStateStore } from '../earning/store.js';
+import type { FleetState, ServiceState } from '../earning/types.js';
+import { MechAdapter } from '../adapters/mech/adapter.js';
+import { Store } from '../store/store.js';
+import type { BuildEnvelopeInput } from '../errors/envelope.js';
+export type NetworkChain = 'base' | 'base-sepolia';
+export interface CliSignerContext {
+    config: JinnConfig;
+    networkChain: NetworkChain;
+    chainConfig: ChainConfig;
+    fleetStore: FleetStateStore;
+    mnemonic: string;
+    fleetState: FleetState;
+    publicClient: PublicClient;
+    masterWallet: WalletClient;
+}
+export interface CliExecutionContext extends CliSignerContext {
+    jinnStore: Store;
+    /** First complete service with Safe + mech (daemon / creator semantics). */
+    primaryService: ServiceState;
+    adapter: MechAdapter;
+}
+export declare function pickPrimaryMechService(services: ServiceState[]): ServiceState | undefined;
+export type CreateCliExecutionContextOptions = {
+    argv?: string[];
+    env?: NodeJS.ProcessEnv;
+};
+/** Password + config + mnemonic + master signer + fleet JSON (no MechAdapter). */
+export declare function createCliSignerContext(opts?: CreateCliExecutionContextOptions): Promise<{
+    ok: true;
+    ctx: CliSignerContext;
+} | {
+    ok: false;
+    envelope: BuildEnvelopeInput;
+}>;
+export declare function createCliExecutionContext(opts?: CreateCliExecutionContextOptions): Promise<{
+    ok: true;
+    ctx: CliExecutionContext;
+} | {
+    ok: false;
+    envelope: BuildEnvelopeInput;
+}>;

package/dist/cli/execution-context.js

@@ -0,0 +1,154 @@
+/**
+ * Shared stack for jinn CLI verbs that need config + keystore + chain + signers (+ optional MechAdapter).
+ * Mirrors {@link ../main.ts} bootstrap assumptions.
+ */
+import { loadConfig, getConfigPathFromArgs } from '../config.js';
+import { getChainConfig } from '../earning/contracts.js';
+import { FleetStateStore } from '../earning/store.js';
+import { decryptMnemonic, deriveMasterSigner, walletPrivateKeyAtIndex } from '../earning/wallet.js';
+import { createJinnPublicClient, createJinnWalletClient } from '../earning/viem-clients.js';
+import { MechAdapter } from '../adapters/mech/adapter.js';
+import { Store } from '../store/store.js';
+import { resolveCliPassword } from './password.js';
+function mergeArgvForConfig(argv) {
+    return getConfigPathFromArgs(argv ?? []) ?? getConfigPathFromArgs(process.argv.slice(2));
+}
+export function pickPrimaryMechService(services) {
+    return services.find(s => s.step === 'complete' && s.safe_address && s.mech_address);
+}
+async function buildCliSignerContext(opts) {
+    const env = opts.env ?? process.env;
+    const pw = resolveCliPassword(opts.argv, env);
+    if (!pw.ok) {
+        return {
+            ok: false,
+            envelope: {
+                code: 'invalid_invocation',
+                message: pw.message,
+                hint: 'Use JINN_PASSWORD or --password-fd N.',
+                exampleCli: 'jinn submit-intent --id x --description "…" --yes',
+                details: { field: 'keystore password' },
+            },
+        };
+    }
+    const config = loadConfig(mergeArgvForConfig(opts.argv));
+    const networkChain = config.network === 'testnet' ? 'base-sepolia' : 'base';
+    const chainConfig = getChainConfig(networkChain, {
+        testnetL2DeploymentPath: config.testnetL2DeploymentPath,
+        testnetL2TokenDeploymentPath: config.testnetL2TokenDeploymentPath,
+        testnetMechDeploymentPath: config.testnetMechDeploymentPath,
+        testnetStolasDeploymentPath: config.testnetStolasDeploymentPath,
+    });
+    const fleetStore = new FleetStateStore(config.earningDir);
+    if (!fleetStore.hasMnemonicKeystore()) {
+        return {
+            ok: false,
+            envelope: {
+                code: 'bootstrap_incomplete',
+                message: 'No mnemonic keystore found for this earning directory.',
+                hint: 'Run `jinn bootstrap` once to generate the fleet wallet.',
+                exampleCli: 'jinn bootstrap --json',
+                details: { field: 'master_keystore.json' },
+            },
+        };
+    }
+    let mnemonic;
+    try {
+        mnemonic = await decryptMnemonic(await fleetStore.loadMnemonicKeystore(), pw.password);
+    }
+    catch (e) {
+        const cause = e instanceof Error ? e.message : String(e);
+        return {
+            ok: false,
+            envelope: {
+                code: 'invalid_invocation',
+                message: 'Failed to decrypt the mnemonic keystore (wrong password?).',
+                details: { field: 'JINN_PASSWORD', cause },
+            },
+        };
+    }
+    const fleetState = await fleetStore.load(networkChain);
+    const publicClient = createJinnPublicClient(config.rpcUrl, networkChain);
+    const masterAccount = deriveMasterSigner(mnemonic);
+    const masterWallet = createJinnWalletClient(config.rpcUrl, networkChain, masterAccount);
+    return {
+        ok: true,
+        ctx: {
+            config,
+            networkChain,
+            chainConfig,
+            fleetStore,
+            mnemonic,
+            fleetState,
+            publicClient,
+            masterWallet,
+        },
+    };
+}
+/** Password + config + mnemonic + master signer + fleet JSON (no MechAdapter). */
+export async function createCliSignerContext(opts = {}) {
+    return buildCliSignerContext(opts);
+}
+export async function createCliExecutionContext(opts = {}) {
+    const base = await buildCliSignerContext(opts);
+    if (!base.ok)
+        return base;
+    const { config, chainConfig, mnemonic, fleetState, publicClient, masterWallet } = base.ctx;
+    const primaryService = pickPrimaryMechService(fleetState.services);
+    if (!primaryService?.safe_address || !primaryService.mech_address) {
+        return {
+            ok: false,
+            envelope: {
+                code: 'bootstrap_incomplete',
+                message: 'No fleet service is complete with both a Safe and a mech address.',
+                hint: 'Finish bootstrap through mech deployment, or configure testnet mech artifacts.',
+                exampleCli: 'jinn bootstrap --json',
+                details: { field: 'fleet' },
+            },
+        };
+    }
+    const jinnStore = new Store(config.dbPath);
+    const agentEoaPrivateKey = walletPrivateKeyAtIndex(mnemonic, primaryService.index);
+    const marketplaceAddress = chainConfig.mechMarketplace;
+    const routerAddress = (chainConfig.jinnRouter ??
+        '0xfFa7118A3D820cd4E820010837D65FAfF463181B');
+    const adapter = new MechAdapter({
+        rpcUrl: config.rpcUrl,
+        mechMarketplaceAddress: marketplaceAddress,
+        routerAddress,
+        mechContractAddress: primaryService.mech_address,
+        safeAddress: primaryService.safe_address,
+        agentEoaPrivateKey: agentEoaPrivateKey,
+        ipfsRegistryUrl: config.ipfsRegistryUrl,
+        ipfsGatewayUrl: config.ipfsGatewayUrl,
+        pollIntervalMs: config.pollIntervalMs,
+        chainId: config.network === 'testnet' ? 84532 : 8453,
+        routerClaimDeliveryVariant: chainConfig.routerClaimDeliveryVersion,
+    }, jinnStore);
+    try {
+        await adapter.initialize();
+    }
+    catch (e) {
+        const cause = e instanceof Error ? e.message : String(e);
+        return {
+            ok: false,
+            envelope: {
+                code: 'transient_error',
+                message: `Mech adapter initialization failed (RPC or network): ${cause}`,
+                hint: 'Retry after the RPC endpoint is healthy.',
+                exampleCli: 'jinn submit-intent --id x --description "…" --dry-run',
+                details: { cause },
+            },
+        };
+    }
+    return {
+        ok: true,
+        ctx: {
+            ...base.ctx,
+            jinnStore,
+            primaryService,
+            adapter,
+        },
+    };
+}
+//# sourceMappingURL=execution-context.js.map

package/dist/cli/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/cli/execution-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAmB,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,cAAc,EAAoB,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAsBnD,SAAS,kBAAkB,CAAC,IAAe;IACzC,OAAO,qBAAqB,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAwB;IAC7D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC;AACvF,CAAC;AAOD,KAAK,UAAU,qBAAqB,CAClC,IAAsC;IAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACX,OAAO;YACL,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE;gBACR,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,IAAI,EAAE,uCAAuC;gBAC7C,UAAU,EAAE,mDAAmD;gBAC/D,OAAO,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE;aACxC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,YAAY,GAAiB,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1F,MAAM,WAAW,GAAG,cAAc,CAAC,YAAY,EAAE;QAC/C,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;QACvD,4BAA4B,EAAE,MAAM,CAAC,4BAA4B;QACjE,yBAAyB,EAAE,MAAM,CAAC,yBAAyB;QAC3D,2BAA2B,EAAE,MAAM,CAAC,2BAA2B;KAChE,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,mBAAmB,EAAE,EAAE,CAAC;QACtC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE;gBACR,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE,wDAAwD;gBACjE,IAAI,EAAE,yDAAyD;gBAC/D,UAAU,EAAE,uBAAuB;gBACnC,OAAO,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE;aAC3C;SACF,CAAC;IACJ,CAAC;IAED,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,eAAe,CAAC,MAAM,UAAU,CAAC,oBAAoB,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;IACzF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE;gBACR,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,4DAA4D;gBACrE,OAAO,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;aAC3C;SACF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IAExF,OAAO;QACL,EAAE,EAAE,IAAI;QACR,GAAG,EAAE;YACH,MAAM;YACN,YAAY;YACZ,WAAW;YACX,UAAU;YACV,QAAQ;YACR,UAAU;YACV,YAAY;YACZ,YAAY;SACb;KACF,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAyC,EAAE;IAE3C,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAyC,EAAE;IAE3C,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;IAE3F,MAAM,cAAc,GAAG,sBAAsB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,CAAC,cAAc,EAAE,YAAY,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QAClE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE;gBACR,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE,mEAAmE;gBAC5E,IAAI,EAAE,gFAAgF;gBACtF,UAAU,EAAE,uBAAuB;gBACnC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;aAC5B;SACF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IACnF,MAAM,kBAAkB,GAAG,WAAW,CAAC,eAAgC,CAAC;IACxE,MAAM,aAAa,GAAG,CAAC,WAAW,CAAC,UAAU;QAC3C,4CAA4C,CAAkB,CAAC;IAEjE,MAAM,OAAO,GAAG,IAAI,WAAW,CAC7B;QACE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,sBAAsB,EAAE,kBAAkB;QAC1C,aAAa;QACb,mBAAmB,EAAE,cAAc,CAAC,YAA6B;QACjE,WAAW,EAAE,cAAc,CAAC,YAA6B;QACzD,kBAAkB,EAAE,kBAAmC;QACvD,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACpD,0BAA0B,EAAE,WAAW,CAAC,0BAAyC;KAClF,EACD,SAAS,CACV,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE;gBACR,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,wDAAwD,KAAK,EAAE;gBACxE,IAAI,EAAE,0CAA0C;gBAChD,UAAU,EAAE,uDAAuD;gBACnE,OAAO,EAAE,EAAE,KAAK,EAAE;aACnB;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,GAAG,EAAE;YACH,GAAG,IAAI,CAAC,GAAG;YACX,SAAS;YACT,cAAc;YACd,OAAO;SACR;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandModule } from './command.js';
+export declare function renderTopLevelHelp(commands: CommandModule[]): string;
+export declare function renderCommandHelp(command: CommandModule): string;

package/dist/cli/help.js

@@ -0,0 +1,37 @@
+export function renderTopLevelHelp(commands) {
+    const lines = [];
+    lines.push('Usage: jinn <verb> [flags...]');
+    lines.push('');
+    lines.push('Output: operational verbs emit JSON on stdout by default.');
+    lines.push('Use `--human` for readable terminal output. Help stays human-readable.');
+    lines.push('');
+    lines.push('Verbs:');
+    const visible = commands.filter(c => c.name !== 'fleet-manage');
+    const invocations = visible.map(c => `jinn ${c.name}`);
+    const maxInvocationLen = invocations.length > 0 ? Math.max(...invocations.map(s => s.length)) : 1;
+    for (const cmd of visible) {
+        const invocation = `jinn ${cmd.name}`;
+        lines.push(`  ${invocation.padEnd(maxInvocationLen)}  ${cmd.summary}`);
+    }
+    lines.push('');
+    lines.push('Additional subverbs:');
+    lines.push('  fleet scale --to N                    Grow or shrink the fleet');
+    lines.push('  fleet retire <index>                  Retire one service');
+    lines.push('');
+    lines.push('Operator map:');
+    lines.push('  jinn run                              Start the daemon or fail with a structured next step');
+    lines.push('  jinn doctor                           Check environment and config readiness');
+    lines.push('  jinn fund-requirements                Show exact funding gaps');
+    lines.push('  jinn status                           Poll health; use this for monitoring');
+    lines.push('  jinn fleet|balance|history|rewards    Inspect current state and history');
+    lines.push('  jinn submit-intent|claim-rewards      Execute protocol actions');
+    lines.push('  jinn withdraw|keys backup             Move funds or back up the mnemonic');
+    lines.push('');
+    lines.push('Run `jinn <verb> --help` for verb-specific flags and examples.');
+    return lines.join('\n');
+}
+export function renderCommandHelp(command) {
+    const label = command.name === 'fleet-manage' ? 'fleet' : command.name;
+    return `jinn ${label} — ${command.summary}\n\n${command.helpText}`;
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,QAAyB;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IACrF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,gBAAgB,GACpB,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,8FAA8F,CAAC,CAAC;IAC3G,KAAK,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;IAC7F,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;IAC3F,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IACzF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACvE,OAAO,QAAQ,KAAK,MAAM,OAAO,CAAC,OAAO,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AACrE,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * jinn CLI dispatcher.
+ *
+ * Contract: spec/2026-04-14-client-surface.md §2 (verbs), §6 (error envelope),
+ * §7 (behavioral rules).
+ *
+ * Adding a verb: create `commands/<name>.ts` exporting a default CommandModule,
+ * then import and push into COMMANDS below.
+ */
+export interface RunCliOptions {
+    writer?: {
+        write: (s: string) => boolean;
+    };
+    exit?: (code: number) => void;
+    stdoutIsTty?: boolean;
+}
+export declare function runCli(argv: string[], opts?: RunCliOptions): Promise<void>;

package/dist/cli/index.js

@@ -0,0 +1,132 @@
+/**
+ * jinn CLI dispatcher.
+ *
+ * Contract: spec/2026-04-14-client-surface.md §2 (verbs), §6 (error envelope),
+ * §7 (behavioral rules).
+ *
+ * Adding a verb: create `commands/<name>.ts` exporting a default CommandModule,
+ * then import and push into COMMANDS below.
+ */
+import { emitEnvelope } from '../errors/envelope.js';
+import { renderTopLevelHelp, renderCommandHelp } from './help.js';
+import { ConfigLoadError } from '../config.js';
+import versionCommand from './commands/version.js';
+import doctorCommand from './commands/doctor.js';
+import initCommand from './commands/init.js';
+import bootstrapCommand from './commands/bootstrap.js';
+import fundRequirementsCommand from './commands/fund-requirements.js';
+import runCommand from './commands/run.js';
+import stopCommand from './commands/stop.js';
+import statusCommand from './commands/status.js';
+import fleetCommand from './commands/fleet.js';
+import balanceCommand from './commands/balance.js';
+import historyCommand from './commands/history.js';
+import rewardsCommand from './commands/rewards.js';
+import logsCommand from './commands/logs.js';
+import fleetManageCommand from './commands/fleet-scale.js';
+import submitIntentCommand from './commands/submit-intent.js';
+import claimRewardsCommand from './commands/claim-rewards.js';
+import withdrawCommand from './commands/withdraw.js';
+import keysCommand from './commands/keys-backup.js';
+const COMMANDS = [
+    versionCommand,
+    doctorCommand,
+    initCommand,
+    bootstrapCommand,
+    fundRequirementsCommand,
+    runCommand,
+    stopCommand,
+    statusCommand,
+    fleetCommand,
+    balanceCommand,
+    historyCommand,
+    rewardsCommand,
+    logsCommand,
+    fleetManageCommand,
+    submitIntentCommand,
+    claimRewardsCommand,
+    withdrawCommand,
+    keysCommand,
+];
+function publicCommandNames(commands) {
+    return commands.filter((c) => c.name !== 'fleet-manage').map((c) => c.name);
+}
+export async function runCli(argv, opts = {}) {
+    const writer = opts.writer ?? process.stdout;
+    const exit = opts.exit ?? ((c) => { process.exit(c); });
+    const stdoutIsTty = opts.stdoutIsTty ?? Boolean(process.stdout.isTTY);
+    // No args → top-level help, exit 0.
+    if (argv.length === 0) {
+        writer.write(renderTopLevelHelp(COMMANDS) + '\n');
+        return;
+    }
+    const [verb, ...rest] = argv;
+    const isFleetManage = verb === 'fleet' && rest.length > 0 && !rest[0].startsWith('-');
+    // --help at the top level
+    if (verb === '--help' || verb === '-h') {
+        writer.write(renderTopLevelHelp(COMMANDS) + '\n');
+        return;
+    }
+    const command = isFleetManage
+        ? COMMANDS.find((c) => c.name === 'fleet-manage')
+        : COMMANDS.find((c) => c.name === verb);
+    if (!command) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: `Unknown verb: ${verb}`,
+            hint: 'Run `jinn --help` for the list of verbs.',
+            exampleCli: 'jinn --help',
+            details: {
+                field: 'subcommand',
+                expected: publicCommandNames(COMMANDS).join('|'),
+            },
+        }, { writer, exit });
+        return;
+    }
+    const commandArgv = rest;
+    const exampleInvocation = isFleetManage ? `jinn fleet ${rest[0]}` : `jinn ${verb}`;
+    // Per-verb --help short-circuit (before any command-specific parsing)
+    if (commandArgv.includes('--help') || commandArgv.includes('-h')) {
+        writer.write(renderCommandHelp(command) + '\n');
+        return;
+    }
+    const ctx = {
+        argv: commandArgv,
+        stdoutIsTty,
+        writer,
+        exit,
+        env: process.env,
+    };
+    try {
+        await command.run(ctx);
+    }
+    catch (err) {
+        if (err instanceof ConfigLoadError) {
+            const details = {
+                field: 'config',
+                code: err.code,
+                ...(err.details ?? {}),
+            };
+            emitEnvelope({
+                code: 'invalid_invocation',
+                message: err.message,
+                hint: 'Fix the configuration inputs and re-run the command.',
+                exampleCli: exampleInvocation,
+                details,
+            }, { writer, exit });
+            return;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        const details = { cause: message, verb };
+        const debug = process.env['JINN_DEBUG'] === '1';
+        if (debug && err instanceof Error && err.stack) {
+            details.stack = err.stack;
+        }
+        emitEnvelope({
+            code: 'fatal',
+            message,
+            details,
+        }, { writer, exit });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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