Function prepareRuntimeForCommand

src/cli/commands/connection-runtime.ts:166–224

(options: {
  command: string;
  flags: CliFlags;
  client: AgentDeviceClient;
  state: RemoteConnectionState;
  nextState: RemoteConnectionState;
  runtime?: SessionRuntimeHints;
  positionals?: string[];
  batchSteps?: BatchStep[];
  forceRuntimePrepare?: boolean;
})

}

async function prepareRuntimeForCommand(options: {
  command: string;
  flags: CliFlags;
  client: AgentDeviceClient;
  state: RemoteConnectionState;
  nextState: RemoteConnectionState;
  runtime?: SessionRuntimeHints;
  positionals?: string[];
  batchSteps?: BatchStep[];
  forceRuntimePrepare?: boolean;
}): Promise<{
  state: RemoteConnectionState;
  runtime?: SessionRuntimeHints;
  changed: boolean;
  metroCleanupToStop?: RemoteConnectionState['metro'];
  preparedMetroCleanupOnFailure?: RemoteConnectionState['metro'];
}> {
  const { command, flags, state, client } = options;
  let nextState = ensureRuntimeLeaseState(options.nextState, flags);
  const nextRuntime = options.runtime;
  if (
    !shouldPrepareRuntimeForCommand(command, flags, options.batchSteps, options.positionals) ||
    !hasDeferredMetroConfig(flags) ||
    !shouldPrepareRuntime(options.forceRuntimePrepare, nextRuntime, flags.platform)
  ) {
    return { state: nextState, runtime: nextRuntime, changed: false };
  }
  if (!nextState.leaseId) {
    throw new AppError(
      'INVALID_ARGS',
      `${command} requires a resolved remote lease before Metro runtime can be prepared.`,
    );
  }
  const prepared = await prepareConnectedMetro(
    flags,
    client,
    state.remoteConfigPath,
    state.session,
    {
      tenantId: state.tenant,
      runId: state.runId,
      leaseId: nextState.leaseId,
    },
  );
  const replacesExistingMetroCleanup = !isSameMetroCleanup(nextState.metro, prepared.cleanup);
  nextState = {
    ...nextState,
    runtime: prepared.runtime,
    metro: prepared.cleanup,
    updatedAt: new Date().toISOString(),
  };
  return {
    state: nextState,
    runtime: prepared.runtime,
    changed: true,
    metroCleanupToStop: replacesExistingMetroCleanup ? options.nextState.metro : undefined,
    preparedMetroCleanupOnFailure: replacesExistingMetroCleanup ? prepared.cleanup : undefined,
  };