feat(cli): add --timeout flag to daemon exec

Long-running RPC calls (e.g. on-chain transaction confirmation) can
exceed the default 30s socket read timeout. Add a --timeout option
(in seconds) so callers can raise the limit per invocation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: sirtimid

packages/cli/src/app.ts

@@ -255,6 +255,10 @@ const yargsInstance = yargs(hideBin(process.argv))
                 '$0 daemon exec executeDBQuery \'{"sql":"SELECT * FROM kv LIMIT 5"}\'',
                 'Run a SQL query',
               )
+              .option('timeout', {
+                describe: 'Read timeout in seconds (default: 30)',
+                type: 'number',
+              })
               .example(
                 '$0 daemon exec terminateVat \'{"vatId":"v1"}\'',
                 'Terminate a vat',
@@ -268,7 +272,13 @@ const yargsInstance = yargs(hideBin(process.argv))
               execArgs.push(String(args['params-json']));
             }
             await ensureDaemon(socketPath);
-            await handleDaemonExec(execArgs, socketPath);
+            await handleDaemonExec(
+              execArgs,
+              socketPath,
+              typeof args.timeout === 'number'
+                ? { timeoutMs: args.timeout * 1000 }
+                : {},
+            );
           },
         )
         .command(

packages/cli/src/commands/daemon.ts

@@ -165,10 +165,13 @@ export async function handleDaemonBegone(socketPath: string): Promise<void> {
  *
  * @param args - Positional arguments: [method, params-json].
  * @param socketPath - The daemon socket path.
+ * @param options - Additional options.
+ * @param options.timeoutMs - Read timeout in milliseconds.
  */
 export async function handleDaemonExec(
   args: string[],
   socketPath: string,
+  { timeoutMs }: { timeoutMs?: number } = {},
 ): Promise<void> {
   const method = args[0] ?? 'getStatus';
   const rawParams = args[1];
@@ -194,7 +197,12 @@ export async function handleDaemonExec(
     }
   }
 
-  const response = await sendCommand({ socketPath, method, params });
+  const response = await sendCommand({
+    socketPath,
+    method,
+    params,
+    ...(timeoutMs === undefined ? {} : { timeoutMs }),
+  });
 
   if (isJsonRpcFailure(response)) {
     process.stderr.write(