@jinn-network/client 0.1.2 → 0.1.3-canary.2d6b2676

package/dist/cli/commands/logs.js

@@ -1,7 +1,7 @@
 import { parseArgs } from 'node:util';
 import { emitResult } from '../output.js';
 import { emitEnvelope } from '../../errors/envelope.js';
-import { loadConfig, getConfigPathFromArgs } from '../../config.js';
+import { loadConfig as defaultLoadConfig, getConfigPathFromArgs as defaultGetConfigPathFromArgs, } from '../../config.js';
 import { Store } from '../../store/store.js';
 function humanLogs(payload) {
     if (payload.events.length === 0) {
@@ -25,73 +25,16 @@ function toLogLine(row) {
         txHash: row.txHash,
     };
 }
-async function run(ctx) {
-    let parsed;
-    try {
-        parsed = parseArgs({
-            args: ctx.argv,
-            options: {
-                limit: { type: 'string', default: '100' },
-                json: { type: 'boolean', default: false },
-                human: { type: 'boolean', default: false },
-                follow: { type: 'boolean', default: false },
-                config: { type: 'string' },
-            },
-            allowPositionals: false,
-        });
-    }
-    catch (err) {
-        emitEnvelope({
-            code: 'invalid_invocation',
-            message: err instanceof Error ? err.message : String(err),
-            exampleCli: 'jinn logs --limit 100',
-            details: { field: 'flags' },
-        }, { writer: ctx.writer, exit: ctx.exit });
-        return;
-    }
-    const n = parseInt(parsed.values.limit, 10);
-    const limit = Math.min(Math.max(Number.isFinite(n) ? n : 100, 1), 1000);
-    const fromVerbFlags = getConfigPathFromArgs(ctx.argv);
-    const fromProcess = typeof process !== 'undefined' ? getConfigPathFromArgs(process.argv.slice(2)) : undefined;
-    const config = loadConfig(fromVerbFlags ?? fromProcess);
-    const store = new Store(config.dbPath);
-    const rows = store.getRecentActivityEvents(limit);
-    const events = rows
-        .map(toLogLine)
-        .filter((v) => v !== null)
-        .sort((a, b) => a.id - b.id);
-    const payload = {
-        schemaVersion: 1,
-        generatedAt: new Date().toISOString(),
-        events,
-        cursor: { next: null },
-    };
-    if (Boolean(parsed.values.follow)) {
-        let lastSeenId = events.length > 0 ? events[events.length - 1].id : 0;
-        for (;;) {
-            const next = store.getActivityEventsAfterId(lastSeenId, 500);
-            for (const row of next) {
-                const line = toLogLine(row);
-                if (!line)
-                    continue;
-                lastSeenId = line.id;
-                ctx.writer.write(Boolean(parsed.values.human) ? `${humanLogs({ ...payload, events: [line] })}\n` : `${JSON.stringify(line)}\n`);
-            }
-            await new Promise((r) => setTimeout(r, 1000));
-        }
-    }
-    emitResult(payload, (v) => humanLogs(v), {
-        json: Boolean(parsed.values.json),
-        human: Boolean(parsed.values.human),
-        writer: ctx.writer,
-        stdoutIsTty: ctx.stdoutIsTty,
-        noColor: Boolean(ctx.env['NO_COLOR']),
-    });
-}
-const command = {
-    name: 'logs',
-    summary: 'Structured event log (one JSON object per line)',
-    helpText: `Usage: jinn logs [--limit <N>] [--human]
+const PRODUCTION_DEPS = {
+    loadConfig: defaultLoadConfig,
+    getConfigPathFromArgs: defaultGetConfigPathFromArgs,
+    storeFactory: (path) => new Store(path),
+};
+export function createLogsCommand(deps = PRODUCTION_DEPS) {
+    return {
+        name: 'logs',
+        summary: 'Structured event log (one JSON object per line)',
+        helpText: `Usage: jinn logs [--limit <N>] [--human]
 
 Emits a JSON envelope containing up to N recent rows from the local
 activity store. Event entries match the spec §8 log line shape
@@ -102,7 +45,71 @@ Examples:
   jinn logs --limit 50
   jinn logs --human
 `,
-    run,
-};
+        async run(ctx) {
+            let parsed;
+            try {
+                parsed = parseArgs({
+                    args: ctx.argv,
+                    options: {
+                        limit: { type: 'string', default: '100' },
+                        json: { type: 'boolean', default: false },
+                        human: { type: 'boolean', default: false },
+                        follow: { type: 'boolean', default: false },
+                        config: { type: 'string' },
+                    },
+                    allowPositionals: false,
+                });
+            }
+            catch (err) {
+                emitEnvelope({
+                    code: 'invalid_invocation',
+                    message: err instanceof Error ? err.message : String(err),
+                    exampleCli: 'jinn logs --limit 100',
+                    details: { field: 'flags' },
+                }, { writer: ctx.writer, exit: ctx.exit });
+                return;
+            }
+            const n = parseInt(parsed.values.limit, 10);
+            const limit = Math.min(Math.max(Number.isFinite(n) ? n : 100, 1), 1000);
+            const fromVerbFlags = deps.getConfigPathFromArgs(ctx.argv);
+            const fromProcess = typeof process !== 'undefined' ? deps.getConfigPathFromArgs(process.argv.slice(2)) : undefined;
+            const config = deps.loadConfig(fromVerbFlags ?? fromProcess);
+            const store = deps.storeFactory(config.dbPath);
+            const rows = store.getRecentActivityEvents(limit);
+            const events = rows
+                .map(toLogLine)
+                .filter((v) => v !== null)
+                .sort((a, b) => a.id - b.id);
+            const payload = {
+                schemaVersion: 1,
+                generatedAt: new Date().toISOString(),
+                events,
+                cursor: { next: null },
+            };
+            if (Boolean(parsed.values.follow)) {
+                let lastSeenId = events.length > 0 ? events[events.length - 1].id : 0;
+                for (;;) {
+                    const next = store.getActivityEventsAfterId(lastSeenId, 500);
+                    for (const row of next) {
+                        const line = toLogLine(row);
+                        if (!line)
+                            continue;
+                        lastSeenId = line.id;
+                        ctx.writer.write(Boolean(parsed.values.human) ? `${humanLogs({ ...payload, events: [line] })}\n` : `${JSON.stringify(line)}\n`);
+                    }
+                    await new Promise((r) => setTimeout(r, 1000));
+                }
+            }
+            emitResult(payload, (v) => humanLogs(v), {
+                json: Boolean(parsed.values.json),
+                human: Boolean(parsed.values.human),
+                writer: ctx.writer,
+                stdoutIsTty: ctx.stdoutIsTty,
+                noColor: Boolean(ctx.env['NO_COLOR']),
+            });
+        },
+    };
+}
+const command = createLogsCommand();
 export default command;
 //# sourceMappingURL=logs.js.map

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

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

package/dist/cli/commands/migrate-agent-id.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `jinn migrate-agent-id` — backfill ERC-8004 `agent_id` on `complete`
+ * services that pre-date jinn-mono-j07.
+ *
+ * The same migration runs automatically on `jinn run` startup (gated by
+ * `runLegacyMigrations`, default true). This command exists so operators
+ * can:
+ *   - run the migration explicitly (debuggable, verbose)
+ *   - re-run after a transient RPC failure without restarting the daemon
+ *   - opt-in after disabling the auto-run
+ *
+ * See `client/src/earning/migrate-agent-id.ts` and jinn-mono-jgp.
+ */
+import type { CommandModule } from '../command.js';
+import { loadConfig as defaultLoadConfig, getConfigPathFromArgs as defaultGetConfigPathFromArgs } from '../../config.js';
+import { runLegacyAgentIdMigration as defaultRunMigration } from '../../earning/migrate-agent-id.js';
+import { resolveCliPassword as defaultResolveCliPassword } from '../password.js';
+export interface MigrateAgentIdDeps {
+    loadConfig: typeof defaultLoadConfig;
+    getConfigPathFromArgs: typeof defaultGetConfigPathFromArgs;
+    resolveCliPassword: typeof defaultResolveCliPassword;
+    runMigration: typeof defaultRunMigration;
+}
+export declare function createMigrateAgentIdCommand(deps?: MigrateAgentIdDeps): CommandModule;
+declare const command: CommandModule;
+export default command;

package/dist/cli/commands/migrate-agent-id.js

@@ -0,0 +1,165 @@
+/**
+ * `jinn migrate-agent-id` — backfill ERC-8004 `agent_id` on `complete`
+ * services that pre-date jinn-mono-j07.
+ *
+ * The same migration runs automatically on `jinn run` startup (gated by
+ * `runLegacyMigrations`, default true). This command exists so operators
+ * can:
+ *   - run the migration explicitly (debuggable, verbose)
+ *   - re-run after a transient RPC failure without restarting the daemon
+ *   - opt-in after disabling the auto-run
+ *
+ * See `client/src/earning/migrate-agent-id.ts` and jinn-mono-jgp.
+ */
+import { COMMON_FLAGS, parseCommandArgs } from '../command.js';
+import { emitResult } from '../output.js';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { loadConfig as defaultLoadConfig, getConfigPathFromArgs as defaultGetConfigPathFromArgs, } from '../../config.js';
+import { runLegacyAgentIdMigration as defaultRunMigration, } from '../../earning/migrate-agent-id.js';
+import { resolveCliPassword as defaultResolveCliPassword } from '../password.js';
+function envelopeDebug(env) {
+    return env['JINN_DEBUG'] === '1';
+}
+function humanResult(payload) {
+    const lines = ['Legacy agent_id migration complete.'];
+    lines.push(`  migrated: ${payload.migrated.length}`);
+    for (const m of payload.migrated) {
+        lines.push(`    #${m.index} agentId=${m.agentId ?? '(unknown)'}`);
+    }
+    lines.push(`  skipped:  ${payload.skipped.length}`);
+    for (const s of payload.skipped) {
+        lines.push(`    #${s.index} agentId=${s.agentId ?? '(unknown)'}`);
+    }
+    lines.push(`  failed:   ${payload.failed.length}`);
+    for (const f of payload.failed) {
+        lines.push(`    #${f.index} ${f.error}`);
+    }
+    return lines.join('\n');
+}
+const PRODUCTION_DEPS = {
+    loadConfig: defaultLoadConfig,
+    getConfigPathFromArgs: defaultGetConfigPathFromArgs,
+    resolveCliPassword: defaultResolveCliPassword,
+    runMigration: defaultRunMigration,
+};
+export function createMigrateAgentIdCommand(deps = PRODUCTION_DEPS) {
+    async function run(ctx) {
+        let json = false;
+        let human = false;
+        let configPath;
+        try {
+            const parsed = parseCommandArgs(ctx.argv, { ...COMMON_FLAGS });
+            json = Boolean(parsed.values.json);
+            human = Boolean(parsed.values.human);
+            configPath =
+                typeof parsed.values.config === 'string' && parsed.values.config.length > 0
+                    ? parsed.values.config
+                    : undefined;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            emitEnvelope({
+                code: 'invalid_invocation',
+                message: 'Invalid command-line arguments.',
+                hint: 'Run `jinn migrate-agent-id --help` for supported flags.',
+                exampleCli: 'jinn migrate-agent-id --json',
+                details: { field: 'argv', expected: message },
+            }, { writer: ctx.writer, exit: ctx.exit });
+            return;
+        }
+        const password = deps.resolveCliPassword(ctx.argv, ctx.env);
+        if (!password.ok) {
+            emitEnvelope({
+                code: 'invalid_invocation',
+                message: password.message,
+                hint: 'Set JINN_PASSWORD or pass --password-fd N, then re-run.',
+                exampleCli: 'jinn migrate-agent-id --json',
+                details: {
+                    field: 'keystore password',
+                    expected: 'non-empty string via environment or fd',
+                },
+            }, { writer: ctx.writer, exit: ctx.exit });
+            return;
+        }
+        const config = deps.loadConfig(configPath);
+        const network = config.network === 'testnet' ? 'base-sepolia' : 'base';
+        let result;
+        try {
+            result = await deps.runMigration({
+                earningDir: config.earningDir,
+                network,
+                rpcUrl: config.rpcUrl,
+                password: password.password,
+                testnetL2DeploymentPath: config.testnetL2DeploymentPath,
+                testnetL2TokenDeploymentPath: config.testnetL2TokenDeploymentPath,
+                testnetMechDeploymentPath: config.testnetMechDeploymentPath,
+                testnetStolasDeploymentPath: config.testnetStolasDeploymentPath,
+                testnetClaimRegistryDeploymentPath: config.testnetClaimRegistryDeploymentPath,
+            });
+        }
+        catch (err) {
+            const cause = err instanceof Error ? err.message : String(err);
+            const details = { cause };
+            if (envelopeDebug(ctx.env) && err instanceof Error && err.stack) {
+                details.stack = err.stack;
+            }
+            emitEnvelope({
+                code: 'fatal',
+                message: err instanceof Error && err.message.trim().length > 0
+                    ? err.message
+                    : 'Legacy agent_id migration failed with an unexpected error.',
+                details,
+            }, { writer: ctx.writer, exit: ctx.exit });
+            return;
+        }
+        const payload = {
+            schemaVersion: 1,
+            generatedAt: new Date().toISOString(),
+            migrated: result.migrated.map((s) => ({
+                index: s.index,
+                agentId: s.agent_id ?? null,
+            })),
+            skipped: result.skipped.map((s) => ({
+                index: s.index,
+                agentId: s.agent_id ?? null,
+            })),
+            failed: result.failed.map((f) => ({
+                index: f.service.index,
+                error: f.error,
+            })),
+        };
+        emitResult(payload, (v) => humanResult(v), {
+            json,
+            human,
+            writer: ctx.writer,
+            stdoutIsTty: ctx.stdoutIsTty,
+            noColor: Boolean(ctx.env['NO_COLOR']),
+        });
+        ctx.exit(0);
+    }
+    return {
+        name: 'migrate-agent-id',
+        summary: 'Backfill ERC-8004 agent_id on legacy complete services (jinn-mono-jgp)',
+        helpText: `Usage: jinn migrate-agent-id [--human] [--config <path>] [--password-fd <fd>]
+
+Idempotent. Detects services with state == 'complete' && agent_id == null
+and runs the ERC-8004 IdentityRegistry mint flow for each. Services that
+already have an agent_id (or whose agent EOA already owns an NFT on-chain,
+recovered via Registered event scan) are not re-minted.
+
+The same migration runs automatically on \`jinn run\` startup unless
+\`runLegacyMigrations: false\` is set in config (or
+JINN_RUN_LEGACY_MIGRATIONS=0). This command is the explicit entry point
+for debugging or after a transient failure.
+
+Examples:
+  jinn migrate-agent-id
+  jinn migrate-agent-id --human
+  jinn migrate-agent-id --json
+`,
+        run,
+    };
+}
+const command = createMigrateAgentIdCommand();
+export default command;
+//# sourceMappingURL=migrate-agent-id.js.map

package/dist/cli/commands/migrate-agent-id.js.map

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

package/dist/cli/commands/quickstart.d.ts

@@ -1,3 +1,53 @@
-import type { CommandModule } from '../command.js';
+import type { BaseCommandDeps, CommandModule } from '../command.js';
+import initCommand from './init.js';
+import bootstrapCommand from './bootstrap.js';
+import doctorCommand from './doctor.js';
+import { checkRpcNetwork as defaultCheckRpcNetwork, rpcNetworkFailureHint as defaultRpcNetworkFailureHint } from '../../preflight/rpc-network.js';
+import { apiPortFailureMessage as defaultApiPortFailureMessage, checkApiPortAvailable as defaultCheckApiPortAvailable } from '../../preflight/api-port.js';
+/**
+ * NDJSON progress envelope emitted on stdout during long-running lifecycle
+ * verbs when `--json-progress` is set (or when stdout is non-TTY in JSON
+ * mode). Fields are stable — callers may depend on them.
+ *
+ * @field type     Always "progress".
+ * @field phase    Top-level phase: "preflight" | "password" | "init" | "bootstrap" | "daemon".
+ * @field step     Human-readable label for the current step within the phase.
+ * @field attempt  1-based attempt counter (present during retry loops).
+ * @field blocking Whether the agent must act before this step can advance.
+ * @field nextAction  Short instruction for the agent/operator when blocking is true.
+ * @field addresses   Any relevant on-chain addresses the agent may need.
+ * @field estimatedWaitMs  Rough upper bound on how long the step may take.
+ */
+export interface QuickstartProgressEnvelope {
+    type: 'progress';
+    phase: 'preflight' | 'password' | 'init' | 'bootstrap' | 'daemon';
+    step: string;
+    attempt?: number;
+    blocking?: boolean;
+    nextAction?: string;
+    addresses?: Record<string, string>;
+    estimatedWaitMs?: number;
+}
+export interface PasswordFileIO {
+    exists(path: string): boolean;
+    read(path: string): string;
+    write(path: string, content: string): void;
+    remove(path: string): void;
+    ensureDir(path: string): void;
+}
+export interface QuickstartDeps extends BaseCommandDeps {
+    checkRpcNetwork: typeof defaultCheckRpcNetwork;
+    rpcNetworkFailureHint: typeof defaultRpcNetworkFailureHint;
+    checkApiPortAvailable: typeof defaultCheckApiPortAvailable;
+    apiPortFailureMessage: typeof defaultApiPortFailureMessage;
+    /** Wraps the dynamic import('../../main.js') + invocation. Production calls main(); tests inject a no-op. */
+    mainFn: () => Promise<unknown>;
+    initRun: typeof initCommand.run;
+    bootstrapRun: typeof bootstrapCommand.run;
+    doctorRun: typeof doctorCommand.run;
+    passwordFileIO: PasswordFileIO;
+    randomBytesFn: (n: number) => Buffer;
+}
+export declare function createQuickstartCommand(deps?: QuickstartDeps): CommandModule;
 declare const command: CommandModule;
 export default command;